Class OnboardingBridgeSDK

TypeScript SDK for the C-Address Onboarding Bridge Soroban contract.

Provides typed wrappers around every contract function. Mutating methods return a TransactionResult and never throw — errors are surfaced through result.status === 'failed'. Read-only query methods throw on RPC or contract error so you can use standard try/catch patterns.

All RPC calls are automatically retried on transient network failures using exponential backoff with full jitter (see withRpcRetry). The retry policy is configurable via BridgeConfig.retry.

Example

import { OnboardingBridgeSDK } from '@stellar/c-address-onboarding-bridge-sdk';
import { Keypair, Networks } from '@stellar/stellar-sdk';

const sdk = new OnboardingBridgeSDK({
  contractId: 'CA...',
  rpcUrl: 'https://soroban-testnet.stellar.org',
  networkPassphrase: Networks.TESTNET,
});

const keypair = Keypair.fromSecret(process.env.SECRET!);
const result = await sdk.fundCAddress(
  { source: keypair.publicKey(), target: 'CC...', asset: 'CD...', amount: '1000000' },
  keypair,
);
if (result.status === 'failed') console.error(result.error);

Index

Constructors

constructor

new OnboardingBridgeSDK(config): OnboardingBridgeSDK
Create a new SDK instance.

Validates config.contractId immediately and throws if it is not a valid Stellar C-address. No network call is made during construction.
Parameters
- config: BridgeConfig
  SDK configuration: contract ID, RPC URL, network passphrase, and optional timeout / retry settings.
Returns OnboardingBridgeSDK
Throws
If config.contractId is not a valid contract address.
Example
```
const sdk = new OnboardingBridgeSDK({
  contractId: 'CA...',
  rpcUrl: 'https://soroban-testnet.stellar.org',
  networkPassphrase: Networks.TESTNET,
  retry: { maxRetries: 5 },
});
```
- Defined in bridge.ts:143

Methods

acceptAdmin

acceptAdmin(pendingAdminKeypair): Promise<TransactionResult>
Accept a pending admin handover (must be signed by the proposed admin).

Completes the handover started by proposeNewAdmin. Fails if there is no pending admin, or if pendingAdminKeypair does not match the address that was proposed.
Parameters
- pendingAdminKeypair: Keypair
  Keypair of the proposed (pending) admin.
Returns Promise<TransactionResult>
A TransactionResult.
Throws
Never — errors are returned as status: 'failed'.
Example
```
await sdk.acceptAdmin(newAdminKeypair);
```
- Defined in bridge.ts:2047

acceptFeeCollector

acceptFeeCollector(pendingCollectorKeypair): Promise<TransactionResult>
Accept a pending fee-collector handover (must be signed by the proposed fee collector).

Completes the handover started by proposeNewFeeCollector. Fails if there is no pending fee collector, or if pendingCollectorKeypair does not match the address that was proposed.
Parameters
- pendingCollectorKeypair: Keypair
  Keypair of the proposed (pending) fee collector.
Returns Promise<TransactionResult>
A TransactionResult.
Throws
Never — errors are returned as status: 'failed'.
Example
```
await sdk.acceptFeeCollector(newCollectorKeypair);
```
- Defined in bridge.ts:2232

addRelayer

addRelayer(options, adminKeypair): Promise<TransactionResult>
Register an Ed25519 relayer public key on the contract (admin only).

Registered relayers are authorised to submit attestation signatures for cross-chain events via fundCrosschain. After adding, update the threshold with setRelayerThreshold if needed.
Parameters
- options: RelayerManagementOptions
  Contains the pubkey and optional admin nonce.
- adminKeypair: Keypair
  Keypair of the admin account.
Returns Promise<TransactionResult>
A TransactionResult.

Throws
Never — errors are returned as status: 'failed'.
- Defined in bridge.ts:2660

batchFundCAddresses

batchFundCAddresses(options, sourceKeypair, onProgress?): Promise<TransactionResult[]>
Fund multiple C-addresses from a single source account, automatically splitting large batches across multiple transactions.

When the number of options.targets exceeds BATCH_TX_LIMIT, the list is split into chunks of at most BATCH_TX_LIMIT entries and one on-chain batch_fund_c_address transaction is submitted per chunk. This means a single call to batchFundCAddresses may submit multiple transactions and returns an array of TransactionResult — one entry per submitted transaction, in order.

