> ## Documentation Index > Fetch the complete documentation index at: https://docs.crossmint.com/llms.txt > Use this file to discover all available pages before exploring further. # Get Wallet Transactions > Retrieves all transactions associated with the specified wallet. Optionally filter by date range using ISO 8601 format (e.g., 2025-10-27T00:00:00Z). **API scope required**: `wallets:transactions.read` ## OpenAPI ````yaml get /2025-06-09/wallets/{walletLocator}/transactions openapi: 3.0.0 info: title: Crossmint Wallets API description: Crossmint Wallets API version: 1.0.0 contact: name: Crossmint Support url: https://www.crossmint.com email: support@crossmint.com servers: - url: https://staging.crossmint.com/api description: Staging environment (testnets) - url: https://www.crossmint.com/api description: Production environment (mainnets) security: [] tags: [] paths: /2025-06-09/wallets/{walletLocator}/transactions: get: summary: Get Wallet Transactions description: >- Retrieves all transactions associated with the specified wallet. Optionally filter by date range using ISO 8601 format (e.g., 2025-10-27T00:00:00Z). **API scope required**: `wallets:transactions.read` operationId: WalletsV2025Controller-getTransactionsWithoutChain-2 parameters: - name: X-API-KEY in: header description: API key required for authentication required: true schema: type: string - name: walletLocator required: true in: path description: >- A wallet locator can be of the format: - `` - `email::[:][:alias:]` (walletType defaults to 'smart') - `userId::[:][:alias:]` (white label user example) - `phoneNumber::[:][:alias:]` - `twitter::[:][:alias:]` - `x::[:][:alias:]` - `me:[:][:alias:]` (Use when calling from the client side with a client API key) - `chainType[:]:alias:` schema: type: string - name: page required: false in: query schema: default: '1' type: string allOf: - pattern: ^\d+$ - pattern: ^[1-9]\d*$ - name: perPage required: false in: query schema: default: '10' type: string allOf: - pattern: ^\d+$ - pattern: ^[1-9]\d*$ - name: dateFrom required: false in: query schema: format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ type: string - name: dateTo required: false in: query schema: format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ type: string responses: '200': description: The transactions have been successfully retrieved. content: application/json: schema: $ref: >- #/components/schemas/WalletsMultipleTransactionV2025ResponseDTO '404': description: Returns an error if a wallet with the specified locator not found content: application/json: schema: $ref: '#/components/schemas/WalletV1Alpha2ErrorDTO' components: schemas: WalletsMultipleTransactionV2025ResponseDTO: type: object properties: transactions: type: array items: anyOf: - type: object properties: chainType: type: string enum: - evm - solana - aptos - sui - stellar description: The blockchain type of the wallet walletType: type: string enum: - smart - mpc description: The wallet type (smart or mpc) params: type: object properties: calls: minItems: 1 type: array items: anyOf: - type: object properties: address: type: string description: >- The recipient address for this transaction call functionName: type: string description: The name of the function to call abi: description: The ABI for the function to call type: array items: {} args: type: array items: {} description: The arguments to pass to the function value: default: '0' description: The amount of native token to send in wei type: string required: - address - functionName - abi - args title: EVM contract call transaction parameters description: >- Parameters for a transaction to execute a contract function - type: object properties: to: type: string description: >- The recipient address for this transaction call value: type: string description: The amount of native token to send in wei data: description: The encoded calldata for this transaction required: - to - value - data title: EVM direct calldata transaction parameters description: >- Parameters for a transaction to send a direct calldata transaction - type: object properties: transaction: description: Serialized EVM transaction required: - transaction title: EVM serialized transaction parameters description: >- Parameters for a transaction to send a serialized EVM transaction description: Transaction data to execute description: Array of transaction calls to execute chain: description: The chain where the signer will be registered signer: description: >- The full signer object who will submit this transaction oneOf: - type: object properties: type: type: string enum: - external-wallet address: type: string description: The address of the external wallet locator: type: string description: The locator of the external wallet signer required: - type - address - locator title: External Wallet Signer description: Full External Wallet signer object - type: object properties: type: type: string enum: - passkey id: type: string description: The ID of the passkey locator: type: string description: The locator of the passkey signer required: - type - id - locator title: Passkey Signer description: Full Passkey signer object - type: object properties: type: type: string enum: - api-key address: type: string description: The address of the api key locator: type: string description: The locator of the api key signer required: - type - address - locator title: API Key Signer description: Full API Key signer object - type: object properties: type: type: string enum: - device publicKey: type: object properties: x: type: string 'y': type: string required: - x - 'y' description: The p256 public key of the device signer locator: type: string description: The locator of the device signer name: description: >- Optional human-readable name for the device signer type: string required: - type - publicKey - locator title: Device Signer description: Full Device signer object - type: object properties: type: type: string enum: - email email: type: string format: email pattern: >- ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ locator: type: string required: - type - email - locator - type: object properties: type: type: string enum: - phone phone: type: string locator: type: string required: - type - phone - locator - type: object properties: type: type: string enum: - server address: type: string locator: type: string required: - type - address - locator required: - calls - chain onChain: type: object properties: userOperation: type: object properties: sender: type: string description: WebAuthn authenticator data as hex string nonce: type: string description: WebAuthn authenticator data as hex string callData: type: string description: WebAuthn authenticator data as hex string callGasLimit: type: string description: WebAuthn authenticator data as hex string verificationGasLimit: type: string description: WebAuthn authenticator data as hex string preVerificationGas: type: string description: WebAuthn authenticator data as hex string maxFeePerGas: type: string description: WebAuthn authenticator data as hex string maxPriorityFeePerGas: type: string description: WebAuthn authenticator data as hex string paymaster: type: string description: WebAuthn authenticator data as hex string paymasterVerificationGasLimit: type: string description: WebAuthn authenticator data as hex string paymasterData: type: string description: WebAuthn authenticator data as hex string paymasterPostOpGasLimit: type: string description: WebAuthn authenticator data as hex string signature: type: string description: WebAuthn authenticator data as hex string factory: type: string description: WebAuthn authenticator data as hex string factoryData: type: string description: WebAuthn authenticator data as hex string required: - sender - nonce - callData - callGasLimit - verificationGasLimit - preVerificationGas - maxFeePerGas - maxPriorityFeePerGas - signature userOperationHash: type: string description: WebAuthn authenticator data as hex string txId: type: string description: WebAuthn authenticator data as hex string proxiedTxId: type: string description: WebAuthn authenticator data as hex string explorerLink: type: string required: - userOperation - userOperationHash description: >- EVM smart wallet transaction data including input parameters and chain specific details id: type: string description: Unique identifier for the transaction status: type: string enum: - awaiting-approval - pending - failed - success description: Current status of the transaction approvals: type: object properties: pending: type: array items: type: object properties: signer: oneOf: - type: object properties: type: type: string enum: - external-wallet address: type: string description: The address of the external wallet locator: type: string description: >- The locator of the external wallet signer required: - type - address - locator title: External Wallet Signer description: Full External Wallet signer object - type: object properties: type: type: string enum: - passkey id: type: string description: The ID of the passkey locator: type: string description: The locator of the passkey signer required: - type - id - locator title: Passkey Signer description: Full Passkey signer object - type: object properties: type: type: string enum: - api-key address: type: string description: The address of the api key locator: type: string description: The locator of the api key signer required: - type - address - locator title: API Key Signer description: Full API Key signer object - type: object properties: type: type: string enum: - device publicKey: type: object properties: x: type: string 'y': type: string required: - x - 'y' description: The p256 public key of the device signer locator: type: string description: The locator of the device signer name: description: >- Optional human-readable name for the device signer type: string required: - type - publicKey - locator title: Device Signer description: Full Device signer object - type: object properties: type: type: string enum: - email email: type: string format: email pattern: >- ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ locator: type: string required: - type - email - locator - type: object properties: type: type: string enum: - phone phone: type: string locator: type: string required: - type - phone - locator - type: object properties: type: type: string enum: - server address: type: string locator: type: string required: - type - address - locator description: >- The full signer object who submitted this signature message: type: string description: The message that needs to be signed required: - signer - message description: List of pending signatures submitted: type: array items: type: object properties: signature: type: string description: The cryptographic signature submittedAt: anyOf: - description: ISO timestamp when the signature was created type: number - type: string description: ISO timestamp when the signature was created signer: oneOf: - type: object properties: type: type: string enum: - external-wallet address: type: string description: The address of the external wallet locator: type: string description: >- The locator of the external wallet signer required: - type - address - locator title: External Wallet Signer description: Full External Wallet signer object - type: object properties: type: type: string enum: - passkey id: type: string description: The ID of the passkey locator: type: string description: The locator of the passkey signer required: - type - id - locator title: Passkey Signer description: Full Passkey signer object - type: object properties: type: type: string enum: - api-key address: type: string description: The address of the api key locator: type: string description: The locator of the api key signer required: - type - address - locator title: API Key Signer description: Full API Key signer object - type: object properties: type: type: string enum: - device publicKey: type: object properties: x: type: string 'y': type: string required: - x - 'y' description: The p256 public key of the device signer locator: type: string description: The locator of the device signer name: description: >- Optional human-readable name for the device signer type: string required: - type - publicKey - locator title: Device Signer description: Full Device signer object - type: object properties: type: type: string enum: - email email: type: string format: email pattern: >- ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ locator: type: string required: - type - email - locator - type: object properties: type: type: string enum: - phone phone: type: string locator: type: string required: - type - phone - locator - type: object properties: type: type: string enum: - server address: type: string locator: type: string required: - type - address - locator description: >- The full signer object who submitted this signature message: type: string description: The message that was signed metadata: description: >- Additional metadata about the signature submission type: object properties: deviceInfo: type: string ipAddress: type: string userAgent: type: string required: - signature - submittedAt - signer - message description: Record of all submitted signatures required: description: Number of required approvals for the transaction type: number required: - pending - submitted description: >- Complete approval data including requirements, pending and submitted signatures createdAt: anyOf: - description: ISO timestamp when the signature was created type: number - type: string description: ISO timestamp when the signature was created completedAt: description: ISO timestamp when the transaction reached finality anyOf: - description: ISO timestamp when the signature was created type: number - type: string error: description: Error message if the transaction fails after submission anyOf: - type: object properties: reason: anyOf: - type: string enum: - build_failed - type: string enum: - failed_to_land_on_chain - type: string enum: - unknown - type: string enum: - sanctioned_wallet_address message: type: string revertData: type: object additionalProperties: true required: - reason - message - type: object properties: reason: type: string enum: - program_error message: type: string revertData: type: object additionalProperties: true logs: {} required: - reason - message - type: object properties: reason: type: string enum: - execution_reverted message: type: string revertData: type: object additionalProperties: true revert: type: object description: Revert reason from smart contract properties: type: anyOf: - type: string enum: - contract_call - type: string enum: - wallet_authorization - type: string enum: - wallet_deployment reason: type: string reasonData: anyOf: - type: string - type: object additionalProperties: true explorerLink: type: string simulationLink: type: string required: - type - reason example: type: contract_call reason: 'ERC20: transfer amount exceeds balance' required: - reason - message sendParams: type: object properties: token: type: string description: The token locator that's being sent params: type: object properties: amount: description: The amount of the token to send type: string recipient: type: string description: The recipient locator for the token recipientAddress: type: string description: The recipient address for the token required: - recipient - recipientAddress description: The parameters for the send token transaction required: - token - params fees: description: >- Transaction fee information including actual transaction fees, billed amounts, and billing status type: object properties: mode: type: string enum: - user-native - user-fungible - project estimate: {} actual: {} billed: type: object properties: usd: type: number required: - usd billing: type: object properties: status: type: string enum: - pending - settled - failed required: - status required: - mode required: - chainType - walletType - params - onChain - id - status - createdAt title: EVM Smart Wallet - type: object properties: chainType: type: string enum: - evm - solana - aptos - sui - stellar description: The blockchain type of the wallet walletType: type: string enum: - smart - mpc description: The wallet type (smart or mpc) params: type: object properties: call: anyOf: - type: object properties: to: type: string description: >- The recipient address for this transaction call data: description: The encoded calldata for this transaction required: - to - data additionalProperties: false - type: object properties: address: type: string description: >- The recipient address for this transaction call functionName: type: string description: The name of the function to call abi: description: The ABI for the function to call type: array items: {} args: type: array items: {} description: The arguments to pass to the function required: - address - functionName - abi - args additionalProperties: false description: The transaction call to execute chain: type: string enum: - arbitrum-sepolia - arc-testnet - avalanche-fuji - curtis - base-goerli - base-sepolia - bsc-testnet - chiliz-spicy-testnet - coti-testnet - ethereum-goerli - ethereum-sepolia - hedera-testnet - hypersonic-testnet - lightlink-pegasus - mantle-sepolia - optimism-goerli - optimism-sepolia - polygon-amoy - polygon-mumbai - crossmint-private-testnet-ethereum - crossmint-private-testnet-polygon - rari-testnet - scroll-sepolia - sei-atlantic-2-testnet - shape-sepolia - skale-nebula-testnet - soneium-minato-testnet - space-testnet - story-testnet - verify-testnet - viction-testnet - xai-sepolia-testnet - zkatana - zkyoto - zora-goerli - zora-sepolia - mode-sepolia - u2u-nebulas - zenchain-testnet - abstract-testnet - world-chain-sepolia - plume-testnet - flow-testnet - tempo-testnet - ethereum - polygon - bsc - optimism - arbitrum - base - zora - arbitrumnova - astar-zkevm - apechain - hedera - coti - lightlink - mantle - skale-nebula - sei-pacific-1 - chiliz - avalanche - xai - shape - rari - scroll - viction - mode - space - soneium - story - u2u-solaris - abstract - world-chain - plume - flow - tempo description: The chain on which the signature will be submitted required: - call - chain description: EVM MPC wallet transaction parameters onChain: type: object properties: call: type: object properties: to: type: string description: The recipient address for this transaction call data: description: The encoded calldata for this transaction required: - to - data txId: type: string description: WebAuthn authenticator data as hex string explorerLink: type: string required: - call description: >- EVM MPC wallet transaction data including input parameters and chain specific details id: type: string description: Unique identifier for the transaction status: type: string enum: - awaiting-approval - pending - failed - success description: Current status of the transaction approvals: type: object properties: pending: type: array items: type: object properties: signer: oneOf: - type: object properties: type: type: string enum: - external-wallet address: type: string description: The address of the external wallet locator: type: string description: >- The locator of the external wallet signer required: - type - address - locator title: External Wallet Signer description: Full External Wallet signer object - type: object properties: type: type: string enum: - passkey id: type: string description: The ID of the passkey locator: type: string description: The locator of the passkey signer required: - type - id - locator title: Passkey Signer description: Full Passkey signer object - type: object properties: type: type: string enum: - api-key address: type: string description: The address of the api key locator: type: string description: The locator of the api key signer required: - type - address - locator title: API Key Signer description: Full API Key signer object - type: object properties: type: type: string enum: - device publicKey: type: object properties: x: type: string 'y': type: string required: - x - 'y' description: The p256 public key of the device signer locator: type: string description: The locator of the device signer name: description: >- Optional human-readable name for the device signer type: string required: - type - publicKey - locator title: Device Signer description: Full Device signer object - type: object properties: type: type: string enum: - email email: type: string format: email pattern: >- ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ locator: type: string required: - type - email - locator - type: object properties: type: type: string enum: - phone phone: type: string locator: type: string required: - type - phone - locator - type: object properties: type: type: string enum: - server address: type: string locator: type: string required: - type - address - locator description: >- The full signer object who submitted this signature message: type: string description: The message that needs to be signed required: - signer - message description: List of pending signatures submitted: type: array items: type: object properties: signature: type: string description: The cryptographic signature submittedAt: anyOf: - description: ISO timestamp when the signature was created type: number - type: string description: ISO timestamp when the signature was created signer: oneOf: - type: object properties: type: type: string enum: - external-wallet address: type: string description: The address of the external wallet locator: type: string description: >- The locator of the external wallet signer required: - type - address - locator title: External Wallet Signer description: Full External Wallet signer object - type: object properties: type: type: string enum: - passkey id: type: string description: The ID of the passkey locator: type: string description: The locator of the passkey signer required: - type - id - locator title: Passkey Signer description: Full Passkey signer object - type: object properties: type: type: string enum: - api-key address: type: string description: The address of the api key locator: type: string description: The locator of the api key signer required: - type - address - locator title: API Key Signer description: Full API Key signer object - type: object properties: type: type: string enum: - device publicKey: type: object properties: x: type: string 'y': type: string required: - x - 'y' description: The p256 public key of the device signer locator: type: string description: The locator of the device signer name: description: >- Optional human-readable name for the device signer type: string required: - type - publicKey - locator title: Device Signer description: Full Device signer object - type: object properties: type: type: string enum: - email email: type: string format: email pattern: >- ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ locator: type: string required: - type - email - locator - type: object properties: type: type: string enum: - phone phone: type: string locator: type: string required: - type - phone - locator - type: object properties: type: type: string enum: - server address: type: string locator: type: string required: - type - address - locator description: >- The full signer object who submitted this signature message: type: string description: The message that was signed metadata: description: >- Additional metadata about the signature submission type: object properties: deviceInfo: type: string ipAddress: type: string userAgent: type: string required: - signature - submittedAt - signer - message description: Record of all submitted signatures required: description: Number of required approvals for the transaction type: number required: - pending - submitted description: >- Complete approval data including requirements, pending and submitted signatures createdAt: anyOf: - description: ISO timestamp when the signature was created type: number - type: string description: ISO timestamp when the signature was created completedAt: description: ISO timestamp when the transaction reached finality anyOf: - description: ISO timestamp when the signature was created type: number - type: string error: description: Error message if the transaction fails after submission anyOf: - type: object properties: reason: anyOf: - type: string enum: - build_failed - type: string enum: - failed_to_land_on_chain - type: string enum: - unknown - type: string enum: - sanctioned_wallet_address message: type: string revertData: type: object additionalProperties: true required: - reason - message - type: object properties: reason: type: string enum: - program_error message: type: string revertData: type: object additionalProperties: true logs: {} required: - reason - message - type: object properties: reason: type: string enum: - execution_reverted message: type: string revertData: type: object additionalProperties: true revert: type: object description: Revert reason from smart contract properties: type: anyOf: - type: string enum: - contract_call - type: string enum: - wallet_authorization - type: string enum: - wallet_deployment reason: type: string reasonData: anyOf: - type: string - type: object additionalProperties: true explorerLink: type: string simulationLink: type: string required: - type - reason example: type: contract_call reason: 'ERC20: transfer amount exceeds balance' required: - reason - message sendParams: type: object properties: token: type: string description: The token locator that's being sent params: type: object properties: amount: description: The amount of the token to send type: string recipient: type: string description: The recipient locator for the token recipientAddress: type: string description: The recipient address for the token required: - recipient - recipientAddress description: The parameters for the send token transaction required: - token - params fees: description: >- Transaction fee information including actual transaction fees, billed amounts, and billing status type: object properties: mode: type: string enum: - user-native - user-fungible - project estimate: {} actual: {} billed: type: object properties: usd: type: number required: - usd billing: type: object properties: status: type: string enum: - pending - settled - failed required: - status required: - mode required: - chainType - walletType - params - onChain - id - status - createdAt title: EVM MPC Wallet - type: object properties: chainType: type: string enum: - evm - solana - aptos - sui - stellar description: The blockchain type of the wallet walletType: type: string enum: - smart - mpc description: The wallet type (smart or mpc) params: type: object properties: transaction: type: string description: Base58 encoded serialized Solana transaction requiredSigners: description: >- Optional array of additional full signer objects required for the transaction type: array items: oneOf: - type: object properties: type: type: string enum: - external-wallet address: type: string description: The address of the external wallet locator: type: string description: The locator of the external wallet signer required: - type - address - locator title: External Wallet Signer description: Full External Wallet signer object - type: object properties: type: type: string enum: - passkey id: type: string description: The ID of the passkey locator: type: string description: The locator of the passkey signer required: - type - id - locator title: Passkey Signer description: Full Passkey signer object - type: object properties: type: type: string enum: - api-key address: type: string description: The address of the api key locator: type: string description: The locator of the api key signer required: - type - address - locator title: API Key Signer description: Full API Key signer object - type: object properties: type: type: string enum: - device publicKey: type: object properties: x: type: string 'y': type: string required: - x - 'y' description: The p256 public key of the device signer locator: type: string description: The locator of the device signer name: description: >- Optional human-readable name for the device signer type: string required: - type - publicKey - locator title: Device Signer description: Full Device signer object - type: object properties: type: type: string enum: - email email: type: string format: email pattern: >- ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ locator: type: string required: - type - email - locator - type: object properties: type: type: string enum: - phone phone: type: string locator: type: string required: - type - phone - locator - type: object properties: type: type: string enum: - server address: type: string locator: type: string required: - type - address - locator description: The full signer object who submitted this signature signer: description: >- The full signer object who will submit this transaction. Defaults to the admin signer. oneOf: - type: object properties: type: type: string enum: - external-wallet address: type: string description: The address of the external wallet locator: type: string description: The locator of the external wallet signer required: - type - address - locator title: External Wallet Signer description: Full External Wallet signer object - type: object properties: type: type: string enum: - passkey id: type: string description: The ID of the passkey locator: type: string description: The locator of the passkey signer required: - type - id - locator title: Passkey Signer description: Full Passkey signer object - type: object properties: type: type: string enum: - api-key address: type: string description: The address of the api key locator: type: string description: The locator of the api key signer required: - type - address - locator title: API Key Signer description: Full API Key signer object - type: object properties: type: type: string enum: - device publicKey: type: object properties: x: type: string 'y': type: string required: - x - 'y' description: The p256 public key of the device signer locator: type: string description: The locator of the device signer name: description: >- Optional human-readable name for the device signer type: string required: - type - publicKey - locator title: Device Signer description: Full Device signer object - type: object properties: type: type: string enum: - email email: type: string format: email pattern: >- ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ locator: type: string required: - type - email - locator - type: object properties: type: type: string enum: - phone phone: type: string locator: type: string required: - type - phone - locator - type: object properties: type: type: string enum: - server address: type: string locator: type: string required: - type - address - locator feeConfig: anyOf: - type: object properties: feePayer: type: string description: The address that will pay for the transaction token: type: string enum: - sol - usdc - usdt description: The token to use for the fee amount: type: string description: The amount of the fee required: - feePayer - token - amount - type: object properties: feePayer: type: string enum: - crossmint amount: type: string description: The amount of the fee required: - feePayer - amount required: - transaction - feeConfig onChain: type: object properties: transaction: type: string lastValidBlockHeight: type: number txId: type: string explorerLink: type: string required: - transaction description: >- Solana custodial wallet transaction data including input parameters and chain specific details id: type: string description: Unique identifier for the transaction status: type: string enum: - awaiting-approval - pending - failed - success description: Current status of the transaction approvals: type: object properties: pending: type: array items: type: object properties: signer: oneOf: - type: object properties: type: type: string enum: - external-wallet address: type: string description: The address of the external wallet locator: type: string description: >- The locator of the external wallet signer required: - type - address - locator title: External Wallet Signer description: Full External Wallet signer object - type: object properties: type: type: string enum: - passkey id: type: string description: The ID of the passkey locator: type: string description: The locator of the passkey signer required: - type - id - locator title: Passkey Signer description: Full Passkey signer object - type: object properties: type: type: string enum: - api-key address: type: string description: The address of the api key locator: type: string description: The locator of the api key signer required: - type - address - locator title: API Key Signer description: Full API Key signer object - type: object properties: type: type: string enum: - device publicKey: type: object properties: x: type: string 'y': type: string required: - x - 'y' description: The p256 public key of the device signer locator: type: string description: The locator of the device signer name: description: >- Optional human-readable name for the device signer type: string required: - type - publicKey - locator title: Device Signer description: Full Device signer object - type: object properties: type: type: string enum: - email email: type: string format: email pattern: >- ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ locator: type: string required: - type - email - locator - type: object properties: type: type: string enum: - phone phone: type: string locator: type: string required: - type - phone - locator - type: object properties: type: type: string enum: - server address: type: string locator: type: string required: - type - address - locator description: >- The full signer object who submitted this signature message: type: string description: The message that needs to be signed required: - signer - message description: List of pending signatures submitted: type: array items: type: object properties: signature: type: string description: The cryptographic signature submittedAt: anyOf: - description: ISO timestamp when the signature was created type: number - type: string description: ISO timestamp when the signature was created signer: oneOf: - type: object properties: type: type: string enum: - external-wallet address: type: string description: The address of the external wallet locator: type: string description: >- The locator of the external wallet signer required: - type - address - locator title: External Wallet Signer description: Full External Wallet signer object - type: object properties: type: type: string enum: - passkey id: type: string description: The ID of the passkey locator: type: string description: The locator of the passkey signer required: - type - id - locator title: Passkey Signer description: Full Passkey signer object - type: object properties: type: type: string enum: - api-key address: type: string description: The address of the api key locator: type: string description: The locator of the api key signer required: - type - address - locator title: API Key Signer description: Full API Key signer object - type: object properties: type: type: string enum: - device publicKey: type: object properties: x: type: string 'y': type: string required: - x - 'y' description: The p256 public key of the device signer locator: type: string description: The locator of the device signer name: description: >- Optional human-readable name for the device signer type: string required: - type - publicKey - locator title: Device Signer description: Full Device signer object - type: object properties: type: type: string enum: - email email: type: string format: email pattern: >- ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ locator: type: string required: - type - email - locator - type: object properties: type: type: string enum: - phone phone: type: string locator: type: string required: - type - phone - locator - type: object properties: type: type: string enum: - server address: type: string locator: type: string required: - type - address - locator description: >- The full signer object who submitted this signature message: type: string description: The message that was signed metadata: description: >- Additional metadata about the signature submission type: object properties: deviceInfo: type: string ipAddress: type: string userAgent: type: string required: - signature - submittedAt - signer - message description: Record of all submitted signatures required: description: Number of required approvals for the transaction type: number required: - pending - submitted description: >- Complete approval data including requirements, pending and submitted signatures createdAt: anyOf: - description: ISO timestamp when the signature was created type: number - type: string description: ISO timestamp when the signature was created completedAt: description: ISO timestamp when the transaction reached finality anyOf: - description: ISO timestamp when the signature was created type: number - type: string error: description: Error message if the transaction fails after submission anyOf: - type: object properties: reason: anyOf: - type: string enum: - build_failed - type: string enum: - failed_to_land_on_chain - type: string enum: - unknown - type: string enum: - sanctioned_wallet_address message: type: string revertData: type: object additionalProperties: true required: - reason - message - type: object properties: reason: type: string enum: - program_error message: type: string revertData: type: object additionalProperties: true logs: {} required: - reason - message - type: object properties: reason: type: string enum: - execution_reverted message: type: string revertData: type: object additionalProperties: true revert: type: object description: Revert reason from smart contract properties: type: anyOf: - type: string enum: - contract_call - type: string enum: - wallet_authorization - type: string enum: - wallet_deployment reason: type: string reasonData: anyOf: - type: string - type: object additionalProperties: true explorerLink: type: string simulationLink: type: string required: - type - reason example: type: contract_call reason: 'ERC20: transfer amount exceeds balance' required: - reason - message sendParams: type: object properties: token: type: string description: The token locator that's being sent params: type: object properties: amount: description: The amount of the token to send type: string recipient: type: string description: The recipient locator for the token recipientAddress: type: string description: The recipient address for the token required: - recipient - recipientAddress description: The parameters for the send token transaction required: - token - params fees: description: >- Transaction fee information including actual transaction fees, billed amounts, and billing status type: object properties: mode: type: string enum: - user-native - user-fungible - project estimate: {} actual: {} billed: type: object properties: usd: type: number required: - usd billing: type: object properties: status: type: string enum: - pending - settled - failed required: - status required: - mode required: - chainType - walletType - params - onChain - id - status - createdAt title: Solana Smart Wallet - type: object properties: chainType: type: string enum: - evm - solana - aptos - sui - stellar description: The blockchain type of the wallet walletType: type: string enum: - smart - mpc description: The wallet type (smart or mpc) params: type: object properties: transaction: type: string description: Base58 encoded serialized Solana transaction requiredSigners: description: >- Optional array of additional full signer objects required for the transaction type: array items: oneOf: - type: object properties: type: type: string enum: - external-wallet address: type: string description: The address of the external wallet locator: type: string description: The locator of the external wallet signer required: - type - address - locator title: External Wallet Signer description: Full External Wallet signer object - type: object properties: type: type: string enum: - passkey id: type: string description: The ID of the passkey locator: type: string description: The locator of the passkey signer required: - type - id - locator title: Passkey Signer description: Full Passkey signer object - type: object properties: type: type: string enum: - api-key address: type: string description: The address of the api key locator: type: string description: The locator of the api key signer required: - type - address - locator title: API Key Signer description: Full API Key signer object - type: object properties: type: type: string enum: - device publicKey: type: object properties: x: type: string 'y': type: string required: - x - 'y' description: The p256 public key of the device signer locator: type: string description: The locator of the device signer name: description: >- Optional human-readable name for the device signer type: string required: - type - publicKey - locator title: Device Signer description: Full Device signer object - type: object properties: type: type: string enum: - email email: type: string format: email pattern: >- ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ locator: type: string required: - type - email - locator - type: object properties: type: type: string enum: - phone phone: type: string locator: type: string required: - type - phone - locator - type: object properties: type: type: string enum: - server address: type: string locator: type: string required: - type - address - locator description: The full signer object who submitted this signature required: - transaction onChain: type: object properties: transaction: type: string lastValidBlockHeight: type: number txId: type: string explorerLink: type: string required: - transaction description: >- Solana custodial wallet transaction data including input parameters and chain specific details id: type: string description: Unique identifier for the transaction status: type: string enum: - awaiting-approval - pending - failed - success description: Current status of the transaction approvals: type: object properties: pending: type: array items: type: object properties: signer: oneOf: - type: object properties: type: type: string enum: - external-wallet address: type: string description: The address of the external wallet locator: type: string description: >- The locator of the external wallet signer required: - type - address - locator title: External Wallet Signer description: Full External Wallet signer object - type: object properties: type: type: string enum: - passkey id: type: string description: The ID of the passkey locator: type: string description: The locator of the passkey signer required: - type - id - locator title: Passkey Signer description: Full Passkey signer object - type: object properties: type: type: string enum: - api-key address: type: string description: The address of the api key locator: type: string description: The locator of the api key signer required: - type - address - locator title: API Key Signer description: Full API Key signer object - type: object properties: type: type: string enum: - device publicKey: type: object properties: x: type: string 'y': type: string required: - x - 'y' description: The p256 public key of the device signer locator: type: string description: The locator of the device signer name: description: >- Optional human-readable name for the device signer type: string required: - type - publicKey - locator title: Device Signer description: Full Device signer object - type: object properties: type: type: string enum: - email email: type: string format: email pattern: >- ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ locator: type: string required: - type - email - locator - type: object properties: type: type: string enum: - phone phone: type: string locator: type: string required: - type - phone - locator - type: object properties: type: type: string enum: - server address: type: string locator: type: string required: - type - address - locator description: >- The full signer object who submitted this signature message: type: string description: The message that needs to be signed required: - signer - message description: List of pending signatures submitted: type: array items: type: object properties: signature: type: string description: The cryptographic signature submittedAt: anyOf: - description: ISO timestamp when the signature was created type: number - type: string description: ISO timestamp when the signature was created signer: oneOf: - type: object properties: type: type: string enum: - external-wallet address: type: string description: The address of the external wallet locator: type: string description: >- The locator of the external wallet signer required: - type - address - locator title: External Wallet Signer description: Full External Wallet signer object - type: object properties: type: type: string enum: - passkey id: type: string description: The ID of the passkey locator: type: string description: The locator of the passkey signer required: - type - id - locator title: Passkey Signer description: Full Passkey signer object - type: object properties: type: type: string enum: - api-key address: type: string description: The address of the api key locator: type: string description: The locator of the api key signer required: - type - address - locator title: API Key Signer description: Full API Key signer object - type: object properties: type: type: string enum: - device publicKey: type: object properties: x: type: string 'y': type: string required: - x - 'y' description: The p256 public key of the device signer locator: type: string description: The locator of the device signer name: description: >- Optional human-readable name for the device signer type: string required: - type - publicKey - locator title: Device Signer description: Full Device signer object - type: object properties: type: type: string enum: - email email: type: string format: email pattern: >- ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ locator: type: string required: - type - email - locator - type: object properties: type: type: string enum: - phone phone: type: string locator: type: string required: - type - phone - locator - type: object properties: type: type: string enum: - server address: type: string locator: type: string required: - type - address - locator description: >- The full signer object who submitted this signature message: type: string description: The message that was signed metadata: description: >- Additional metadata about the signature submission type: object properties: deviceInfo: type: string ipAddress: type: string userAgent: type: string required: - signature - submittedAt - signer - message description: Record of all submitted signatures required: description: Number of required approvals for the transaction type: number required: - pending - submitted description: >- Complete approval data including requirements, pending and submitted signatures createdAt: anyOf: - description: ISO timestamp when the signature was created type: number - type: string description: ISO timestamp when the signature was created completedAt: description: ISO timestamp when the transaction reached finality anyOf: - description: ISO timestamp when the signature was created type: number - type: string error: description: Error message if the transaction fails after submission anyOf: - type: object properties: reason: anyOf: - type: string enum: - build_failed - type: string enum: - failed_to_land_on_chain - type: string enum: - unknown - type: string enum: - sanctioned_wallet_address message: type: string revertData: type: object additionalProperties: true required: - reason - message - type: object properties: reason: type: string enum: - program_error message: type: string revertData: type: object additionalProperties: true logs: {} required: - reason - message - type: object properties: reason: type: string enum: - execution_reverted message: type: string revertData: type: object additionalProperties: true revert: type: object description: Revert reason from smart contract properties: type: anyOf: - type: string enum: - contract_call - type: string enum: - wallet_authorization - type: string enum: - wallet_deployment reason: type: string reasonData: anyOf: - type: string - type: object additionalProperties: true explorerLink: type: string simulationLink: type: string required: - type - reason example: type: contract_call reason: 'ERC20: transfer amount exceeds balance' required: - reason - message sendParams: type: object properties: token: type: string description: The token locator that's being sent params: type: object properties: amount: description: The amount of the token to send type: string recipient: type: string description: The recipient locator for the token recipientAddress: type: string description: The recipient address for the token required: - recipient - recipientAddress description: The parameters for the send token transaction required: - token - params fees: description: >- Transaction fee information including actual transaction fees, billed amounts, and billing status type: object properties: mode: type: string enum: - user-native - user-fungible - project estimate: {} actual: {} billed: type: object properties: usd: type: number required: - usd billing: type: object properties: status: type: string enum: - pending - settled - failed required: - status required: - mode required: - chainType - walletType - params - onChain - id - status - createdAt title: Solana MPC Wallet - type: object properties: chainType: type: string enum: - evm - solana - aptos - sui - stellar description: The blockchain type of the wallet walletType: type: string enum: - smart - mpc description: The wallet type (smart or mpc) params: type: object properties: transaction: oneOf: - type: object properties: type: type: string description: The type of transaction to execute enum: - contract-call contractId: type: string description: >- The recipient address for this transaction call example: >- GB3KQJ6N2YIE62YVO67X7W5TQK6Q5ZZ4P2LUVK2U6AU26CJQ626J method: type: string description: The name of the function to call memo: description: The memo for the transaction oneOf: - type: object properties: type: type: string enum: - text value: type: string maxLength: 28 required: - type - value - type: object properties: type: type: string enum: - id value: type: string required: - type - value - type: object properties: type: type: string enum: - hash value: type: string required: - type - value example: type: text value: Hello, world! args: type: object additionalProperties: true description: The arguments to pass to the function required: - type - contractId - method - args title: Stellar contract call transaction parameters description: >- Parameters for a transaction to execute a smart contract function example: type: contract-call contractId: >- GB3KQJ6N2YIE62YVO67X7W5TQK6Q5ZZ4P2LUVK2U6AU26CJQ626J method: transfer args: to: >- GB3KQJ6N2YIE62YVO67X7W5TQK6Q5ZZ4P2LUVK2U6AU26CJQ626J from: >- GB3KQJ6N2YIE62YVO67X7W5TQK6Q5ZZ4P2LUVK2U6AU26CJQ626J amount: '1000000000000000000' - type: object properties: type: type: string description: The type of transaction to execute enum: - upgrade-wallet required: - type title: Stellar upgrade wallet transaction description: >- Upgrades the wallet's on-chain contract to a new version. The wallet will be locked until a migrate-wallet transaction completes the upgrade. example: type: upgrade-wallet - type: object properties: type: type: string description: The type of transaction to execute enum: - migrate-wallet required: - type title: Stellar migrate wallet transaction description: >- Completes a pending wallet upgrade by migrating on-chain signer data to the new contract version. Must be called after upgrade-wallet. example: type: migrate-wallet description: Stellar transaction to execute signer: description: >- The locator for the signer who will submit this transaction. Defaults to the admin signer. type: string title: Signer Locator example: >- external-wallet:0x1234567890123456789012345678901234567890 required: - transaction onChain: type: object properties: transaction: type: object properties: method: type: string tx: type: string required: - method - tx title: Stellar on-chain transaction description: The Stellar Transaction Envelope txId: description: The transaction hash type: string ledger: description: The ledger number where the transaction was included type: number expiration: type: number description: The expiration of the transaction result: description: The Transaction Result in XDR format explorerLink: description: Optional link to view the transaction in an explorer type: string required: - transaction - expiration title: Stellar on-chain data id: type: string description: Unique identifier for the transaction status: type: string enum: - awaiting-approval - pending - failed - success description: Current status of the transaction approvals: type: object properties: pending: type: array items: type: object properties: signer: oneOf: - type: object properties: type: type: string enum: - external-wallet address: type: string description: The address of the external wallet locator: type: string description: >- The locator of the external wallet signer required: - type - address - locator title: External Wallet Signer description: Full External Wallet signer object - type: object properties: type: type: string enum: - passkey id: type: string description: The ID of the passkey locator: type: string description: The locator of the passkey signer required: - type - id - locator title: Passkey Signer description: Full Passkey signer object - type: object properties: type: type: string enum: - api-key address: type: string description: The address of the api key locator: type: string description: The locator of the api key signer required: - type - address - locator title: API Key Signer description: Full API Key signer object - type: object properties: type: type: string enum: - device publicKey: type: object properties: x: type: string 'y': type: string required: - x - 'y' description: The p256 public key of the device signer locator: type: string description: The locator of the device signer name: description: >- Optional human-readable name for the device signer type: string required: - type - publicKey - locator title: Device Signer description: Full Device signer object - type: object properties: type: type: string enum: - email email: type: string format: email pattern: >- ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ locator: type: string required: - type - email - locator - type: object properties: type: type: string enum: - phone phone: type: string locator: type: string required: - type - phone - locator - type: object properties: type: type: string enum: - server address: type: string locator: type: string required: - type - address - locator description: >- The full signer object who submitted this signature message: type: string description: The message that needs to be signed required: - signer - message description: List of pending signatures submitted: type: array items: type: object properties: signature: type: string description: The cryptographic signature submittedAt: anyOf: - description: ISO timestamp when the signature was created type: number - type: string description: ISO timestamp when the signature was created signer: oneOf: - type: object properties: type: type: string enum: - external-wallet address: type: string description: The address of the external wallet locator: type: string description: >- The locator of the external wallet signer required: - type - address - locator title: External Wallet Signer description: Full External Wallet signer object - type: object properties: type: type: string enum: - passkey id: type: string description: The ID of the passkey locator: type: string description: The locator of the passkey signer required: - type - id - locator title: Passkey Signer description: Full Passkey signer object - type: object properties: type: type: string enum: - api-key address: type: string description: The address of the api key locator: type: string description: The locator of the api key signer required: - type - address - locator title: API Key Signer description: Full API Key signer object - type: object properties: type: type: string enum: - device publicKey: type: object properties: x: type: string 'y': type: string required: - x - 'y' description: The p256 public key of the device signer locator: type: string description: The locator of the device signer name: description: >- Optional human-readable name for the device signer type: string required: - type - publicKey - locator title: Device Signer description: Full Device signer object - type: object properties: type: type: string enum: - email email: type: string format: email pattern: >- ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ locator: type: string required: - type - email - locator - type: object properties: type: type: string enum: - phone phone: type: string locator: type: string required: - type - phone - locator - type: object properties: type: type: string enum: - server address: type: string locator: type: string required: - type - address - locator description: >- The full signer object who submitted this signature message: type: string description: The message that was signed metadata: description: >- Additional metadata about the signature submission type: object properties: deviceInfo: type: string ipAddress: type: string userAgent: type: string required: - signature - submittedAt - signer - message description: Record of all submitted signatures required: description: Number of required approvals for the transaction type: number required: - pending - submitted description: >- Complete approval data including requirements, pending and submitted signatures createdAt: anyOf: - description: ISO timestamp when the signature was created type: number - type: string description: ISO timestamp when the signature was created completedAt: description: ISO timestamp when the transaction reached finality anyOf: - description: ISO timestamp when the signature was created type: number - type: string error: description: Error message if the transaction fails after submission anyOf: - type: object properties: reason: anyOf: - type: string enum: - build_failed - type: string enum: - failed_to_land_on_chain - type: string enum: - unknown - type: string enum: - sanctioned_wallet_address message: type: string revertData: type: object additionalProperties: true required: - reason - message - type: object properties: reason: type: string enum: - program_error message: type: string revertData: type: object additionalProperties: true logs: {} required: - reason - message - type: object properties: reason: type: string enum: - execution_reverted message: type: string revertData: type: object additionalProperties: true revert: type: object description: Revert reason from smart contract properties: type: anyOf: - type: string enum: - contract_call - type: string enum: - wallet_authorization - type: string enum: - wallet_deployment reason: type: string reasonData: anyOf: - type: string - type: object additionalProperties: true explorerLink: type: string simulationLink: type: string required: - type - reason example: type: contract_call reason: 'ERC20: transfer amount exceeds balance' required: - reason - message sendParams: type: object properties: token: type: string description: The token locator that's being sent params: type: object properties: amount: description: The amount of the token to send type: string recipient: type: string description: The recipient locator for the token recipientAddress: type: string description: The recipient address for the token required: - recipient - recipientAddress description: The parameters for the send token transaction required: - token - params fees: description: >- Transaction fee information including actual transaction fees, billed amounts, and billing status type: object properties: mode: type: string enum: - user-native - user-fungible - project estimate: {} actual: {} billed: type: object properties: usd: type: number required: - usd billing: type: object properties: status: type: string enum: - pending - settled - failed required: - status required: - mode required: - chainType - walletType - params - onChain - id - status - createdAt title: Stellar Smart Wallet description: >- The signer registration transaction the wallet admin must sign and submit to add (on create) or revoke (on delete) the card's delegated topup signer on-chain. required: - transactions title: Transactions Response WalletV1Alpha2ErrorDTO: type: object properties: error: type: boolean enum: - true message: type: string description: Error message example: required: - error - message ````