Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.faremeter.xyz/llms.txt

Use this file to discover all available pages before exploring further.

solana

Type Aliases

KnownCluster

KnownCluster = SolanaCluster
Defined in: packages/info/src/solana.ts:14

KnownSPLToken

KnownSPLToken = keyof typeof knownSPLTokens
Defined in: packages/info/src/solana.ts:352

SolanaCAIP2Network

SolanaCAIP2Network = object
Defined in: packages/types/dist/src/solana.d.ts:41 Solana network identifier with associated metadata.

Properties

caip2
readonly caip2: string
Defined in: packages/types/dist/src/solana.d.ts:44
hash
readonly hash: string
Defined in: packages/types/dist/src/solana.d.ts:42
name?
readonly optional name: string
Defined in: packages/types/dist/src/solana.d.ts:43

SolanaCluster

SolanaCluster = typeof SolanaCluster.infer
Defined in: packages/types/dist/src/solana.d.ts:16

x402ExactArgs

x402ExactArgs = object
Defined in: packages/info/src/solana.ts:395

Properties

amount
amount: UnitInput
Defined in: packages/info/src/solana.ts:398
asset
asset: KnownSPLToken
Defined in: packages/info/src/solana.ts:397
network
network: KnownCluster
Defined in: packages/info/src/solana.ts:396
payTo
payTo: Base58Address
Defined in: packages/info/src/solana.ts:399

xSolanaSettlementArgs

xSolanaSettlementArgs = object
Defined in: packages/info/src/solana.ts:433

Properties

amount
amount: UnitInput
Defined in: packages/info/src/solana.ts:436
asset
asset: KnownSPLToken | "sol"
Defined in: packages/info/src/solana.ts:435
network
network: KnownCluster
Defined in: packages/info/src/solana.ts:434
payTo
payTo: Base58Address
Defined in: packages/info/src/solana.ts:437

Variables

SOLANA_DEVNET

const SOLANA_DEVNET: SolanaCAIP2Network
Defined in: packages/info/src/solana.ts:32

SOLANA_MAINNET_BETA

const SOLANA_MAINNET_BETA: SolanaCAIP2Network
Defined in: packages/info/src/solana.ts:27

SOLANA_TESTNET

const SOLANA_TESTNET: SolanaCAIP2Network
Defined in: packages/info/src/solana.ts:37

SolanaCluster

const SolanaCluster: StringType
Defined in: packages/types/dist/src/solana.d.ts:16 Validator for Solana cluster names.

Functions

caip2ToCluster()

caip2ToCluster(caip2): null | "mainnet-beta" | "devnet" | "testnet"
Defined in: packages/info/src/solana.ts:109 Converts a CAIP-2 network identifier to Solana cluster name.

Parameters

caip2
string The CAIP-2 network identifier string

Returns

null | "mainnet-beta" | "devnet" | "testnet" The cluster name, or null if not a known Solana network

caip2ToLegacyNetworkIds()

caip2ToLegacyNetworkIds(caip2): null | readonly string[]
Defined in: packages/info/src/solana.ts:135 Converts a CAIP-2 network identifier to legacy Solana network IDs.

Parameters

caip2
string The CAIP-2 network identifier string

Returns

null | readonly string[] Array of legacy network IDs, or null if unknown

clusterToCAIP2()

clusterToCAIP2(cluster): SolanaCAIP2Network
Defined in: packages/info/src/solana.ts:95 Converts a Solana cluster name to a SolanaCAIP2Network object.

Parameters

cluster
The Solana cluster name "mainnet-beta" | "devnet" | "testnet"

Returns

SolanaCAIP2Network The corresponding SolanaCAIP2Network object

Throws

Error if the cluster is unknown

createSolanaNetwork()

createSolanaNetwork(caip2, name?): SolanaCAIP2Network
Defined in: packages/types/dist/src/solana.d.ts:61 Creates a SolanaCAIP2Network object from a CAIP-2 string.

Parameters

caip2
string The CAIP-2 network identifier string (e.g., “solana:5eykt…“)
name?
string Optional display name for the network

Returns

SolanaCAIP2Network A SolanaCAIP2Network object

Throws

Error if the CAIP-2 string is invalid

getV1NetworkIds()

getV1NetworkIds(cluster): string[]
Defined in: packages/info/src/solana.ts:214 Gets the v1 legacy network IDs for a Solana cluster.

Parameters

cluster
The Solana cluster name "mainnet-beta" | "devnet" | "testnet"

Returns

string[] Array of legacy network IDs for v1 compatibility

isKnownCluster()

isKnownCluster(c): c is “mainnet-beta” | “devnet” | “testnet”
Defined in: packages/info/src/solana.ts:23

Parameters

c
string

Returns

c is “mainnet-beta” | “devnet” | “testnet”

isKnownSolanaCAIP2Network()

isKnownSolanaCAIP2Network(n): boolean
Defined in: packages/info/src/solana.ts:70 Type guard that checks if a string is a known Solana CAIP-2 network.

Parameters

n
string The string to check

Returns

boolean True if the string is a known Solana CAIP-2 network identifier

isKnownSPLToken()

isKnownSPLToken(splToken): splToken is “USDC” | “PYUSD” | “USDT” | “USDG” | “USD1” | “USX” | “CASH” | “EURC” | “JupUSD” | “USDS” | “USDtb” | “USDu” | “USDGO” | “FDUSD”
Defined in: packages/info/src/solana.ts:391 Type guard that checks if a string is a known SPL token name.

Parameters

splToken
string The string to check

Returns