Within each chunk the contract pulls the sum of that chunk's amounts from source upfront. For targets that fail access control the corresponding amount is refunded to source and a BatchTransferFailed event is emitted. A BatchCompleted event is emitted at the end of each on-chain transaction.

options.targets and options.amounts must be the same length.
Parameters
- options: BatchFundCOptions
  Batch transfer parameters: source, targets, amounts, asset.
- sourceKeypair: Keypair
  Keypair of the source account used to sign every transaction.
- OptionalonProgress: BatchProgressCallback
  Optional callback invoked after each transaction is submitted. Receives the cumulative count of recipients processed, the total recipient count, and the tx hash (or undefined if submission failed before a hash was returned).
Returns Promise<TransactionResult[]>
An array of TransactionResult, one per submitted transaction. If the entire batch fits in a single transaction the array has one element. On a per-chunk submission error the corresponding element has status: 'failed'; processing continues with the remaining chunks.
Throws
Never — errors are returned as status: 'failed' in the results array.
Example
```
// Small batch — fits in one tx
const [result] = await sdk.batchFundCAddresses(
  {
    source:  keypair.publicKey(),
    targets: ['CC...1', 'CC...2', 'CC...3'],
    amounts: ['5000000', '3000000', '2000000'],
    asset:   'CD...usdc',
  },
  keypair,
);

// Large batch — auto-split with progress reporting
const results = await sdk.batchFundCAddresses(
  { source: keypair.publicKey(), targets: largeTargetList, amounts: largeAmountList, asset: 'CD...' },
  keypair,
  (completed, total, txHash) => {
    console.log(`Processed ${completed}/${total} recipients — tx: ${txHash}`);
  },
);
```
- Defined in bridge.ts:854

cancelUpgrade

cancelUpgrade(options, adminKeypair): Promise<TransactionResult>
Parameters
- options: CancelUpgradeOptions
- adminKeypair: Keypair
Returns Promise<TransactionResult>
- Defined in bridge.ts:2408

claimTimelocked

claimTimelocked(id, targetKeypair): Promise<TransactionResult>
Claim a matured timelocked funding entry.
Parameters
- id: number
- targetKeypair: Keypair
Returns Promise<TransactionResult>
- Defined in bridge.ts:581

commitFund

commitFund(options, sourceKeypair): Promise<TransactionResult>
Parameters
- options: CommitFundOptions
- sourceKeypair: Keypair
Returns Promise<TransactionResult>
- Defined in bridge.ts:347

estimateCost

estimateCost(options): Promise<CostEstimate>
Estimate the transaction cost for a fundCAddress call without submitting it to the network.

Runs simulateTransaction under the hood and extracts the Soroban resource fee, the base inclusion fee, and the minimum account balance required.
Parameters
- options: FundCOptions
  The fundCAddress call to price.
Returns Promise<CostEstimate>
The estimated fees plus the source account's minimum balance.
Example
```
const estimate = await sdk.estimateCost({
  source: keypair.publicKey(),
  target: 'CC...',
  asset: 'CD...',
  amount: '10000000',
});
console.log('Resource fee:', estimate.resourceFee, 'stroops');
console.log('Total fee:   ', estimate.fee, 'stroops');
console.log('Min balance: ', estimate.minBalance, 'stroops');
```
- Defined in bridge.ts:3028

executeMetaFund

executeMetaFund(options, relayerKeypair): Promise<TransactionResult>
Parameters
- options: ExecuteMetaFundOptions
- relayerKeypair: Keypair
Returns Promise<TransactionResult>
- Defined in bridge.ts:2494

executeUpgrade

executeUpgrade(options, adminKeypair): Promise<TransactionResult>
Parameters
- options: ExecuteUpgradeOptions
- adminKeypair: Keypair
Returns Promise<TransactionResult>
- Defined in bridge.ts:2395

fundCAddress

fundCAddress(options, sourceKeypair): Promise<TransactionResult>
Fund a single C-address from a source G-address.

Transfers options.amount of options.asset from source into the bridge contract, deducts the protocol fee, and forwards the net amount to target. The source account must authorise the token transfer — this is handled automatically by Soroban's require_auth mechanism when the transaction is signed with sourceKeypair.
Parameters
- options: FundCOptions
  Transfer parameters: source, target, asset, amount.
