Environment setup

Base URL

https://testnet.blockfinax.com/api/v2

All examples use $BFX for this URL:

export BFX=https://testnet.blockfinax.com

What you need

Node.js 20 or later	For the signing examples
@stellar/stellar-sdk	Decoding and re-encoding transactions
passkey-kit (0.14)	Signing smart-wallet authorisations with a passkey
A BlockFinaX account with a passkey	Created in the app, or through the authentication endpoints
Test USDC	Get 10,000 test USDC in the app's Wallet, once a day

npm install @stellar/stellar-sdk passkey-kit@0.14.0

Check the service

curl $BFX/api/v2/chains

The response lists the hub (activeLiquidityHub: "stellar-testnet") and what each chain allows (capabilities). Pools, purchases and settlement are on stellar-testnet.

Wallet configuration

curl $BFX/api/wallet/passkey/config

Returns the Stellar RPC URL, network passphrase and smart-wallet WASM hash that PasskeyKit needs.