Skip to content

congzhangIDG/java-sdk

BranchesTags
 
 

Repository files navigation

Fireblocks Java SDK (Beta)

Warning This package is currently in a beta stage and should be used at your own risk. The provided interfaces might go through backwards-incompatibale changes.

For detailed API documentation please refer to the Fireblocks API Reference.

Building the API client library requires:

  1. Java 11+
  2. Maven/Gradle

Installation

To install the API client library to your local Maven repository, simply execute:

mvn clean install

To deploy it to a remote Maven repository instead, configure the settings of the repository and execute:

mvn clean deploy

Refer to the OSSRH Guide for more information.

Maven users

Add this dependency to your project's POM:

<dependency>
  <groupId>com.fireblocks.sdk</groupId>
  <artifactId>fireblocks-sdk</artifactId>
  <version>0.0.1-beta</version>
  <scope>compile</scope>
</dependency>

Gradle users

Add this dependency to your project's build file:

compile "com.fireblocks.sdk:fireblocks-sdk:0.0.1-beta"

Others

At first generate the JAR by executing:

mvn clean package

Then manually install the following JARs:

  • target/fireblocks-sdk-0.0.1-beta.jar
  • target/lib/*.jar

Getting Started

Initiate Fireblocks Client

ConfigurationOptions configurationOptions = new ConfigurationOptions()
    .basePath(BASE_PATH)
    .apiKey(API_KEY)
    .secretKey(SECRET_KEY);
Fireblocks fireblocks = new Fireblocks(configurationOptions);

Examples

Creating a Vault Account

CreateVaultAccountRequest request = new CreateVaultAccountRequest().name("My Vault Account");
String idempotencyKey = Integer.toString(new Random().nextInt()); // String | A unique identifier for the request. If the request is sent multiple times with the same idempotency key, the server will return the same response as the first request. The idempotency key is valid for 24 hours.
// Async request
CompletableFuture<VaultAccount> response = fireblocks.vaults().createVaultAccount(request, idempotencyKey);
// Waiting for the request
VaultAccount vaultAccount = response.get();

Retrieving Vault Accounts

BigDecimal limit = new BigDecimal(10);
CompletableFuture<VaultAccountsPagedResponse> response = fireblocks.vaults().getPagedVaultAccounts(null, null, null, null, null, null, null, limit);
VaultAccountsPagedResponse vaultAccountsPagedResponse = response.get();

Creating a Transaction

TransactionRequest transactionRequest = new TransactionRequest()
    .operation(TransactionOperation.TRANSFER)
    .source(new TransferPeerPath()
        .type(TransferPeerPath.TypeEnum.VAULT_ACCOUNT)
        .id("0"))
    .destination(new DestinationTransferPeerPath()
        .type(DestinationTransferPeerPath.TypeEnum.VAULT_ACCOUNT)
        .id("1"))
    .amount(new TransactionRequestAmount("0.001"))
    .assetId("ETH_TEST3"); // Ethereum Goerli testnet
    .note("My first Java transaction!");
String idempotencyKey = Integer.toString(new Random().nextInt()); // String | A unique identifier for the request. If the request is sent multiple times with the same idempotency key, the server will return the same response as the first request. The idempotency key is valid for 24 hours.
CompletableFuture<CreateTransactionResponse> response = fireblocks.transactions().createTransaction(transactionRequest, null, idempotencyKey);
CreateTransactionResponse transactionResponse = response.get();
String txId = transactionResponse.getId();

Documentation for API Endpoints

All URIs are relative to https://api.fireblocks.io/v1

Class Method HTTP request Description
AdminQuorumApi setAdminQuorumThreshold PUT /admin_quorum Update admin quorum threshold
ApiUserApi createApiUser POST /management/api_users create api user
ApiUserApi getApiUsers GET /management/api_users get api users
AssetsApi createAssetsBulk POST /vault/assets/bulk Bulk creation of wallets
AuditLogsApi getAuditLogs GET /management/audit_logs Get audit logs
AuditLogsApi getAudits GET /audits Get audit logs
BlockchainsAssetsApi getSupportedAssets GET /supported_assets List all asset types supported by Fireblocks
ComplianceApi getAmlPostScreeningPolicy GET /screening/aml/post_screening_policy AML - View Post-Screening Policy
ComplianceApi getAmlScreeningPolicy GET /screening/aml/screening_policy AML - View Screening Policy
ComplianceApi getPostScreeningPolicy GET /screening/travel_rule/post_screening_policy Travel Rule - View Post-Screening Policy
ComplianceApi getScreeningPolicy GET /screening/travel_rule/screening_policy Travel Rule - View Screening Policy
ComplianceApi updateAmlScreeningConfiguration PUT /screening/aml/policy_configuration Update AML Configuration
ComplianceApi updateScreeningConfiguration PUT /screening/configurations Tenant - Screening Configuration
ComplianceApi updateTravelRuleConfig PUT /screening/travel_rule/policy_configuration Update Travel Rule Configuration
ComplianceScreeningConfigurationApi getAmlScreeningConfiguration GET /screening/aml/policy_configuration Get AML Screening Policy Configuration
ComplianceScreeningConfigurationApi getScreeningConfiguration GET /screening/travel_rule/policy_configuration Get Travel Rule Screening Policy Configuration
ConsoleUserApi createConsoleUser POST /management/users create console user
ConsoleUserApi getConsoleUsers GET /management/users get console users
ContractsApi addContractAsset POST /contracts/{contractId}/{assetId} Add an asset to a contract
ContractsApi createContract POST /contracts Create a contract
ContractsApi deleteContract DELETE /contracts/{contractId} Delete a contract
ContractsApi deleteContractAsset DELETE /contracts/{contractId}/{assetId} Delete a contract asset
ContractsApi getContract GET /contracts/{contractId} Find a specific contract
ContractsApi getContractAsset GET /contracts/{contractId}/{assetId} Find a contract asset
ContractsApi getContracts GET /contracts List contracts
ExchangeAccountsApi convertAssets POST /exchange_accounts/{exchangeAccountId}/convert Convert exchange account funds from the source asset to the destination asset.
ExchangeAccountsApi getExchangeAccount GET /exchange_accounts/{exchangeAccountId} Find a specific exchange account
ExchangeAccountsApi getExchangeAccountAsset GET /exchange_accounts/{exchangeAccountId}/{assetId} Find an asset for an exchange account
ExchangeAccountsApi getPagedExchangeAccounts GET /exchange_accounts/paged Pagination list exchange accounts
ExchangeAccountsApi internalTransfer POST /exchange_accounts/{exchangeAccountId}/internal_transfer Internal transfer for exchange accounts
ExternalWalletsApi addAssetToExternalWallet POST /external_wallets/{walletId}/{assetId} Add an asset to an external wallet.
ExternalWalletsApi createExternalWallet POST /external_wallets Create an external wallet
ExternalWalletsApi deleteExternalWallet DELETE /external_wallets/{walletId} Delete an external wallet
ExternalWalletsApi getExternalWallet GET /external_wallets/{walletId} Find an external wallet
ExternalWalletsApi getExternalWalletAsset GET /external_wallets/{walletId}/{assetId} Get an asset from an external wallet
ExternalWalletsApi getExternalWallets GET /external_wallets List external wallets
ExternalWalletsApi removeAssetFromExternalWallet DELETE /external_wallets/{walletId}/{assetId} Delete an asset from an external wallet
ExternalWalletsApi setExternalWalletCustomerRefId POST /external_wallets/{walletId}/set_customer_ref_id Set an AML customer reference ID for an external wallet
FiatAccountsApi depositFundsFromLinkedDDA POST /fiat_accounts/{accountId}/deposit_from_linked_dda Deposit funds from DDA
FiatAccountsApi getFiatAccount GET /fiat_accounts/{accountId} Find a specific fiat account
FiatAccountsApi getFiatAccounts GET /fiat_accounts List fiat accounts
FiatAccountsApi redeemFundsToLinkedDDA POST /fiat_accounts/{accountId}/redeem_to_linked_dda Redeem funds to DDA
GasStationsApi getGasStationByAssetId GET /gas_station/{assetId} Get gas station settings by asset
GasStationsApi getGasStationInfo GET /gas_station Get gas station settings
GasStationsApi updateGasStationConfiguration PUT /gas_station/configuration Edit gas station settings
GasStationsApi updateGasStationConfigurationByAssetId PUT /gas_station/configuration/{assetId} Edit gas station settings for an asset
InternalWalletsApi createInternalWallet POST /internal_wallets Create an internal wallet
InternalWalletsApi createInternalWalletAsset POST /internal_wallets/{walletId}/{assetId} Add an asset to an internal wallet
InternalWalletsApi deleteInternalWallet DELETE /internal_wallets/{walletId} Delete an internal wallet
InternalWalletsApi deleteInternalWalletAsset DELETE /internal_wallets/{walletId}/{assetId} Delete a whitelisted address from an internal wallet
InternalWalletsApi getInternalWallet GET /internal_wallets/{walletId} Get assets for internal wallet
InternalWalletsApi getInternalWalletAsset GET /internal_wallets/{walletId}/{assetId} Get an asset from an internal wallet
InternalWalletsApi getInternalWallets GET /internal_wallets List internal wallets
InternalWalletsApi setCustomerRefIdForInternalWallet POST /internal_wallets/{walletId}/set_customer_ref_id Set an AML/KYT customer reference ID for an internal wallet
JobManagementApi cancelJob POST /batch/{jobId}/cancel Cancel a running job
JobManagementApi continueJob POST /batch/{jobId}/continue Continue a paused job
JobManagementApi getJob GET /batch/{jobId} Get job details
JobManagementApi getJobTasks GET /batch/{jobId}/tasks Return a list of tasks for given job
JobManagementApi getJobs GET /batch/jobs Return a list of jobs belonging to tenant
JobManagementApi pauseJob POST /batch/{jobId}/pause Pause a job
NetworkConnectionsApi checkThirdPartyRouting GET /network_connections/{connectionId}/is_third_party_routing/{assetType} Retrieve third-party network routing validation by asset type.
NetworkConnectionsApi createNetworkConnection POST /network_connections Creates a new network connection
NetworkConnectionsApi createNetworkId POST /network_ids Creates a new Network ID
NetworkConnectionsApi deleteNetworkConnection DELETE /network_connections/{connectionId} Deletes a network connection by ID
NetworkConnectionsApi deleteNetworkId DELETE /network_ids/{networkId} Deletes specific network ID.
NetworkConnectionsApi getNetwork GET /network_connections/{connectionId} Get a network connection
NetworkConnectionsApi getNetworkConnections GET /network_connections List network connections
NetworkConnectionsApi getNetworkId GET /network_ids/{networkId} Returns specific network ID.
NetworkConnectionsApi getNetworkIds GET /network_ids Returns all network IDs, both local IDs and discoverable remote IDs
NetworkConnectionsApi setNetworkIdDiscoverability PATCH /network_ids/{networkId}/set_discoverability Update network ID's discoverability.
NetworkConnectionsApi setNetworkIdName PATCH /network_ids/{networkId}/set_name Update network ID's name.
NetworkConnectionsApi setNetworkIdRoutingPolicy PATCH /network_ids/{networkId}/set_routing_policy Update network id routing policy.
NetworkConnectionsApi setRoutingPolicy PATCH /network_connections/{connectionId}/set_routing_policy Update network connection routing policy.
NftsApi getNFT GET /nfts/tokens/{id} List token data by ID
NftsApi getNFTs GET /nfts/tokens List tokens by IDs
NftsApi getOwnershipTokens GET /nfts/ownership/tokens List all owned tokens (paginated)
NftsApi listOwnedCollections GET /nfts/ownership/collections List owned collections (paginated)
NftsApi listOwnedTokens GET /nfts/ownership/assets List all distinct owned tokens (paginated)
NftsApi refreshNFTMetadata PUT /nfts/tokens/{id} Refresh token metadata
NftsApi updateOwnershipTokens PUT /nfts/ownership/tokens Refresh vault account tokens
NftsApi updateTokenOwnershipStatus PUT /nfts/ownership/tokens/{id}/status Update token ownership status
NftsApi updateTokensOwnershipSpam PUT /nfts/ownership/tokens/spam Update tokens ownership spam property
NftsApi updateTokensOwnershipStatus PUT /nfts/ownership/tokens/status Update tokens ownership status
OffExchangesApi addOffExchange POST /off_exchange/add add collateral
OffExchangesApi getOffExchangeCollateralAccounts GET /off_exchange/collateral_accounts/{mainExchangeAccountId} Find a specific collateral exchange account
OffExchangesApi getOffExchangeSettlementTransactions GET /off_exchange/settlements/transactions get settlements transactions from exchange
OffExchangesApi removeOffExchange POST /off_exchange/remove remove collateral
OffExchangesApi settleOffExchangeTrades POST /off_exchange/settlements/trader create settlement for a trader
OtaBetaApi getOtaStatus GET /management/ota Returns current OTA status
OtaBetaApi setOtaStatus PUT /management/ota Enable or disable transactions to OTA
PaymentsPayoutApi createPayout POST /payments/payout Create a payout instruction set
PaymentsPayoutApi executePayoutAction POST /payments/payout/{payoutId}/actions/execute Execute a payout instruction set
PaymentsPayoutApi getPayout GET /payments/payout/{payoutId} Get the status of a payout instruction set
PolicyEditorBetaApi getActivePolicy GET /tap/active_policy Get the active policy and its validation
PolicyEditorBetaApi getDraft GET /tap/draft Get the active draft
PolicyEditorBetaApi publishDraft POST /tap/draft Send publish request for a certain draft id
PolicyEditorBetaApi publishPolicyRules POST /tap/publish Send publish request for a set of policy rules
PolicyEditorBetaApi updateDraft PUT /tap/draft Update the draft with a new set of rules
ResetDeviceApi resetDevice POST /management/users/{id}/reset_device resets device
SmartTransferApi cancelTicket PUT /smart-transfers/{ticketId}/cancel Cancel Ticket
SmartTransferApi createTicket POST /smart-transfers Create Ticket
SmartTransferApi createTicketTerm POST /smart-transfers/{ticketId}/terms Create leg (term)
SmartTransferApi findTicketById GET /smart-transfers/{ticketId} Search Tickets by ID
SmartTransferApi findTicketTermById GET /smart-transfers/{ticketId}/terms/{termId} Search ticket by leg (term) ID
SmartTransferApi fulfillTicket PUT /smart-transfers/{ticketId}/fulfill Fund ticket manually
SmartTransferApi fundTicketTerm PUT /smart-transfers/{ticketId}/terms/{termId}/fund Define funding source
SmartTransferApi getSmartTransferUserGroups GET /smart-transfers/settings/user-groups Get user group
SmartTransferApi manuallyFundTicketTerm PUT /smart-transfers/{ticketId}/terms/{termId}/manually-fund Manually add term transaction
SmartTransferApi removeTicketTerm DELETE /smart-transfers/{ticketId}/terms/{termId} Delete ticket leg (term)
SmartTransferApi searchTickets GET /smart-transfers Find Ticket
SmartTransferApi setExternalRefId PUT /smart-transfers/{ticketId}/external-id Add external ref. ID
SmartTransferApi setTicketExpiration PUT /smart-transfers/{ticketId}/expires-in Set expiration
SmartTransferApi setUserGroups POST /smart-transfers/settings/user-groups Set user group
SmartTransferApi submitTicket PUT /smart-transfers/{ticketId}/submit Submit ticket
SmartTransferApi updateTicketTerm PUT /smart-transfers/{ticketId}/terms/{termId} Update ticket leg (term)
StakingBetaApi approveTermsOfServiceByProviderId POST /staking/providers/{providerId}/approveTermsOfService
StakingBetaApi executeAction POST /staking/chains/{chainDescriptor}/{actionId}
StakingBetaApi getAllDelegations GET /staking/positions
StakingBetaApi getChainInfo GET /staking/chains/{chainDescriptor}/chainInfo
StakingBetaApi getChains GET /staking/chains
StakingBetaApi getDelegationById GET /staking/positions/{id}
StakingBetaApi getProviders GET /staking/providers
StakingBetaApi getSummary GET /staking/positions/summary
StakingBetaApi getSummaryByVault GET /staking/positions/summary/vaults
TransactionsApi cancelTransaction POST /transactions/{txId}/cancel Cancel a transaction
TransactionsApi createTransaction POST /transactions Create a new transaction
TransactionsApi dropTransaction POST /transactions/{txId}/drop Drop ETH transaction by ID
TransactionsApi estimateNetworkFee GET /estimate_network_fee Estimate the required fee for an asset
TransactionsApi estimateTransactionFee POST /transactions/estimate_fee Estimate transaction fee
TransactionsApi freezeTransaction POST /transactions/{txId}/freeze Freeze a transaction
TransactionsApi getTransaction GET /transactions/{txId} Find a specific transaction by Fireblocks transaction ID
TransactionsApi getTransactionByExternalId GET /transactions/external_tx_id/{externalTxId} Find a specific transaction by external transaction ID
TransactionsApi getTransactions GET /transactions List transaction history
TransactionsApi setConfirmationThresholdByTransactionHash POST /txHash/{txHash}/set_confirmation_threshold Set confirmation threshold by transaction hash
TransactionsApi setTransactionConfirmationThreshold POST /transactions/{txId}/set_confirmation_threshold Set confirmation threshold by transaction ID
TransactionsApi unfreezeTransaction POST /transactions/{txId}/unfreeze Unfreeze a transaction
TransactionsApi validateAddress GET /transactions/validate_address/{assetId}/{address} Validate destination address
TravelRuleBetaApi getVASPByDID GET /screening/travel_rule/vasp/{did} Get VASP details
TravelRuleBetaApi getVASPs GET /screening/travel_rule/vasp Get All VASPs
TravelRuleBetaApi updateVasp PUT /screening/travel_rule/vasp/update Add jsonDidKey to VASP details
TravelRuleBetaApi validateFullTravelRuleTransaction POST /screening/travel_rule/transaction/validate/full Validate Full Travel Rule Transaction
TravelRuleBetaApi validateTravelRuleTransaction POST /screening/travel_rule/transaction/validate Validate Travel Rule Transaction
UserGroupsBetaApi createUserGroup POST /management/user_groups Create user group
UserGroupsBetaApi deleteUserGroup DELETE /management/user_groups/{groupId} Delete user group
UserGroupsBetaApi getUserGroup GET /management/user_groups/{groupId} Get user group
UserGroupsBetaApi getUserGroups GET /management/user_groups List user groups
UserGroupsBetaApi updateUserGroup PUT /management/user_groups/{groupId} Update user group
UsersApi getUsers GET /users List users
VaultsApi activateAssetForVaultAccount POST /vault/accounts/{vaultAccountId}/{assetId}/activate Activate a wallet in a vault account
VaultsApi createLegacyAddress POST /vault/accounts/{vaultAccountId}/{assetId}/addresses/{addressId}/create_legacy Convert a segwit address to legacy format
VaultsApi createMultipleAccounts POST /vault/accounts/bulk Bulk creation of new vault accounts
VaultsApi createVaultAccount POST /vault/accounts Create a new vault account
VaultsApi createVaultAccountAsset POST /vault/accounts/{vaultAccountId}/{assetId} Create a new wallet
VaultsApi createVaultAccountAssetAddress POST /vault/accounts/{vaultAccountId}/{assetId}/addresses Create new asset deposit address
VaultsApi getAssetWallets GET /vault/asset_wallets List asset wallets (Paginated)
VaultsApi getMaxSpendableAmount GET /vault/accounts/{vaultAccountId}/{assetId}/max_spendable_amount Get the maximum spendable amount in a single transaction.
VaultsApi getPagedVaultAccounts GET /vault/accounts_paged List vault accounts (Paginated)
VaultsApi getPublicKeyInfo GET /vault/public_key_info Get the public key information
VaultsApi getPublicKeyInfoForAddress GET /vault/accounts/{vaultAccountId}/{assetId}/{change}/{addressIndex}/public_key_info Get the public key for a vault account
VaultsApi getUnspentInputs GET /vault/accounts/{vaultAccountId}/{assetId}/unspent_inputs Get UTXO unspent inputs information
VaultsApi getVaultAccount GET /vault/accounts/{vaultAccountId} Find a vault account by ID
VaultsApi getVaultAccountAsset GET /vault/accounts/{vaultAccountId}/{assetId} Get the asset balance for a vault account
VaultsApi getVaultAccountAssetAddressesPaginated GET /vault/accounts/{vaultAccountId}/{assetId}/addresses_paginated List addresses (Paginated)
VaultsApi getVaultAssets GET /vault/assets Get asset balance for chosen assets
VaultsApi getVaultBalanceByAsset GET /vault/assets/{assetId} Get vault balance by asset
VaultsApi hideVaultAccount POST /vault/accounts/{vaultAccountId}/hide Hide a vault account in the console
VaultsApi setCustomerRefIdForAddress POST /vault/accounts/{vaultAccountId}/{assetId}/addresses/{addressId}/set_customer_ref_id Assign AML customer reference ID
VaultsApi setVaultAccountAutoFuel POST /vault/accounts/{vaultAccountId}/set_auto_fuel Turn autofueling on or off
VaultsApi setVaultAccountCustomerRefId POST /vault/accounts/{vaultAccountId}/set_customer_ref_id Set an AML/KYT customer reference ID for a vault account
VaultsApi unhideVaultAccount POST /vault/accounts/{vaultAccountId}/unhide Unhide a vault account in the console
VaultsApi updateVaultAccount PUT /vault/accounts/{vaultAccountId} Rename a vault account
VaultsApi updateVaultAccountAssetAddress PUT /vault/accounts/{vaultAccountId}/{assetId}/addresses/{addressId} Update address description
VaultsApi updateVaultAccountAssetBalance POST /vault/accounts/{vaultAccountId}/{assetId}/balance Refresh asset balance data
Web3ConnectionsApi create POST /connections/wc Create a new Web3 connection.
Web3ConnectionsApi get GET /connections List all open Web3 connections.
Web3ConnectionsApi remove DELETE /connections/wc/{id} Remove an existing Web3 connection.
Web3ConnectionsApi submit PUT /connections/wc/{id} Respond to a pending Web3 connection request.
WebhooksApi resendTransactionWebhooks POST /webhooks/resend/{txId} Resend failed webhooks for a transaction by ID
WebhooksApi resendWebhooks POST /webhooks/resend Resend failed webhooks
WhitelistIpAddressesApi getWhitelistIpAddresses GET /management/api_users/{userId}/whitelist_ip_addresses gets ip addresses
WorkspaceApi freezeWorkspace POST /workspace/freeze Freeze Workspace
WorkspaceStatusBetaApi getWorkspaceStatus GET /management/workspace_status Returns current workspace status

Documentation for Models

Author

[email protected]

About

No description, website, or topics provided.

Resources

Readme

License

MIT license
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

No packages published

Languages

  • Java 100.0%