Fireblocks Flow JavaScript guide

# Create a flow from your backend (returns a flowId)
curl --request POST \
  --url https://app.dynamic.xyz/api/v0/server/<YOUR_ENVIRONMENT_ID>/flow/payment \
  --header 'Authorization: Bearer <YOUR_API_TOKEN>' \
  --header 'Content-Type: application/json' \
  --data '{
    "amount": "25.00",
    "currency": "USD",
    "settlementConfig": {
      "strategy": "cheapest",
      "settlements": [
        {
          "chainName": "EVM",
          "tokenAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
          "chainId": "1",
          "symbol": "USDC",
          "tokenDecimals": 18
        }
      ]
    },
    "destinationConfig": {
      "destinations": [
        {
          "chainName": "EVM",
          "type": "address",
          "identifier": "0xYourSettlementAddress"
        }
      ]
    },
    "memo": {
      "description": "Payment for order #1234"
    }
  }'

import {
  attachFlowSource,
  getFlowQuote,
  submitFlowTransaction,
  getFlow,
} from '@dynamic-labs-sdk/client';

const pay = async (flowId, walletAccount) => {
  // Step 1: Attach the wallet source
  await attachFlowSource({
    flowId,
    fromAddress: walletAccount.address,
    fromChainId: '1',
    fromChainName: walletAccount.chain,
    sourceType: 'wallet',
  });

  // Step 2: Get a quote
  const quoted = await getFlowQuote({
    flowId,
    fromTokenAddress: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48', // USDC
  });

  console.log('Quote:', quoted.quote);

  // Step 3: Submit (prepare + sign + broadcast)
  await submitFlowTransaction({
    flowId,
    walletAccount,
  });

  // Step 4: Poll for completion
  const final = await getFlow({ flowId });
  console.log('Final state:', final.settlementState);
};

import { attachFlowSource, broadcastFlow } from '@dynamic-labs-sdk/client';

// Attach exchange source — returns the flow with exchange metadata
const { flow } = await attachFlowSource({
  flowId,
  sourceType: 'exchange',
  exchangeProvider: 'coinbase',
});

// The exchange buy URL is in flow.exchangeSource.metadata.url
// Open it in an iframe or redirect the user to complete payment on Coinbase
const exchangeUrl = flow.exchangeSource?.metadata?.url;
window.open(exchangeUrl, '_blank');

// After the user completes payment on the exchange, notify the backend
await broadcastFlow({ flowId });

import { submitFlowTransaction, cancelFlow } from '@dynamic-labs-sdk/client';

try {
  await submitFlowTransaction({
    flowId,
    walletAccount,
  });
} catch (error) {
  if (error.message.includes('rejected')) {
    // User rejected the signing request in their wallet
    await cancelFlow({ flowId });
    console.log('Flow cancelled');
  } else {
    console.error('Flow failed:', error.message);
  }
}

{
  "error": "No quotes available for any settlement token.",
  "quoteFailures": [
    {
      "chainId": "728126428",
      "chainName": "TRON",
      "reason": "unknown",
      "symbol": "USDT"
    },
    {
      "chainId": "8453",
      "chainName": "EVM",
      "reason": "amount_below_minimum",
      "symbol": "USDC"
    }
  ]
}

import { getFlow } from '@dynamic-labs-sdk/client';

const TERMINAL_EXECUTION = ['cancelled', 'expired', 'failed'];
const TERMINAL_SETTLEMENT = ['completed', 'failed'];

const pollFlow = async (flowId) => {
  const poll = async () => {
    const flow = await getFlow({ flowId });

    if (
      TERMINAL_EXECUTION.includes(flow.executionState) ||
      TERMINAL_SETTLEMENT.includes(flow.settlementState)
    ) {
      return flow;
    }

    await new Promise((resolve) => setTimeout(resolve, 3000));
    return poll();
  };

  return poll();
};