Type Alias FacilitatorStellarSigner

FacilitatorStellarSigner - Used by t402 facilitators to verify and settle payments

This interface combines Soroban RPC capabilities with verification:

Verify signed transactions match expected parameters
Submit transactions to the Soroban RPC
Wait for transaction confirmations
Query token balances

type FacilitatorStellarSigner = {
    getAddresses(): readonly string[];
    getCurrentLedger(): Promise<number>;
    getTokenBalance(
        params: { accountAddress: string; tokenContract: string },
    ): Promise<string>;
    verifyTransaction(
        params: VerifyTransactionParams,
    ): Promise<VerifyTransactionResult>;
    submitTransaction(signedTransactionXdr: string): Promise<string>;
    waitForConfirmation(
        txHash: string,
        timeoutMs?: number,
    ): Promise<TransactionConfirmation>;
    accountExists(address: string): Promise<boolean>;
}

Index

Methods

getAddresses getCurrentLedger getTokenBalance verifyTransaction submitTransaction waitForConfirmation accountExists

Methods

getAddresses

getAddresses(): readonly string[]
Get all addresses this facilitator can use

Returns readonly string[]
- Defined in mechanisms/stellar/src/signer.ts:95

getCurrentLedger

getCurrentLedger(): Promise<number>
Get the current ledger sequence number

Returns Promise<number>
Current ledger sequence
- Defined in mechanisms/stellar/src/signer.ts:102

getTokenBalance

getTokenBalance(
params: { accountAddress: string; tokenContract: string },
): Promise<string>
Query token balance for an account
Parameters
- params: { accountAddress: string; tokenContract: string }
  Account and token contract addresses
Returns Promise<string>
Balance in smallest units
- Defined in mechanisms/stellar/src/signer.ts:110

verifyTransaction

verifyTransaction(
params: VerifyTransactionParams,
): Promise<VerifyTransactionResult>
Verify a signed transaction matches expected parameters
Parameters
- params: VerifyTransactionParams
  Verification parameters
Returns Promise<VerifyTransactionResult>
Verification result
- Defined in mechanisms/stellar/src/signer.ts:118

submitTransaction

submitTransaction(signedTransactionXdr: string): Promise<string>
Submit a signed transaction to the Soroban RPC
Parameters
- signedTransactionXdr: string
  Base64 encoded signed transaction XDR
Returns Promise<string>
Transaction hash
- Defined in mechanisms/stellar/src/signer.ts:126

waitForConfirmation

waitForConfirmation(
txHash: string,
timeoutMs?: number,
): Promise<TransactionConfirmation>
Wait for a transaction to be confirmed
Parameters
- txHash: string
  Transaction hash to monitor
- OptionaltimeoutMs: number
  Timeout in milliseconds (optional)
Returns Promise<TransactionConfirmation>
Confirmation result
- Defined in mechanisms/stellar/src/signer.ts:135

accountExists

accountExists(address: string): Promise<boolean>
Check if an account exists on the network
Parameters
- address: string
  G-account address to check
Returns Promise<boolean>
true if account exists
- Defined in mechanisms/stellar/src/signer.ts:143