- sourceKeypair: Keypair
  Keypair of the source account. Used to sign the transaction. Must correspond to options.source.
Returns Promise<TransactionResult>
A TransactionResult with status: 'pending' on successful submission, or status: 'failed' with an error message. Poll SorobanRpc.Server.getTransaction(result.hash) to confirm finality before showing success to the user.
Throws
Never — errors are returned as status: 'failed'.
Example
```
const result = await sdk.fundCAddress(
  {
    source: keypair.publicKey(),
    target: 'CC...',
    asset:  'CD...usdc',
    amount: '10000000', // 1 USDC (7 decimal places)
  },
  keypair,
);

if (result.status === 'failed') {
  console.error('Transfer failed:', result.error);
} else {
  console.log('Submitted tx:', result.hash);
}
```
- Defined in bridge.ts:197

fundCAddressTimelocked

fundCAddressTimelocked(options, sourceKeypair): Promise<TransactionResult>
Create a timelocked funding entry for a C-address.

Transfers options.amount of options.asset from source into the bridge contract immediately. The target can later call claimTimelocked once releaseTime has passed.
Parameters
- options: FundCTimelockedOptions
- sourceKeypair: Keypair
Returns Promise<TransactionResult>
- Defined in bridge.ts:491

fundCAddressWithReferral

fundCAddressWithReferral(options, sourceKeypair): Promise<TransactionResult>
Parameters
- options: FundCAddressWithReferralOptions
- sourceKeypair: Keypair
Returns Promise<TransactionResult>
- Defined in bridge.ts:274

fundCAddressWithSwap

fundCAddressWithSwap(options, sourceKeypair): Promise<TransactionResult>
Fund a C-address by swapping the source asset into a different target asset first.

Calls fund_c_address_with_swap on the bridge contract which:
1. Pulls sourceAmount of sourceAsset from source.
2. Routes it through the DEX pools in swapRoute.
3. Deducts the fee in targetAsset and forwards the net to target.
Parameters
- options: FundCAddressWithSwapOptions
- sourceKeypair: Keypair
Returns Promise<TransactionResult>
Example
```
const result = await sdk.fundCAddressWithSwap(
  {
    source: keypair.publicKey(),
    target: 'CC...',
    sourceAsset: USDC_CONTRACT,
    targetAsset: XLM_CONTRACT,
    sourceAmount: '10000000', // 1 USDC
    minTargetAmount: '9000000', // 0.9 XLM (10% max slippage)
    swapRoute: [USDC_XLM_POOL],
  },
  keypair,
);
```
- Defined in bridge.ts:706

fundCrosschain

fundCrosschain(options, relayerKeypair): Promise<TransactionResult>
Fund a C-address from a cross-chain event (called by the relayer service). Requires at least threshold valid relayer signatures over the canonical payload hash.
Parameters
- options: CrossChainFundOptions
- relayerKeypair: Keypair
Returns Promise<TransactionResult>
- Defined in bridge.ts:2566

getAdmin

getAdmin(): Promise<string>
Get the current admin G-address.

The admin account is authorised to update fee rates, fee collector, admin address, asset whitelist, access control lists, and to upgrade the contract.

Returns Promise<string>
The admin G-address as a string.
Throws
On RPC failure or contract error.
Example
```
const admin = await sdk.getAdmin();
console.log('Admin:', admin);
```
- Defined in bridge.ts:1231

getAllBalances

getAllBalances(assets): Promise<Record<string, string>>
Get the contract's token balances for multiple assets in a single RPC call.

Returns a plain object mapping each asset contract address to its balance string. Useful for dashboard or monitoring use-cases.
Parameters
- assets: string[]
  Array of token contract addresses to query.
Returns Promise<Record<string, string>>
A Record<assetAddress, balanceString>. Assets with a zero balance are included with value '0'.
Throws
If any address in assets is invalid or on RPC failure.
Example
```
const balances = await sdk.getAllBalances(['CD...usdc', 'CD...xlm']);
// { 'CD...usdc': '1200000', 'CD...xlm': '500000000' }
```
- Defined in bridge.ts:1435

getCAddressBalance

getCAddressBalance(cAddress, asset): Promise<string>
Query the token balance of any address (G-address or C-address) for a given asset, using the bridge contract's query_balance view function.
Parameters
- cAddress: string
  The address to query (G-address or C-address).