splToken is “USDC” | “PYUSD” | “USDT” | “USDG” | “USD1” | “USX” | “CASH” | “EURC” | “JupUSD” | “USDS” | “USDtb” | “USDu” | “USDGO” | “FDUSD” True if the string is a known SPL token

isSolanaCAIP2Network()

isSolanaCAIP2Network(maybe): maybe is SolanaCAIP2Network
Defined in: packages/types/dist/src/solana.d.ts:52 Type guard that checks if a value is a SolanaCAIP2Network object.

Parameters

maybe
unknown The value to check

Returns

maybe is SolanaCAIP2Network True if the value is a SolanaCAIP2Network object

isSolanaCAIP2NetworkString()

isSolanaCAIP2NetworkString(maybe): maybe is string
Defined in: packages/types/dist/src/solana.d.ts:37 Type guard that checks if a value is a valid Solana CAIP-2 network string.

Parameters

maybe
unknown The value to check

Returns

maybe is string True if the value matches the Solana CAIP-2 format

isSolanaCluster()

isSolanaCluster(maybe): maybe is “mainnet-beta” | “devnet” | “testnet”
Defined in: packages/types/dist/src/solana.d.ts:24 Type guard that checks if a value is a valid Solana cluster name.

Parameters

maybe
unknown The value to check

Returns

maybe is “mainnet-beta” | “devnet” | “testnet” True if the value is a known cluster name

legacyNetworkIdToCAIP2()

legacyNetworkIdToCAIP2(legacy): null | SolanaCAIP2Network
Defined in: packages/info/src/solana.ts:123 Converts a legacy Solana network ID to a SolanaCAIP2Network object.

Parameters

legacy
string Legacy network identifier (e.g., “solana-mainnet-beta”)

Returns

null | SolanaCAIP2Network The SolanaCAIP2Network object, or null if unknown

lookupKnownSPLToken()

lookupKnownSPLToken(cluster, name): undefined | { address: string; cluster: "mainnet-beta" | "devnet" | "testnet"; name: "USDC" | "PYUSD" | "USDT" | "USDG" | "USD1" | "USX" | "CASH" | "EURC" | "JupUSD" | "USDS" | "USDtb" | "USDu" | "USDGO" | "FDUSD"; toUnit: (v) => string; }
Defined in: packages/info/src/solana.ts:361 Looks up SPL token information by cluster and token name.

Parameters

cluster
The Solana cluster "mainnet-beta" | "devnet" | "testnet"
name
The known SPL token name (e.g., “USDC”) "USDC" | "PYUSD" | "USDT" | "USDG" | "USD1" | "USX" | "CASH" | "EURC" | "JupUSD" | "USDS" | "USDtb" | "USDu" | "USDGO" | "FDUSD"

Returns

undefined | { address: string; cluster: "mainnet-beta" | "devnet" | "testnet"; name: "USDC" | "PYUSD" | "USDT" | "USDG" | "USD1" | "USX" | "CASH" | "EURC" | "JupUSD" | "USDS" | "USDtb" | "USDu" | "USDGO" | "FDUSD"; toUnit: (v) => string; } Token information including address, or undefined if not found

lookupX402Network()

lookupX402Network(network): SolanaCAIP2Network
Defined in: packages/info/src/solana.ts:181 Looks up the x402 network identifier for a Solana cluster. Accepts a cluster name, CAIP-2 identifier string, legacy network ID, or an existing SolanaCAIP2Network object.

Parameters

network
Cluster name, CAIP-2 ID, legacy network ID, or SolanaCAIP2Network object string | SolanaCAIP2Network

Returns

SolanaCAIP2Network A SolanaCAIP2Network object

Throws

Error if the network is unknown or invalid

normalizeNetworkId()

normalizeNetworkId(network): string
Defined in: packages/info/src/solana.ts:154 Normalizes a Solana network identifier to CAIP-2 format string. Accepts cluster names, legacy IDs, or CAIP-2 identifiers. Returns the input unchanged if no mapping exists.

Parameters

network
string The network identifier in any supported format

Returns

string The CAIP-2 network identifier string, or the original string if unrecognized

x402Exact()

x402Exact(args): Partial<{ asset: string; description: string; extra?: object; maxAmountRequired: string; maxTimeoutSeconds: number; mimeType?: string; network: string; outputSchema?: object; payTo: string; resource: string; scheme: string; }>[]
Defined in: packages/info/src/solana.ts:410 Creates x402 exact payment requirements for Solana. Returns multiple requirements for v1 compatibility (one per legacy network ID).

Parameters

args
x402ExactArgs Payment configuration including network, asset, amount, and payTo

Returns

Partial<{ asset: string; description: string; extra?: object; maxAmountRequired: string; maxTimeoutSeconds: number; mimeType?: string; network: string; outputSchema?: object; payTo: string; resource: string; scheme: string; }>[] Array of x402 payment requirements

xSolanaSettlement()

xSolanaSettlement(args): Partial<{ asset: string; description: string; extra?: object; maxAmountRequired: string; maxTimeoutSeconds: number; mimeType?: string; network: string; outputSchema?: object; payTo: string; resource: string; scheme: string; }>
Defined in: packages/info/src/solana.ts:448 Creates x-solana-settlement payment requirements. Supports both SPL tokens and native SOL.

Parameters

args
xSolanaSettlementArgs Payment configuration including network, asset, amount, and payTo

Returns

Partial<{ asset: string; description: string; extra?: object; maxAmountRequired: string; maxTimeoutSeconds: number; mimeType?: string; network: string; outputSchema?: object; payTo: string; resource: string; scheme: string; }> x402 payment requirement for the settlement scheme