@provablehq/aleo-bridge-sdk 0.1.0

package/dist/mcp/index.d.ts

@@ -0,0 +1,28 @@
+import { McpServer } from '@provablehq/veil-core/mcp';
+export { McpServer, McpToolDefinition } from '@provablehq/veil-core/mcp';
+import { K as BridgeClient } from '../createBridgeClient-DzmEyXfG.js';
+import '@provablehq/veil-core';
+import '../solana-D5Qr6SLa.js';
+import 'viem';
+
+/**
+ * Creates an MCP server for discovering and describing cross-chain transfers.
+ *
+ * The exposed tools list assets and routes and quote a proposed transfer,
+ * including current costs where the selected route exposes them. They cannot
+ * request a signature, submit a transaction, or move funds.
+ *
+ * Exposed via subpath export: `import { createBridgeMcpServer } from '@provablehq/aleo-bridge-sdk/mcp'`.
+ *
+ * @param client Bridge client supplying the supported asset and route catalog.
+ * @returns MCP server exposing the non-fund-moving bridge tools.
+ *
+ * @example
+ * const server = createBridgeMcpServer(client)
+ * const routes = await server.handleToolCall('bridge_list_routes', {
+ *   protocol: 'xreserve',
+ * })
+ */
+declare function createBridgeMcpServer(client: BridgeClient): McpServer;
+
+export { createBridgeMcpServer };

package/dist/mcp/index.js

@@ -0,0 +1,13 @@
+import {
+  createBridgeAgentTools
+} from "../chunk-NTWXJE7R.js";
+
+// src/mcp/index.ts
+import { toMcpServer } from "@provablehq/veil-core/mcp";
+function createBridgeMcpServer(client) {
+  return toMcpServer(createBridgeAgentTools(client));
+}
+export {
+  createBridgeMcpServer
+};
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/mcp/index.ts"],"sourcesContent":["import { toMcpServer, type McpServer } from '@provablehq/veil-core/mcp'\nimport { createBridgeAgentTools } from '../agent/tools.js'\nimport type { BridgeClient } from '../clients/createBridgeClient.js'\n\nexport type { McpServer, McpToolDefinition } from '@provablehq/veil-core/mcp'\n\n/**\n * Creates an MCP server for discovering and describing cross-chain transfers.\n *\n * The exposed tools list assets and routes and quote a proposed transfer,\n * including current costs where the selected route exposes them. They cannot\n * request a signature, submit a transaction, or move funds.\n *\n * Exposed via subpath export: `import { createBridgeMcpServer } from '@provablehq/aleo-bridge-sdk/mcp'`.\n *\n * @param client Bridge client supplying the supported asset and route catalog.\n * @returns MCP server exposing the non-fund-moving bridge tools.\n *\n * @example\n * const server = createBridgeMcpServer(client)\n * const routes = await server.handleToolCall('bridge_list_routes', {\n *   protocol: 'xreserve',\n * })\n */\nexport function createBridgeMcpServer(client: BridgeClient): McpServer {\n  return toMcpServer(createBridgeAgentTools(client))\n}\n"],"mappings":";;;;;AAAA,SAAS,mBAAmC;AAwBrC,SAAS,sBAAsB,QAAiC;AACrE,SAAO,YAAY,uBAAuB,MAAM,CAAC;AACnD;","names":[]}

package/dist/solana/index.d.ts