- asset: string
  Token contract address to check the balance for.
Returns Promise<string>
The balance in the token's smallest unit as a decimal string.
Throws
If either address is invalid or on RPC failure.
Example
```
const balance = await sdk.getCAddressBalance('CC...', 'CD...usdc');
console.log('Balance:', balance); // e.g. '10000000' = 1 USDC
```
- Defined in bridge.ts:1264

getContractBalance

getContractBalance(asset): Promise<string>
Get the contract's raw token balance for an asset.

This includes accrued fees, timelocked funds, loyalty reserves, and any other tokens held by the contract.
Parameters
- asset: string
Returns Promise<string>
- Defined in bridge.ts:1397

getFee

getFee(): Promise<number>
Get the current protocol fee in basis points (bps).

1 bps = 0.01%, so 50 means a 0.5% fee is deducted from each transfer. The maximum allowed value is 1000 (10%).

Returns Promise<number>
The fee in basis points as a number.
Throws
On RPC failure or contract error.
Example
```
const feeBps = await sdk.getFee();
console.log(`Current fee: ${feeBps / 100}%`);
```
- Defined in bridge.ts:1152

getFeeBalance

getFeeBalance(asset): Promise<string>
Get the accumulated (uncollected) fee balance for a specific asset.

Use this before calling withdrawFees to know the exact withdrawable amount.
Parameters
- asset: string
  Token contract address.
Returns Promise<string>
The accrued fee balance in the token's smallest unit as a string.
Throws
If asset is not a valid contract address or on RPC failure.
Example
```
const fees = await sdk.getFeeBalance('CD...usdc');
console.log('Uncollected fees:', fees);
```
- Defined in bridge.ts:1372

getFeeCollector

getFeeCollector(): Promise<string>
Get the current fee-collector G-address.

The fee collector is the only account authorised to call withdrawFees.

Returns Promise<string>
The fee-collector G-address as a string.
Throws
On RPC failure or contract error.
Example
```
const collector = await sdk.getFeeCollector();
console.log('Fee collector:', collector);
```
- Defined in bridge.ts:1199

getPendingAdmin

getPendingAdmin(): Promise<null | string>
Get the pending admin G-address, if an admin handover is in progress.

Returns Promise<null | string>
The pending admin's G-address, or null if there is no pending handover.

Throws
On RPC failure.
- Defined in bridge.ts:2107

getPendingFeeCollector

getPendingFeeCollector(): Promise<null | string>
Get the pending fee-collector G-address, if a handover is in progress.

Returns Promise<null | string>
The pending fee collector's G-address, or null if there is no pending handover.

Throws
On RPC failure.
- Defined in bridge.ts:2292

getWhitelistedAssets

getWhitelistedAssets(cursor?, limit?): Promise<PaginatedResult<string>>
Return a paginated list of whitelisted asset contract addresses.

Only whitelisted assets can be used in fundCAddress and batch calls. Pagination happens on-chain: the cursor encodes the offset, and the contract only returns up to limit entries starting at that offset.
Parameters
- Optionalcursor: string
  Opaque cursor from a previous call. Omit to start from page 1.
- limit: number = 20
  Maximum items per page. Defaults to 20.
Returns Promise<PaginatedResult<string>>
A PaginatedResult containing asset C-addresses for this page.
Throws
On RPC failure.
Example
```
let page = await sdk.getWhitelistedAssets();
while (page.hasMore) {
  page = await sdk.getWhitelistedAssets(page.cursor);
}
```
- Defined in bridge.ts:2906

isAllowlisted

isAllowlisted(address): Promise<boolean>
Check whether an address is on the allowlist.

When the contract is in allowlist mode, only allowlisted addresses can receive funds. Non-allowlisted targets in batch calls are skipped and their amounts refunded to the source.

There is no contract call that lists the full allowlist — only a per-address membership check (query_is_allowlisted) — so this replaces the previous (non-functional) getAllowlistedAddresses listing method. Build a full listing from indexer events instead, once allowlist events exist.
Parameters
- address: string
  The address to check.
Returns Promise<boolean>
true if address is allowlisted.

Throws
On RPC failure.
- Defined in bridge.ts:2989

isBlocked

