Added "List addresses" endpoint

  • Added the List asset addresses (paginated) endpoint
    • This endpoint is currently in beta and its functionality may change
    • Calling the endpoint returns all the wallet addresses associated with the specified vault account and asset in a paginated list

Announcement: New Way to Create a Stellar Wallet

Fireblocks is updating the process for the creation of new Stellar wallets on January 1, 2024. After this date, customers will be responsible for funding the base reserve upon creation of a new wallet on Stellar. No action is required for customers who have an existing Stellar wallet.

Added "Associating End Clients with Transactions" guide

  • Added the Documentation > Best Practices > Associating End Clients with Transactions guide
    • This guide clarifies which endpoints and parameters to use to associate specific end clients with transactions for internal/auditing purposes or AML/CFT purposes

Updated Fireblocks Use Cases page

Improvements to notifications and data objects

Added "Structuring Your Vault" section

Updates to API Co-Signer Callback

New article: Transaction sources & destinations

A new article titled Transaction Sources & Destinations has been added to the developer portal detailing which locations can be identified as a source or destination when creating new transactions or retrieving existing transactions.

Updates and improvements to documentation

  1. The Supported Assets section has been renamed Blockchains & Assets. The following endpoints have been moved to Blockchains & Assets in the documentation with no change to their behavior:
    1. GET
    2. POST{assetId}/{address}
  2. Additional documentation has been added to the following endpoints:
    1. List transaction history
    2. Find a specific transaction
    3. Find a specific transaction by external transaction ID
  3. Removed options that have never been officially supported by Fireblocks with the exception of a small group of beta workspaces:
    1. Filter transactions by OEC_PARTNER
    2. The fields maxBip44AddressIndexUsed and maxBip44ChangeAddressIndexUsed have been removed from vault endpoints. Fireblocks has never returned these options and they were documented incorrectly.
  4. If a confirmation threshold is set by transaction ID or set by transaction hash and the value is below the required number of confirmations for a specific blockchain, an error with code 400 1451 is returned. This error response has been active since March 14, 2023.
  5. The code samples for the following endpoints have been corrected:
    1. GET /v1/transactions
    2. GET /v1/transactions/validate_address/{assetId}/{address}
    3. GET /v1/vault/accounts/{vaultAccountId}/{assetId}/{change}/{addressIndex}/public_key_info

Update to Webhooks & API Co-Signer Notifications Sections

The Webhooks & Notifications, and API Co-Signer Callback sections of the API Reference guide have been updated to a clearer order, with new sections for each notification type. There have been no changes to webhooks or co-signer callback behavior.