Skip to main content

API Functions Reference

This section provides detailed information about the API functions available in the Gopher SDK. Use this reference to understand how to utilize the API functions in your decentralized applications (DApps).

API Functions​

setBaseUrl(url: string): void​

Sets the base URL for the API.

Parameters​

  • url: The base URL to be used for API requests.

Example​

setBaseUrl("https://new-api-url.com/");

getSupportedChains(): Promise<Chain[]>​

Fetches the supported blockchain networks.

Returns​

  • Promise<Chain[]>: A promise that resolves to an array of chain objects.

Example​

getSupportedChains().then(chains => {
  console.log('Supported chains:', chains);
});

getChainTokens(chainID: ChainID): Promise<FungibleToken[]>​

Fetches the fungible tokens available on a specific blockchain network.

Parameters​

  • chainID: The ID of the blockchain network.

Returns​

  • Promise<FungibleToken[]>: A promise that resolves to an array of fungible token objects.

Example​

getChainTokens(42161).then(tokens => {
  console.log('Chain tokens:', tokens);
});

getFungibleTokens(): Promise<FungibleToken[]>​

Fetches the available fungible tokens across all supported blockchain networks.

Returns​

  • Promise<FungibleToken[]>: A promise that resolves to an array of fungible token objects.

Example​

getFungibleTokens().then(tokens => {
  console.log('Available fungible tokens:', tokens);
});

getFungibleToken(token: TokenSymbol): Promise<FungibleToken>​

Fetches the details of a specific fungible token.

Parameters​

  • token: The symbol of the token.

Returns​

  • Promise<FungibleToken>: A promise that resolves to

a fungible token object.

Example​

getFungibleToken("USDC").then(token => {
  console.log('Fungible token:', token);
});

getUserFungibleTokens(address: Address, token: TokenSymbol): Promise<FungibleTokenBalance[]>​

Fetches the user's balances for a specific fungible token.

Parameters​

  • address: The user's Ethereum address.
  • token: The symbol of the token.

Returns​

  • Promise<FungibleTokenBalance[]>: A promise that resolves to an array of fungible token balance objects.

Example​

getUserFungibleTokens("0x123...", "USDC").then(balances => {
  console.log('User fungible token balances:', balances);
});

getSolution(options: SolutionOptions): Promise<SolutionResponse>​

Retrieves the optimal solution for managing cross-chain transactions based on the provided options.

Parameters​

  • options: An object containing the parameters for the solution request.
    • account: The account address.
    • destinationChain: The ID of the destination blockchain.
    • token: The token symbol (e.g., "USDC").
    • amount: The amount to be transferred.
    • threshold?: An optional threshold parameter.
    • whitelistedSourceChains?: An optional array of whitelisted source chain IDs.

Returns​

  • Promise<SolutionResponse>: A promise that resolves to a solution response object.

Example​

getSolution({
  account: "0x123...",
  destinationChain: 42161,
  token: "USDC",
  amount: 1000000000
}).then(solution => {
  console.log('Transaction solution:', solution);
});

Data Types​

Address​

Represents an Ethereum address as a string.

TokenSymbol​

Represents a token symbol as a string.

ChainID​

Represents a chain ID as a number.

FungibleToken​

Represents a fungible token available in the system.

Properties​

  • addresses: Record<ChainID, Address>: The addresses of the token on different chains.
  • decimals: number: The number of decimals the token uses.
  • logoURI: string: The URI for the token's logo.
  • name: string: The name of the token.
  • symbol: TokenSymbol: The symbol of the token.

Chain​

Represents a supported blockchain network.

Properties​

  • chainID: ChainID: The chain ID.
  • chainType: ChainType: The type of the chain.
  • name: string: The name of the chain.
  • logoURI: string: The URI for the chain's logo.
  • rpcurls: string[]: The RPC URLs for the chain.

FungibleTokenBalance​

Represents a balance of a fungible token.

Properties​

  • balance: string: The balance amount in the smallest unit (e.g., wei).
  • chainId: ChainID: The ID of the chain.
  • tokenDecimals: number: The number of decimals for the token.

SolutionOptions​

Parameters for retrieving a transaction solution.

Properties​

  • account: Address: The account address.
  • destinationChain: ChainID: The ID of the destination blockchain.
  • token: TokenSymbol: The token symbol (e.g., "USDC").
  • amount: number: The amount to be transferred.
  • threshold?: An optional threshold parameter.
  • whitelistedSourceChains?: An optional array of whitelisted source chain IDs.

SolutionResponse​

Represents a solution for a cross-chain transaction. It can either be an array of solutions or an error.

Properties​

  • error?: string: An optional error message if the solution failed.
  • solutions?: Solution[]: An array of solution objects if the solution succeeded.

Solution​

Represents a single solution for a cross-chain transaction.

Properties​

  • destinationChain: ChainID: The ID of the destination chain.
  • destinationTokenAddress: Address: The address of the destination token.
  • duration: number: The estimated duration for the transaction in seconds.
  • fee: Amount: The fee for the transaction.
  • gasCost: Amount: The gas cost for the transaction.
  • senderAddress: Address: The sender's address.
  • sourceChain: ChainID: The ID of the source chain.
  • sourceTokenAddress: Address: The address of the source token.
  • amount: string: The amount to be transferred.
  • tool: An object containing information about the tool used for the transaction.
    • logoURI: string: The URI for the tool's logo.
    • name: string: The name of the tool.
  • transaction: Transaction: The transaction object to be used for executing the transaction.

Transaction​

Represents a transaction object.

Properties​

  • chainId: ChainID: The ID of the chain.
  • data: string: The data for the transaction.
  • from: Address: The sender's address.
  • gasLimit: string: The gas limit for the transaction.
  • gasPrice: string: The gas price for the transaction.
  • to: Address: The recipient's address.
  • value: string: The value of the transaction in the smallest unit (e.g., wei).

Amount​

Represents an amount in both native and USD values.

Properties​

  • amount: string: The amount in the smallest unit (e.g., wei).
  • amountUSD: number: The equivalent amount in USD.

Next Steps​

  • Gopher Class: Get detailed information about the Gopher class provided by the SDK.
  • Advanced Usage: Explore advanced features and best practices.
  • Getting Started: Review the basic setup and core concepts.