isBlocked(address): Promise<boolean>
Check whether an address is on the blocklist.

Blocklisted addresses cannot receive funds via fundCAddress or batch calls. Transfers to them are silently skipped (in batch) or rejected (single).

There is no contract call that lists the full blocklist — only a per-address membership check (query_is_blocked) — so this replaces the previous (non-functional) getBlocklistedAddresses listing method. Build a full listing from indexer events instead, once blocklist events exist.
Parameters
- address: string
  The address to check.
Returns Promise<boolean>
true if address is blocklisted.

Throws
On RPC failure.
- Defined in bridge.ts:2954

isInitialized

isInitialized(): Promise<boolean>
Check whether the bridge contract has been initialized.

The contract must be initialized (via initialize) before any funding operations are permitted. Use this after deployment to verify the contract is ready for use.

Returns Promise<boolean>
true if the contract has been initialized, false otherwise.
Throws
On RPC failure.
Example
```
const ready = await sdk.isInitialized();
if (!ready) throw new Error('Contract not initialized yet');
```
- Defined in bridge.ts:1478

proposeNewAdmin

proposeNewAdmin(newAdmin, adminKeypair, nonce?): Promise<TransactionResult>
Propose an admin handover to a new G-address (admin only).

This two-step path is preferred over setAdmin for normal operations because it proves the proposed admin controls the key (via acceptAdmin) before the role is moved — setAdmin transfers control immediately and unrecoverably if the new key is unusable.
Parameters
- newAdmin: string
  G-address of the proposed admin.
- adminKeypair: Keypair
  Keypair of the current admin account.
- Optionalnonce: string | number | bigint
Returns Promise<TransactionResult>
A TransactionResult.
Throws
Never — errors are returned as status: 'failed'.
Example
```
await sdk.proposeNewAdmin('G...newAdmin', adminKeypair);
// newAdmin then calls:
await sdk.acceptAdmin(newAdminKeypair);
```
- Defined in bridge.ts:1962

proposeNewFeeCollector

proposeNewFeeCollector(newCollector, adminKeypair, nonce?): Promise<TransactionResult>
Propose a fee-collector handover to a new G-address (admin only).

This two-step path is preferred over setFeeCollector for normal operations because it proves the proposed collector controls the key (via acceptFeeCollector) before the role is moved.
Parameters
- newCollector: string
  G-address of the proposed fee collector.
- adminKeypair: Keypair
  Keypair of the admin account.
- Optionalnonce: string | number | bigint
Returns Promise<TransactionResult>
A TransactionResult.
Throws
Never — errors are returned as status: 'failed'.
Example
```
await sdk.proposeNewFeeCollector('G...newCollector', adminKeypair);
// newCollector then calls:
await sdk.acceptFeeCollector(newCollectorKeypair);
```
- Defined in bridge.ts:2146

queryCommitment

queryCommitment(id): Promise<null | CommitmentEntry>
Parameters
- id: string | number | bigint
Returns Promise<null | CommitmentEntry>
- Defined in bridge.ts:1285

queryCurrentTier

queryCurrentTier(source): Promise<null | FeeTier>
Parameters
- source: string
Returns Promise<null | FeeTier>
- Defined in bridge.ts:1338

queryFeeTiers

queryFeeTiers(): Promise<FeeTier[]>
Returns Promise<FeeTier[]>
- Defined in bridge.ts:1322

queryIsRelayer

queryIsRelayer(pubkeyHex): Promise<boolean>
Check whether a given Ed25519 public key is a registered relayer.
Parameters
- pubkeyHex: string
  32-byte Ed25519 public key as a lowercase hex string.
Returns Promise<boolean>
true if the pubkey is registered, false otherwise.

Throws
On RPC failure.
- Defined in bridge.ts:2845

queryLoyaltyToken

queryLoyaltyToken(): Promise<null | LoyaltyToken>
Returns Promise<null | LoyaltyToken>
- Defined in bridge.ts:1306

queryPendingUpgrade

queryPendingUpgrade(): Promise<null | PendingUpgrade>
Returns Promise<null | PendingUpgrade>
- Defined in bridge.ts:2468

queryReferralRate

queryReferralRate(): Promise<number>
Returns Promise<number>
- Defined in bridge.ts:1168

queryRelayerThreshold