@@ -0,0 +1,113 @@
+import * as _solana_kit from '@solana/kit';
+import { K as SolanaHyperlaneRouteMetadata } from '../solana-D5Qr6SLa.js';
+export { D as DEFAULT_SOLANA_RPC_URL, W as SolanaRpcClient, X as createSolanaRpcClient } from '../solana-D5Qr6SLa.js';
+
+/**
+ * Lazily imports the optional `@solana/kit` peer dependency.
+ *
+ * This is the only module in the package permitted to import `@solana/kit`
+ * directly, so applications that never use Solana do not load the optional
+ * dependency. The import is performed at most once per process and does not
+ * contact a chain or wallet.
+ *
+ * @returns The `@solana/kit` module namespace once dynamic import resolves.
+ * @throws BridgeError When `@solana/kit` cannot be resolved, naming the
+ * install command and wrapping the original module-resolution error as
+ * `cause`.
+ *
+ * @example
+ * const kit = await loadKit()
+ * const signer = await kit.createKeyPairSignerFromBytes(secretKeyBytes)
+ */
+declare function loadKit(): Promise<typeof _solana_kit>;
+
+/**
+ * Identifies one Solana account entry in a compiled instruction's account list.
+ *
+ * @property address Base58-encoded Solana account address.
+ * @property signer Whether the transaction must carry this account's signature.
+ * @property writable Whether the runtime may write to this account during the instruction.
+ */
+type SolanaAccountMeta = {
+    address: string;
+    signer: boolean;
+    writable: boolean;
+};
+/**
+ * Selects the route, parties, and amount for one Sealevel `TransferRemote` instruction.
+ *
+ * @property metadata Reviewed static accounts and domain for the Solana Hyperlane Warp Route.
+ * @property senderAddress Base58 address of the wallet funding the transfer; signs and pays rent.
+ * @property uniqueMessageAddress Base58 address of a fresh, caller-supplied signer that seeds the
+ * dispatched-message and gas-payment program-derived addresses and proves transaction uniqueness.
+ * @property recipientAleoAddress Aleo `aleo1…` address receiving the transfer on the destination chain.
+ * @property amountLamports Amount to transfer, in lamports.
+ */
+type BuildTransferRemoteParameters = {
+    metadata: SolanaHyperlaneRouteMetadata;
+    senderAddress: string;
+    uniqueMessageAddress: string;
+    recipientAleoAddress: string;
+    amountLamports: bigint;
+};
+/**
+ * Builds the Solana instruction that commits SOL to a Hyperlane transfer bound for Aleo.
+ *
+ * The result is unsigned and cannot move funds until the sender and unique
+ * message account sign it and a client broadcasts it. Every program account is
+ * supplied by reviewed route metadata or derived from the unique message key;
+ * no network or wallet is contacted. The encoding is verified byte-for-byte
+ * against `test/fixtures/sealevel-transfer-remote.json`.
+ *
+ * @param params Route metadata, transfer parties, and the lamport amount to move.
+ * @returns The Warp Route program, ordered accounts, and raw 77-byte instruction data needed to assemble the transaction.
+ * @throws BridgeError When `amountLamports` does not fit the instruction's 32-byte unsigned width,
+ * or when `recipientAleoAddress` is not a valid Aleo address.
+ *
+ * @example
+ * const instruction = await buildTransferRemoteInstruction({
+ *   metadata: route.solana,
+ *   senderAddress: await walletClient.getAddress(),
+ *   uniqueMessageAddress: uniqueSigner.address,
+ *   recipientAleoAddress: 'aleo1…',
+ *   amountLamports: 1_000_000_000n,
+ * })
+ */
+declare function buildTransferRemoteInstruction(params: BuildTransferRemoteParameters): Promise<{
+    programAddress: string;
+    accounts: SolanaAccountMeta[];
+    data: Uint8Array;
+}>;
+
+/**
+ * Computes the lamport gas payment a Sealevel interchain gas paymaster (IGP)
+ * quotes for delivering a message to a given destination domain.
+ *
+ * Decodes the supplied IGP account's gas-oracle table and applies the
+ * paymaster's `compute_gas_fee` formula (SEALEVEL_NOTES.md §4) without
+ * contacting Solana. `igpAccountData` must be the terminal, quoted `Igp`
+ * account — the one an `OverheadIgp` wrapper's own `inner` field points at,
+ * not the `OverheadIgp` wrapper account itself — and `gasAmount` must be the
+ * warp token's own `destination_gas` value for the domain, not derived from
+ * the message.
+ *
+ * @param params.igpAccountData Raw account data of the terminal Sealevel `Igp` account.
+ * @param params.destinationDomain Hyperlane domain the transfer is bound for.
+ * @param params.gasAmount Destination gas units to quote, as reported by the warp token's `destination_gas` configuration.
+ * @returns The gas payment required, in lamports.
+ * @throws BridgeError When `igpAccountData` has no gas-oracle entry for `destinationDomain`.
+ *
+ * @example
+ * const lamports = quoteIgpGasPayment({
+ *   igpAccountData: await rpc.getAccountData(route.igpAccount) ?? new Uint8Array(),
+ *   destinationDomain: route.destinationDomain,
+ *   gasAmount: BigInt(route.destinationGasAmount),
+ * })
+ */
+declare function quoteIgpGasPayment(params: {
+    igpAccountData: Uint8Array;
+    destinationDomain: number;
+    gasAmount: bigint;
+}): bigint;
+
+export { type BuildTransferRemoteParameters, type SolanaAccountMeta, buildTransferRemoteInstruction, loadKit, quoteIgpGasPayment };

package/dist/solana/index.js

@@ -0,0 +1,15 @@
+import {
+  DEFAULT_SOLANA_RPC_URL,
+  buildTransferRemoteInstruction,
+  createSolanaRpcClient,
+  loadKit,
+  quoteIgpGasPayment
+} from "../chunk-OU6GVGG7.js";
+export {
+  DEFAULT_SOLANA_RPC_URL,
+  buildTransferRemoteInstruction,
+  createSolanaRpcClient,
+  loadKit,
+  quoteIgpGasPayment
+};
+//# sourceMappingURL=index.js.map

package/dist/solana/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}