UTutila
Wallets

CreateWalletAddress

Changed on

Generates a new address in a wallet for the specificied blockchain network.

The address is derived from the appropriate MPC key that is used by that blockchain, i.e. ECDSA for Bitcoin and Ethereum, and EdDSA for Solana. The MPC key will be selected automatically for you. If a key is not available, an error will be returned.

Currently, creation of multiple addresses is supported only for UTXO-based blockchains.

Addresses in the EVM protocol family (Ethereum, Binance Smart Chain, etc.) generated in the same wallet will share the same address. This abstraction is useful for DeFi applications, where identical addresses are used across multiple blockchains.

post/v2/vaults/{vault_id}/wallets/{wallet_id}/addresses

Request

Path parameters

vault_idstring required
wallet_idstring required

Request body

namestring

The resource name of the WalletAddress.

Format: vaults/{vault_id}/wallets/{wallet_id}/addresses/{address_id}

displayNamestring

A human-readable name. Relevant only for deposit addresses.

Must match the regular expression [a-zA-Z0-9\.,:\-'# _$]+$ and be shorter than 100 characters

networkstring required

The resource name of the network of the address.

Format: networks/{network_id}

addressstring

The blockchain address.

format'BITCOIN_P2PKH' | 'BITCOIN_P2WPKH' | 'EVM' | 'TRON_BASE58' | 'BASE58' | 'TON_NON_BOUNCEABLE' | 'SUBSTRATE_58' | 'BITCOIN_P2TR'
  • BITCOIN_P2PKH: Bitcoin P2PKH address format.
  • BITCOIN_P2WPKH: Bitcoin P2WPKH address format.
  • EVM: Ethereum address format.
  • TRON_BASE58: Tron base58 address format.
  • BASE58: Solana address format.
  • TON_NON_BOUNCEABLE: Ton address format.
  • SUBSTRATE_58: Substrate address format.
  • BITCOIN_P2TR: Bitcoin P2TR (Taproot, BIP-341) address format.
keystring

The resource name of the MPC key this address was derived from.

Format: vaults/{vault_id}/keys/{key_id}

keyDerivationPathstring[]

Derivation path of the address from the MPC key.

type'MAIN' | 'DEPOSIT' | 'CHANGE'
  • MAIN: Main address (main address of the wallet).
  • DEPOSIT: Deposit address.
  • CHANGE: Change address.
notestring

Example request

{
  "name": "vaults/1b25635a5b3f/wallets/67af44031584/addresses/519c67ddae33",
  "displayName": "Hal's Address 3",
  "network": "networks/bitcoin-mainnet",
  "address": "bc1q04pum57enmfgcu3tu5gwqlmza5n7tchky0gjvu",
  "key": "vaults/1b25635a5b3f/keys/95257c5a522f",
  "keyDerivationPath": [
    44,
    0,
    0,
    0,
    3
  ],
  "note": "This is a note"
}

Response

A successful response.

Example response

{
  "walletAddress": {
    "name": "vaults/1b25635a5b3f/wallets/67af44031584/addresses/519c67ddae33",
    "displayName": "Hal's Address 3",
    "network": "networks/bitcoin-mainnet",
    "address": "bc1q04pum57enmfgcu3tu5gwqlmza5n7tchky0gjvu",
    "key": "vaults/1b25635a5b3f/keys/95257c5a522f",
    "keyDerivationPath": [
      44,
      0,
      0,
      0,
      3
    ],
    "note": "This is a note"
  }
}

Changes

  • c4a910d79740Revision changes
    • info

      added the new optional request property

    • info

      added the optional property / to the response with the status