queryRelayerThreshold(): Promise<number>
Query the current M-of-N relayer threshold.

Returns Promise<number>
The threshold as a number (M in M-of-N).

Throws
On RPC failure.
- Defined in bridge.ts:2820

queryTimelocked

queryTimelocked(id): Promise<null | TimelockEntry>
Query a timelocked funding entry by ID.
Parameters
- id: number
Returns Promise<null | TimelockEntry>
- Defined in bridge.ts:644

reclaimTokens

reclaimTokens(options, adminKeypair): Promise<TransactionResult>
Reclaim tokens accidentally sent directly to the bridge contract address.

Admin only. This is an emergency recovery tool — it moves the contract's raw token balance (minus any accrued fees for that asset) to options.to.
Parameters
- options: ReclaimTokensOptions
  Asset, amount, and destination address.
- adminKeypair: Keypair
  Keypair of the admin account.
Returns Promise<TransactionResult>
A TransactionResult.
Throws
Never — errors are returned as status: 'failed'.
Example
```
await sdk.reclaimTokens(
  { asset: 'CD...', amount: '1000000', to: 'G...safeAddress' },
  adminKeypair,
);
```
- Defined in bridge.ts:1073

removeRelayer

removeRelayer(options, adminKeypair): Promise<TransactionResult>
Remove a previously registered Ed25519 relayer public key (admin only).

The removed key can no longer contribute valid signatures for cross-chain attestations. Ensure the remaining relayer set still meets the threshold or lower the threshold first.
Parameters
- options: RelayerManagementOptions
  Contains the 32-byte Ed25519 pubkey as a hex string.
- adminKeypair: Keypair
  Keypair of the admin account.
Returns Promise<TransactionResult>
A TransactionResult.

Throws
Never — errors are returned as status: 'failed'.
- Defined in bridge.ts:2717

revealFund

revealFund(options, sourceKeypair): Promise<TransactionResult>
Parameters
- options: RevealFundOptions
- sourceKeypair: Keypair
Returns Promise<TransactionResult>
- Defined in bridge.ts:415

scheduleUpgrade

scheduleUpgrade(options, adminKeypair): Promise<TransactionResult>
Parameters
- options: ScheduleUpgradeOptions
- adminKeypair: Keypair
Returns Promise<TransactionResult>
- Defined in bridge.ts:2382

setAdmin

setAdmin(newAdmin, adminKeypair, nonce?): Promise<TransactionResult>
Transfer the admin role to a new G-address (admin only).

After this call the old admin loses all privileged access. Ensure the new admin keypair is accessible before calling this — there is no recovery path if the new admin key is lost.
Parameters
- newAdmin: string
  G-address of the new admin.
- adminKeypair: Keypair
  Keypair of the current admin account.
- Optionalnonce: string | number | bigint
Returns Promise<TransactionResult>
A TransactionResult.
Throws
Never — errors are returned as status: 'failed'.
Example
```
await sdk.setAdmin('G...newAdmin', adminKeypair);
```
- Defined in bridge.ts:1873

setFee

setFee(newFeeBps, adminKeypair, nonce?): Promise<TransactionResult>
Update the protocol fee rate (admin only).

The new fee takes effect on the next fund_c_address call. Maximum allowed value is 1000 bps (10%).
Parameters
- newFeeBps: number
  New fee in basis points (0–1000).
- adminKeypair: Keypair
  Keypair of the admin account.
- Optionalnonce: string | number | bigint
Returns Promise<TransactionResult>
A TransactionResult.
Throws
Never — errors are returned as status: 'failed'.
Example
```
await sdk.setFee(75, adminKeypair); // set to 0.75%
```
- Defined in bridge.ts:1514

setFeeCollector

setFeeCollector(newFeeCollector, adminKeypair, nonce?): Promise<TransactionResult>
Rotate the fee-collector address (admin only).

The new fee collector immediately gains the right to call withdrawFees. The old fee collector loses it.
Parameters
- newFeeCollector: string
  G-address of the new fee collector.
- adminKeypair: Keypair
  Keypair of the admin account.
- Optionalnonce: string | number | bigint
Returns Promise<TransactionResult>
A TransactionResult.
Throws
Never — errors are returned as status: 'failed'.
Example
```
await sdk.setFeeCollector('G...newCollector', adminKeypair);
```
- Defined in bridge.ts:1787

