Overview

The Digital Assets Wallet and Transactions APIs provide core wallet, governance, and health endpoints.

Wallet APIs

The wallet category provides core wallet and blockchain transaction capabilities:

  • Wallet discovery:
    • List wallets with organization, user, service, instance, status, type, search, and cursor-pagination filters.
    • Retrieve a wallet by blockchain address.
  • Key management:
    • Import or create a wallet by uploading a Base64-encoded private key.
  • Balances:
    • Retrieve ERC-20 balances.
    • Retrieve balances associated with a wallet and contract address.
  • Transaction signing:
    • Sign EVM transactions.
    • Sign EIP-712 typed data.
    • Return encoded signatures and signature metadata.
  • Transfers:
    • Submit native-asset or ERC-20 transfers.
    • Support synchronous, asynchronous, or callback submission modes.
    • Retrieve transfer records by internal transaction ID or blockchain transaction hash.
  • Smart-contract deployment:
    • Deploy contracts using ABI, bytecode, constructor arguments, gas settings, value, and an optional RPC URL.
    • Return submission details such as transaction hash, nonce, and deployed contract address.

Governance APIs

The governance category manages administrative controls and upgrade workflows:

  • DA administrator management: add or remove decentralized-application administrators.
  • Approver management: add or remove policy approvers.
  • Policy management: create or update policies, including approval thresholds and authorized deployers.
  • Intent lifecycle:
    • Approve or reject governance intents.
    • Supply rejection reasons when applicable.
  • Deployment governance:
    • Propose deployment intents with component definitions and deadlines.
    • Propose upgrade intents with proxy, implementation, code hash, and deadline information.
  • UWaaS signing-key management: add or remove service signing keys.

Governance requests include the originating blockchain address and commonly support asynchronous execution. Responses provide transaction status and transaction hashes.

Health and Readiness APIs

Two unauthenticated operational endpoints are provided:

  • /ready - basic service readiness check.
  • /observe/health - health observation endpoint.

Both return a health status object containing status, timestamp, and optional diagnostic details.

Note:

  • Wallet and governance operations use Bearer JWT authentication.
  • Health endpoints do not require authentication.