setFeeTiers

setFeeTiers(tiers, adminKeypair): Promise<TransactionResult>
Parameters
- tiers: FeeTier[]
- adminKeypair: Keypair
Returns Promise<TransactionResult>
- Defined in bridge.ts:1709

setLoyaltyToken

setLoyaltyToken(token, amountPerFund, adminKeypair): Promise<TransactionResult>
Parameters
- token: string
- amountPerFund: string | number | bigint
- adminKeypair: Keypair
Returns Promise<TransactionResult>
- Defined in bridge.ts:1646

setReferralRate

setReferralRate(bps, adminKeypair, nonce?): Promise<TransactionResult>
Parameters
- bps: number
- adminKeypair: Keypair
- Optionalnonce: string | number | bigint
Returns Promise<TransactionResult>
- Defined in bridge.ts:1584

setRelayerThreshold

setRelayerThreshold(threshold, adminKeypair): Promise<TransactionResult>
Set the M-of-N relayer threshold (admin only).

Cross-chain attestations require at least threshold valid signatures from registered relayers. Must not exceed the total number of registered relayers.
Parameters
- threshold: number
  Minimum number of valid relayer signatures required.
- adminKeypair: Keypair
  Keypair of the admin account.
Returns Promise<TransactionResult>
A TransactionResult.
Throws
Never — errors are returned as status: 'failed'.
Example
```
// Require 2-of-3 relayers
await sdk.setRelayerThreshold(2, adminKeypair);
```
- Defined in bridge.ts:2775

upgrade

upgrade(options, adminKeypair): Promise<TransactionResult>
Upgrade the contract to a new wasm implementation (admin only). The new_wasm_hash must reference wasm already uploaded to the network. Preserves all instance storage (admin, fee settings, etc.).
Parameters
- options: UpgradeOptions
- adminKeypair: Keypair
Returns Promise<TransactionResult>
- Defined in bridge.ts:2315

withdrawFees

withdrawFees(options, feeCollectorKeypair): Promise<TransactionResult>
Withdraw accumulated protocol fees from the bridge contract.

Only the configured fee-collector address may call this method. Fees accumulate in the contract after every successful fund_c_address or batch_fund_c_address call.
Parameters
- options: WithdrawFeesOptions
  Asset and amount to withdraw.
- feeCollectorKeypair: Keypair
  Keypair of the fee-collector account.
Returns Promise<TransactionResult>
A TransactionResult.
Throws
Never — errors are returned as status: 'failed'.
Example
```
const balance = await sdk.getFeeBalance('CD...usdc');
const result  = await sdk.withdrawFees(
  { asset: 'CD...usdc', amount: balance },
  feeCollectorKeypair,
);
```
- Defined in bridge.ts:990

Class OnboardingBridgeSDK

Example

Index

Constructors

Methods

Constructors

constructor

Parameters

Returns OnboardingBridgeSDK

Throws

Example

Methods

acceptAdmin

Parameters

Returns Promise<TransactionResult>

Throws

Example

acceptFeeCollector

Parameters

Returns Promise<TransactionResult>

Throws

Example

addRelayer

Parameters

Returns Promise<TransactionResult>

Throws

batchFundCAddresses

Parameters

Returns Promise<TransactionResult[]>

Throws

Example

cancelUpgrade

Parameters

Returns Promise<TransactionResult>

claimTimelocked

Parameters

Returns Promise<TransactionResult>

commitFund

Parameters

Returns Promise<TransactionResult>

estimateCost

Parameters

Returns Promise<CostEstimate>

Example

executeMetaFund

Parameters

Returns Promise<TransactionResult>

executeUpgrade

Parameters

Returns Promise<TransactionResult>

fundCAddress

Parameters

Returns Promise<TransactionResult>

Throws

Example

fundCAddressTimelocked

Parameters

Returns Promise<TransactionResult>

fundCAddressWithReferral

Parameters

Returns Promise<TransactionResult>

fundCAddressWithSwap

Parameters

Returns Promise<TransactionResult>

Example

fundCrosschain

Parameters

Returns Promise<TransactionResult>

getAdmin

Returns Promise<string>

Throws

Example

getAllBalances

Parameters

Returns Promise<Record<string, string>>

Throws

Example

getCAddressBalance

Parameters

Returns Promise<string>