boing-sdk 0.3.0

package/dist/nativeDexSeamless.js

@@ -0,0 +1,131 @@
+/**
+ * Copy, preflight, and one-shot tx helpers for native Boing DEX integration.
+ * Reinforces that Boing is **not** a drop-in Uniswap/EVM router and keeps flows **Boing-RPC-only**.
+ */
+import { bytesToHex, validateHex32 } from './hex.js';
+import { encodeNativeAmmSwapCalldata } from './nativeAmm.js';
+import { buildNativeConstantProductContractCallTx, buildNativeDexMultihopRouterContractCallTx, mergeNativeDexMultihopRouterAccessListWithSimulation, } from './nativeAmmPool.js';
+import { encodeNativeDexMultihopRouterCalldata128FromRoute, encodeNativeDexMultihopRouterCalldata160FromRoute, minOutPerHopFromQuotedRouteSlippageBps, uniqueSortedTokenHex32FromCpRoute, } from './nativeDexRouting.js';
+import { assertBoingRpcEnvironment } from './preflightGate.js';
+/** Short line for tooltips / footers. */
+export const BOING_NATIVE_DEX_NOT_EVM_TAGLINE = 'Boing native DEX uses 32-byte account ids, explicit access lists, and VM-specific calldata—not a paste-any-Uniswap-address router.';
+/** Bullet list for onboarding modals or docs snippets. */
+export const BOING_NATIVE_DEX_NOT_EVM_BULLETS = [
+    'Accounts are 32-byte Boing AccountIds (64 hex chars), not 20-byte Ethereum contract addresses.',
+    'Each `contract_call` needs calldata per NATIVE-AMM / NATIVE-DEX specs plus explicit `access_list` read/write sets.',
+    'Pool, factory, multihop router, ledger forwarders, and LP vault/share ids resolve via RPC `end_user` hints, `fetchNativeDexIntegrationDefaults`, env overrides, or CREATE2 prediction—there is no universal router ABI.',
+];
+export function formatBoingNativeDexNotEvmDisclaimer() {
+    const bullets = BOING_NATIVE_DEX_NOT_EVM_BULLETS.map((b) => `• ${b}`).join('\n');
+    return `${BOING_NATIVE_DEX_NOT_EVM_TAGLINE}\n\n${bullets}`;
+}
+/**
+ * Surfaces missing operator hints so UIs can link to ops runbooks instead of failing silently.
+ */
+export function describeNativeDexDefaultGaps(defaults) {
+    const out = [];
+    if (defaults.nativeCpPoolAccountHex == null) {
+        out.push('No resolved native constant-product pool id: set node env BOING_CANONICAL_NATIVE_CP_POOL, use chain 6913 embedded fallback, or pass a pool override in your app.');
+    }
+    if (defaults.nativeDexFactoryAccountHex == null) {
+        out.push('No native DEX factory id: set BOING_CANONICAL_NATIVE_DEX_FACTORY on the node or pass a factory override so directory scans and pair resolution can run.');
+    }
+    if (defaults.nativeDexMultihopSwapRouterAccountHex == null) {
+        out.push('No native multihop swap router id: set BOING_CANONICAL_NATIVE_DEX_MULTIHOP_SWAP_ROUTER, use chain 6913 embedded fallback, or pass a router override to submit bundled multi-pool swaps in one tx.');
+    }
+    return out;
+}
+/** RPC methods a typical native DEX dApp (read + simulate + logs) expects from **boing-node**. */
+export const BOING_NATIVE_DEX_TOOLKIT_RPC_METHODS = [
+    'boing_getNetworkInfo',
+    'boing_simulateTransaction',
+    'boing_getLogs',
+    'boing_getContractStorage',
+];
+/**
+ * {@link assertBoingRpcEnvironment} with {@link BOING_NATIVE_DEX_TOOLKIT_RPC_METHODS}.
+ * Throws {@link BoingRpcPreflightError} when the endpoint is missing methods or failing discovery.
+ */
+export async function assertBoingNativeDexToolkitRpc(client) {
+    return assertBoingRpcEnvironment(client, {
+        requiredMethods: [...BOING_NATIVE_DEX_TOOLKIT_RPC_METHODS],
+    });
+}
+/** User-facing text when {@link assertBoingNativeDexToolkitRpc} fails (QA / pruned / old node). */
+export function formatNativeDexToolkitPreflightForUi(err) {
+    const lines = [
+        'This screen needs a Boing JSON-RPC endpoint that supports simulate, bounded logs, contract storage, and network info.',
+        'Deploy and sensitive paths stay gated by protocol QA—use the SDK preflight helpers and show users a clear review step.',
+        '',
+        ...err.doctor.messages,
+    ];
+    return lines.join('\n');
+}
+/**
+ * One-shot **`contract_call`** object for **`boing_sendTransaction`** / Boing Express: native CP **`swap`** calldata + pool access list.
+ */
+export function buildNativeCpPoolSwapExpressTx(input) {
+    const calldata = bytesToHex(encodeNativeAmmSwapCalldata(input.direction, input.amountIn, input.minOut));
+    return buildNativeConstantProductContractCallTx(input.senderHex32, input.poolHex32, calldata, input.poolAccessListOptions);
+}
+function mergeMultihopPoolAccessListOptions(route, base, includeVenueTokenAccounts) {
+    const fromRoute = includeVenueTokenAccounts ? uniqueSortedTokenHex32FromCpRoute(route) : [];
+    const fromBase = base?.additionalAccountsHex32 ?? [];
+    if (fromRoute.length === 0 && fromBase.length === 0 && !base)
+        return undefined;
+    if (fromRoute.length === 0 && fromBase.length === 0)
+        return base;
+    const set = new Set();
+    for (const x of fromBase)
+        set.add(validateHex32(x).toLowerCase());
+    for (const x of fromRoute)
+        set.add(x);
+    return {
+        ...base,
+        additionalAccountsHex32: [...set].sort(),
+    };
+}
+/**
+ * Recompute **`access_list`** after **`boing_simulateTransaction`** using {@link mergeNativeDexMultihopRouterAccessListWithSimulation}.
+ * **`poolHex32List`** and **`poolAccessListOptions`** should match the pools / extras used to build **`tx`**.
+ */
+export function applyNativeDexMultihopSimulationToContractCallTx(tx, input) {
+    const access_list = mergeNativeDexMultihopRouterAccessListWithSimulation(input.senderHex32, tx.contract, input.poolHex32List, input.sim, input.poolAccessListOptions);
+    return { ...tx, access_list };
+}
+function resolveMultihopMinOutPerHop(route, minOutPerHop, slippageBps) {
+    if (minOutPerHop != null) {
+        if (minOutPerHop.length !== route.hops.length) {
+            throw new RangeError('minOutPerHop length must match route.hops.length');
+        }
+        return [...minOutPerHop];
+    }
+    if (slippageBps !== undefined) {
+        return minOutPerHopFromQuotedRouteSlippageBps(route, slippageBps);
+    }
+    throw new Error('Pass minOutPerHop or slippageBps');
+}
+export function buildNativeDexMultihopSwapExpressTxFromRoute128(input) {
+    if (input.route.hops.length < 2) {
+        throw new RangeError('multihop route must have at least 2 hops');
+    }
+    const minOutPerHop = resolveMultihopMinOutPerHop(input.route, input.minOutPerHop, input.slippageBps);
+    const calldata = bytesToHex(encodeNativeDexMultihopRouterCalldata128FromRoute(input.route, { minOutPerHop }));
+    const pools = input.route.hops.map((h) => h.venue.poolHex);
+    const poolOpts = mergeMultihopPoolAccessListOptions(input.route, input.poolAccessListOptions, input.includeVenueTokenAccounts);
+    return buildNativeDexMultihopRouterContractCallTx(input.senderHex32, input.routerHex32, calldata, pools, poolOpts);
+}
+export function buildNativeDexMultihopSwapExpressTxFromRoute160(input) {
+    if (input.route.hops.length < 2) {
+        throw new RangeError('multihop route must have at least 2 hops');
+    }
+    const minOutPerHop = resolveMultihopMinOutPerHop(input.route, input.minOutPerHop, input.slippageBps);
+    const calldata = bytesToHex(encodeNativeDexMultihopRouterCalldata160FromRoute(input.route, {
+        minOutPerHop,
+        routerAccountHex32: input.routerHex32,
+        finalRecipientHex32: input.finalRecipientHex32,
+    }));
+    const pools = input.route.hops.map((h) => h.venue.poolHex);
+    const poolOpts = mergeMultihopPoolAccessListOptions(input.route, input.poolAccessListOptions, input.includeVenueTokenAccounts);
+    return buildNativeDexMultihopRouterContractCallTx(input.senderHex32, input.routerHex32, calldata, pools, poolOpts);
+}

package/dist/nativeDexSwap2Router.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Multihop swap router: **2–6** sequential pool `Call`s in one transaction.
+ * Matches `boing_execution::native_dex_multihop_swap_router`. See `docs/NATIVE-DEX-MULTIHOP-SWAP-ROUTER.md`.
+ */
+/** **352-byte** outer calldata; **128-byte** inners (v1/v3 `swap`). */
+export declare const SELECTOR_NATIVE_DEX_SWAP2_ROUTER_128 = 229;
+/** **416-byte** outer calldata; **160-byte** inners (v5 `swap_to`). */
+export declare const SELECTOR_NATIVE_DEX_SWAP2_ROUTER_160 = 230;
+/** **512-byte** outer; **128-byte** inners. */
+export declare const SELECTOR_NATIVE_DEX_SWAP3_ROUTER_128 = 231;
+/** **608-byte** outer; **160-byte** inners. */
+export declare const SELECTOR_NATIVE_DEX_SWAP3_ROUTER_160 = 232;
+/** **672-byte** outer; **128-byte** inners. */
+export declare const SELECTOR_NATIVE_DEX_SWAP4_ROUTER_128 = 233;
+/** **800-byte** outer; **160-byte** inners. */
+export declare const SELECTOR_NATIVE_DEX_SWAP4_ROUTER_160 = 234;
+/** **832-byte** outer; **128-byte** inners. */
+export declare const SELECTOR_NATIVE_DEX_SWAP5_ROUTER_128 = 235;
+/** **992-byte** outer; **160-byte** inners. */
+export declare const SELECTOR_NATIVE_DEX_SWAP5_ROUTER_160 = 236;
+/** **992-byte** outer; **128-byte** inners. */
+export declare const SELECTOR_NATIVE_DEX_SWAP6_ROUTER_128 = 237;
+/** **1184-byte** outer; **160-byte** inners. */
+export declare const SELECTOR_NATIVE_DEX_SWAP6_ROUTER_160 = 238;
+export declare function encodeNativeDexSwap2RouterCalldata128(pool1Hex32: string, inner1_128: Uint8Array, pool2Hex32: string, inner2_128: Uint8Array): Uint8Array;
+export declare function encodeNativeDexSwap2RouterCalldata128Hex(pool1Hex32: string, inner1_128: Uint8Array, pool2Hex32: string, inner2_128: Uint8Array): string;
+export declare function encodeNativeDexSwap2RouterCalldata160(pool1Hex32: string, inner1_160: Uint8Array, pool2Hex32: string, inner2_160: Uint8Array): Uint8Array;
+export declare function encodeNativeDexSwap2RouterCalldata160Hex(pool1Hex32: string, inner1_160: Uint8Array, pool2Hex32: string, inner2_160: Uint8Array): string;
+export declare function encodeNativeDexSwap3RouterCalldata128(pool1Hex32: string, inner1_128: Uint8Array, pool2Hex32: string, inner2_128: Uint8Array, pool3Hex32: string, inner3_128: Uint8Array): Uint8Array;
+export declare function encodeNativeDexSwap3RouterCalldata128Hex(pool1Hex32: string, inner1_128: Uint8Array, pool2Hex32: string, inner2_128: Uint8Array, pool3Hex32: string, inner3_128: Uint8Array): string;
+export declare function encodeNativeDexSwap3RouterCalldata160(pool1Hex32: string, inner1_160: Uint8Array, pool2Hex32: string, inner2_160: Uint8Array, pool3Hex32: string, inner3_160: Uint8Array): Uint8Array;
+export declare function encodeNativeDexSwap3RouterCalldata160Hex(pool1Hex32: string, inner1_160: Uint8Array, pool2Hex32: string, inner2_160: Uint8Array, pool3Hex32: string, inner3_160: Uint8Array): string;
+export declare function encodeNativeDexSwap4RouterCalldata128(pool1Hex32: string, inner1_128: Uint8Array, pool2Hex32: string, inner2_128: Uint8Array, pool3Hex32: string, inner3_128: Uint8Array, pool4Hex32: string, inner4_128: Uint8Array): Uint8Array;
+export declare function encodeNativeDexSwap4RouterCalldata128Hex(pool1Hex32: string, inner1_128: Uint8Array, pool2Hex32: string, inner2_128: Uint8Array, pool3Hex32: string, inner3_128: Uint8Array, pool4Hex32: string, inner4_128: Uint8Array): string;
+export declare function encodeNativeDexSwap4RouterCalldata160(pool1Hex32: string, inner1_160: Uint8Array, pool2Hex32: string, inner2_160: Uint8Array, pool3Hex32: string, inner3_160: Uint8Array, pool4Hex32: string, inner4_160: Uint8Array): Uint8Array;
+export declare function encodeNativeDexSwap4RouterCalldata160Hex(pool1Hex32: string, inner1_160: Uint8Array, pool2Hex32: string, inner2_160: Uint8Array, pool3Hex32: string, inner3_160: Uint8Array, pool4Hex32: string, inner4_160: Uint8Array): string;
+export declare function encodeNativeDexSwap5RouterCalldata128(pool1Hex32: string, inner1_128: Uint8Array, pool2Hex32: string, inner2_128: Uint8Array, pool3Hex32: string, inner3_128: Uint8Array, pool4Hex32: string, inner4_128: Uint8Array, pool5Hex32: string, inner5_128: Uint8Array): Uint8Array;
+export declare function encodeNativeDexSwap5RouterCalldata128Hex(pool1Hex32: string, inner1_128: Uint8Array, pool2Hex32: string, inner2_128: Uint8Array, pool3Hex32: string, inner3_128: Uint8Array, pool4Hex32: string, inner4_128: Uint8Array, pool5Hex32: string, inner5_128: Uint8Array): string;
+export declare function encodeNativeDexSwap5RouterCalldata160(pool1Hex32: string, inner1_160: Uint8Array, pool2Hex32: string, inner2_160: Uint8Array, pool3Hex32: string, inner3_160: Uint8Array, pool4Hex32: string, inner4_160: Uint8Array, pool5Hex32: string, inner5_160: Uint8Array): Uint8Array;
+export declare function encodeNativeDexSwap5RouterCalldata160Hex(pool1Hex32: string, inner1_160: Uint8Array, pool2Hex32: string, inner2_160: Uint8Array, pool3Hex32: string, inner3_160: Uint8Array, pool4Hex32: string, inner4_160: Uint8Array, pool5Hex32: string, inner5_160: Uint8Array): string;
+export declare function encodeNativeDexSwap6RouterCalldata128(pool1Hex32: string, inner1_128: Uint8Array, pool2Hex32: string, inner2_128: Uint8Array, pool3Hex32: string, inner3_128: Uint8Array, pool4Hex32: string, inner4_128: Uint8Array, pool5Hex32: string, inner5_128: Uint8Array, pool6Hex32: string, inner6_128: Uint8Array): Uint8Array;
+export declare function encodeNativeDexSwap6RouterCalldata128Hex(pool1Hex32: string, inner1_128: Uint8Array, pool2Hex32: string, inner2_128: Uint8Array, pool3Hex32: string, inner3_128: Uint8Array, pool4Hex32: string, inner4_128: Uint8Array, pool5Hex32: string, inner5_128: Uint8Array, pool6Hex32: string, inner6_128: Uint8Array): string;
+export declare function encodeNativeDexSwap6RouterCalldata160(pool1Hex32: string, inner1_160: Uint8Array, pool2Hex32: string, inner2_160: Uint8Array, pool3Hex32: string, inner3_160: Uint8Array, pool4Hex32: string, inner4_160: Uint8Array, pool5Hex32: string, inner5_160: Uint8Array, pool6Hex32: string, inner6_160: Uint8Array): Uint8Array;
+export declare function encodeNativeDexSwap6RouterCalldata160Hex(pool1Hex32: string, inner1_160: Uint8Array, pool2Hex32: string, inner2_160: Uint8Array, pool3Hex32: string, inner3_160: Uint8Array, pool4Hex32: string, inner4_160: Uint8Array, pool5Hex32: string, inner5_160: Uint8Array, pool6Hex32: string, inner6_160: Uint8Array): string;
+//# sourceMappingURL=nativeDexSwap2Router.d.ts.map

package/dist/nativeDexSwap2Router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nativeDexSwap2Router.d.ts","sourceRoot":"","sources":["../src/nativeDexSwap2Router.ts"],"names":[],"mappings":"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"}

package/dist/nativeDexSwap2Router.js

@@ -0,0 +1,276 @@
+/**
+ * Multihop swap router: **2–6** sequential pool `Call`s in one transaction.
+ * Matches `boing_execution::native_dex_multihop_swap_router`. See `docs/NATIVE-DEX-MULTIHOP-SWAP-ROUTER.md`.
+ */
+import { bytesToHex, hexToBytes, validateHex32 } from './hex.js';
+/** **352-byte** outer calldata; **128-byte** inners (v1/v3 `swap`). */
+export const SELECTOR_NATIVE_DEX_SWAP2_ROUTER_128 = 0xe5;
+/** **416-byte** outer calldata; **160-byte** inners (v5 `swap_to`). */
+export const SELECTOR_NATIVE_DEX_SWAP2_ROUTER_160 = 0xe6;
+/** **512-byte** outer; **128-byte** inners. */
+export const SELECTOR_NATIVE_DEX_SWAP3_ROUTER_128 = 0xe7;
+/** **608-byte** outer; **160-byte** inners. */
+export const SELECTOR_NATIVE_DEX_SWAP3_ROUTER_160 = 0xe8;
+/** **672-byte** outer; **128-byte** inners. */
+export const SELECTOR_NATIVE_DEX_SWAP4_ROUTER_128 = 0xe9;
+/** **800-byte** outer; **160-byte** inners. */
+export const SELECTOR_NATIVE_DEX_SWAP4_ROUTER_160 = 0xea;
+/** **832-byte** outer; **128-byte** inners. */
+export const SELECTOR_NATIVE_DEX_SWAP5_ROUTER_128 = 0xeb;
+/** **992-byte** outer; **160-byte** inners. */
+export const SELECTOR_NATIVE_DEX_SWAP5_ROUTER_160 = 0xec;
+/** **992-byte** outer; **128-byte** inners. */
+export const SELECTOR_NATIVE_DEX_SWAP6_ROUTER_128 = 0xed;
+/** **1184-byte** outer; **160-byte** inners. */
+export const SELECTOR_NATIVE_DEX_SWAP6_ROUTER_160 = 0xee;
+function selectorWord(selector) {
+    const w = new Uint8Array(32);
+    w[31] = selector & 0xff;
+    return w;
+}
+export function encodeNativeDexSwap2RouterCalldata128(pool1Hex32, inner1_128, pool2Hex32, inner2_128) {
+    if (inner1_128.length !== 128 || inner2_128.length !== 128) {
+        throw new Error('inner calldata must be 128 bytes per hop');
+    }
+    const p1 = hexToBytes(validateHex32(pool1Hex32));
+    const p2 = hexToBytes(validateHex32(pool2Hex32));
+    const out = new Uint8Array(352);
+    out.set(selectorWord(SELECTOR_NATIVE_DEX_SWAP2_ROUTER_128));
+    out.set(p1, 32);
+    out.set(inner1_128, 64);
+    out.set(p2, 192);
+    out.set(inner2_128, 224);
+    return out;
+}
+export function encodeNativeDexSwap2RouterCalldata128Hex(pool1Hex32, inner1_128, pool2Hex32, inner2_128) {
+    return bytesToHex(encodeNativeDexSwap2RouterCalldata128(pool1Hex32, inner1_128, pool2Hex32, inner2_128));
+}
+export function encodeNativeDexSwap2RouterCalldata160(pool1Hex32, inner1_160, pool2Hex32, inner2_160) {
+    if (inner1_160.length !== 160 || inner2_160.length !== 160) {
+        throw new Error('inner calldata must be 160 bytes per hop');
+    }
+    const p1 = hexToBytes(validateHex32(pool1Hex32));
+    const p2 = hexToBytes(validateHex32(pool2Hex32));
+    const out = new Uint8Array(416);
+    out.set(selectorWord(SELECTOR_NATIVE_DEX_SWAP2_ROUTER_160));
+    out.set(p1, 32);
+    out.set(inner1_160, 64);
+    out.set(p2, 224);
+    out.set(inner2_160, 256);
+    return out;
+}
+export function encodeNativeDexSwap2RouterCalldata160Hex(pool1Hex32, inner1_160, pool2Hex32, inner2_160) {
+    return bytesToHex(encodeNativeDexSwap2RouterCalldata160(pool1Hex32, inner1_160, pool2Hex32, inner2_160));
+}
+export function encodeNativeDexSwap3RouterCalldata128(pool1Hex32, inner1_128, pool2Hex32, inner2_128, pool3Hex32, inner3_128) {
+    for (const inner of [inner1_128, inner2_128, inner3_128]) {
+        if (inner.length !== 128) {
+            throw new Error('inner calldata must be 128 bytes per hop');
+        }
+    }
+    const p1 = hexToBytes(validateHex32(pool1Hex32));
+    const p2 = hexToBytes(validateHex32(pool2Hex32));
+    const p3 = hexToBytes(validateHex32(pool3Hex32));
+    const out = new Uint8Array(512);
+    out.set(selectorWord(SELECTOR_NATIVE_DEX_SWAP3_ROUTER_128));
+    out.set(p1, 32);
+    out.set(inner1_128, 64);
+    out.set(p2, 192);
+    out.set(inner2_128, 224);
+    out.set(p3, 352);
+    out.set(inner3_128, 384);
+    return out;
+}
+export function encodeNativeDexSwap3RouterCalldata128Hex(pool1Hex32, inner1_128, pool2Hex32, inner2_128, pool3Hex32, inner3_128) {
+    return bytesToHex(encodeNativeDexSwap3RouterCalldata128(pool1Hex32, inner1_128, pool2Hex32, inner2_128, pool3Hex32, inner3_128));
+}
+export function encodeNativeDexSwap3RouterCalldata160(pool1Hex32, inner1_160, pool2Hex32, inner2_160, pool3Hex32, inner3_160) {
+    for (const inner of [inner1_160, inner2_160, inner3_160]) {
+        if (inner.length !== 160) {
+            throw new Error('inner calldata must be 160 bytes per hop');
+        }
+    }
+    const p1 = hexToBytes(validateHex32(pool1Hex32));
+    const p2 = hexToBytes(validateHex32(pool2Hex32));
+    const p3 = hexToBytes(validateHex32(pool3Hex32));
+    const out = new Uint8Array(608);
+    out.set(selectorWord(SELECTOR_NATIVE_DEX_SWAP3_ROUTER_160));
+    out.set(p1, 32);
+    out.set(inner1_160, 64);
+    out.set(p2, 224);
+    out.set(inner2_160, 256);
+    out.set(p3, 416);
+    out.set(inner3_160, 448);
+    return out;
+}
+export function encodeNativeDexSwap3RouterCalldata160Hex(pool1Hex32, inner1_160, pool2Hex32, inner2_160, pool3Hex32, inner3_160) {
+    return bytesToHex(encodeNativeDexSwap3RouterCalldata160(pool1Hex32, inner1_160, pool2Hex32, inner2_160, pool3Hex32, inner3_160));
+}
+export function encodeNativeDexSwap4RouterCalldata128(pool1Hex32, inner1_128, pool2Hex32, inner2_128, pool3Hex32, inner3_128, pool4Hex32, inner4_128) {
+    for (const inner of [inner1_128, inner2_128, inner3_128, inner4_128]) {
+        if (inner.length !== 128) {
+            throw new Error('inner calldata must be 128 bytes per hop');
+        }
+    }
+    const p1 = hexToBytes(validateHex32(pool1Hex32));
+    const p2 = hexToBytes(validateHex32(pool2Hex32));
+    const p3 = hexToBytes(validateHex32(pool3Hex32));
+    const p4 = hexToBytes(validateHex32(pool4Hex32));
+    const out = new Uint8Array(672);
+    out.set(selectorWord(SELECTOR_NATIVE_DEX_SWAP4_ROUTER_128));
+    out.set(p1, 32);
+    out.set(inner1_128, 64);
+    out.set(p2, 192);
+    out.set(inner2_128, 224);
+    out.set(p3, 352);
+    out.set(inner3_128, 384);
+    out.set(p4, 512);
+    out.set(inner4_128, 544);
+    return out;
+}
+export function encodeNativeDexSwap4RouterCalldata128Hex(pool1Hex32, inner1_128, pool2Hex32, inner2_128, pool3Hex32, inner3_128, pool4Hex32, inner4_128) {
+    return bytesToHex(encodeNativeDexSwap4RouterCalldata128(pool1Hex32, inner1_128, pool2Hex32, inner2_128, pool3Hex32, inner3_128, pool4Hex32, inner4_128));
+}
+export function encodeNativeDexSwap4RouterCalldata160(pool1Hex32, inner1_160, pool2Hex32, inner2_160, pool3Hex32, inner3_160, pool4Hex32, inner4_160) {
+    for (const inner of [inner1_160, inner2_160, inner3_160, inner4_160]) {
+        if (inner.length !== 160) {
+            throw new Error('inner calldata must be 160 bytes per hop');
+        }
+    }
+    const p1 = hexToBytes(validateHex32(pool1Hex32));
+    const p2 = hexToBytes(validateHex32(pool2Hex32));
+    const p3 = hexToBytes(validateHex32(pool3Hex32));
+    const p4 = hexToBytes(validateHex32(pool4Hex32));
+    const out = new Uint8Array(800);
+    out.set(selectorWord(SELECTOR_NATIVE_DEX_SWAP4_ROUTER_160));
+    out.set(p1, 32);
+    out.set(inner1_160, 64);
+    out.set(p2, 224);
+    out.set(inner2_160, 256);
+    out.set(p3, 416);
+    out.set(inner3_160, 448);
+    out.set(p4, 608);
+    out.set(inner4_160, 640);
+    return out;
+}
+export function encodeNativeDexSwap4RouterCalldata160Hex(pool1Hex32, inner1_160, pool2Hex32, inner2_160, pool3Hex32, inner3_160, pool4Hex32, inner4_160) {
+    return bytesToHex(encodeNativeDexSwap4RouterCalldata160(pool1Hex32, inner1_160, pool2Hex32, inner2_160, pool3Hex32, inner3_160, pool4Hex32, inner4_160));
+}
+export function encodeNativeDexSwap5RouterCalldata128(pool1Hex32, inner1_128, pool2Hex32, inner2_128, pool3Hex32, inner3_128, pool4Hex32, inner4_128, pool5Hex32, inner5_128) {
+    for (const inner of [inner1_128, inner2_128, inner3_128, inner4_128, inner5_128]) {
+        if (inner.length !== 128) {
+            throw new Error('inner calldata must be 128 bytes per hop');
+        }
+    }
+    const p1 = hexToBytes(validateHex32(pool1Hex32));
+    const p2 = hexToBytes(validateHex32(pool2Hex32));
+    const p3 = hexToBytes(validateHex32(pool3Hex32));
+    const p4 = hexToBytes(validateHex32(pool4Hex32));
+    const p5 = hexToBytes(validateHex32(pool5Hex32));
+    const out = new Uint8Array(832);
+    out.set(selectorWord(SELECTOR_NATIVE_DEX_SWAP5_ROUTER_128));
+    out.set(p1, 32);
+    out.set(inner1_128, 64);
+    out.set(p2, 192);
+    out.set(inner2_128, 224);
+    out.set(p3, 352);
+    out.set(inner3_128, 384);
+    out.set(p4, 512);
+    out.set(inner4_128, 544);
+    out.set(p5, 672);
+    out.set(inner5_128, 704);
+    return out;
+}
+export function encodeNativeDexSwap5RouterCalldata128Hex(pool1Hex32, inner1_128, pool2Hex32, inner2_128, pool3Hex32, inner3_128, pool4Hex32, inner4_128, pool5Hex32, inner5_128) {
+    return bytesToHex(encodeNativeDexSwap5RouterCalldata128(pool1Hex32, inner1_128, pool2Hex32, inner2_128, pool3Hex32, inner3_128, pool4Hex32, inner4_128, pool5Hex32, inner5_128));
+}
+export function encodeNativeDexSwap5RouterCalldata160(pool1Hex32, inner1_160, pool2Hex32, inner2_160, pool3Hex32, inner3_160, pool4Hex32, inner4_160, pool5Hex32, inner5_160) {
+    for (const inner of [inner1_160, inner2_160, inner3_160, inner4_160, inner5_160]) {
+        if (inner.length !== 160) {
+            throw new Error('inner calldata must be 160 bytes per hop');
+        }
+    }
+    const p1 = hexToBytes(validateHex32(pool1Hex32));
+    const p2 = hexToBytes(validateHex32(pool2Hex32));
+    const p3 = hexToBytes(validateHex32(pool3Hex32));
+    const p4 = hexToBytes(validateHex32(pool4Hex32));
+    const p5 = hexToBytes(validateHex32(pool5Hex32));
+    const out = new Uint8Array(992);
+    out.set(selectorWord(SELECTOR_NATIVE_DEX_SWAP5_ROUTER_160));
+    out.set(p1, 32);
+    out.set(inner1_160, 64);
+    out.set(p2, 224);
+    out.set(inner2_160, 256);
+    out.set(p3, 416);
+    out.set(inner3_160, 448);
+    out.set(p4, 608);
+    out.set(inner4_160, 640);
+    out.set(p5, 800);
+    out.set(inner5_160, 832);
+    return out;
+}
+export function encodeNativeDexSwap5RouterCalldata160Hex(pool1Hex32, inner1_160, pool2Hex32, inner2_160, pool3Hex32, inner3_160, pool4Hex32, inner4_160, pool5Hex32, inner5_160) {
+    return bytesToHex(encodeNativeDexSwap5RouterCalldata160(pool1Hex32, inner1_160, pool2Hex32, inner2_160, pool3Hex32, inner3_160, pool4Hex32, inner4_160, pool5Hex32, inner5_160));
+}
+export function encodeNativeDexSwap6RouterCalldata128(pool1Hex32, inner1_128, pool2Hex32, inner2_128, pool3Hex32, inner3_128, pool4Hex32, inner4_128, pool5Hex32, inner5_128, pool6Hex32, inner6_128) {
+    for (const inner of [inner1_128, inner2_128, inner3_128, inner4_128, inner5_128, inner6_128]) {
+        if (inner.length !== 128) {
+            throw new Error('inner calldata must be 128 bytes per hop');
+        }
+    }
+    const p1 = hexToBytes(validateHex32(pool1Hex32));
+    const p2 = hexToBytes(validateHex32(pool2Hex32));
+    const p3 = hexToBytes(validateHex32(pool3Hex32));
+    const p4 = hexToBytes(validateHex32(pool4Hex32));
+    const p5 = hexToBytes(validateHex32(pool5Hex32));
+    const p6 = hexToBytes(validateHex32(pool6Hex32));
+    const out = new Uint8Array(992);
+    out.set(selectorWord(SELECTOR_NATIVE_DEX_SWAP6_ROUTER_128));
+    out.set(p1, 32);
+    out.set(inner1_128, 64);
+    out.set(p2, 192);
+    out.set(inner2_128, 224);
+    out.set(p3, 352);
+    out.set(inner3_128, 384);
+    out.set(p4, 512);
+    out.set(inner4_128, 544);
+    out.set(p5, 672);
+    out.set(inner5_128, 704);
+    out.set(p6, 832);
+    out.set(inner6_128, 864);
+    return out;
+}
+export function encodeNativeDexSwap6RouterCalldata128Hex(pool1Hex32, inner1_128, pool2Hex32, inner2_128, pool3Hex32, inner3_128, pool4Hex32, inner4_128, pool5Hex32, inner5_128, pool6Hex32, inner6_128) {
+    return bytesToHex(encodeNativeDexSwap6RouterCalldata128(pool1Hex32, inner1_128, pool2Hex32, inner2_128, pool3Hex32, inner3_128, pool4Hex32, inner4_128, pool5Hex32, inner5_128, pool6Hex32, inner6_128));
+}
+export function encodeNativeDexSwap6RouterCalldata160(pool1Hex32, inner1_160, pool2Hex32, inner2_160, pool3Hex32, inner3_160, pool4Hex32, inner4_160, pool5Hex32, inner5_160, pool6Hex32, inner6_160) {
+    for (const inner of [inner1_160, inner2_160, inner3_160, inner4_160, inner5_160, inner6_160]) {
+        if (inner.length !== 160) {
+            throw new Error('inner calldata must be 160 bytes per hop');
+        }
+    }
+    const p1 = hexToBytes(validateHex32(pool1Hex32));
+    const p2 = hexToBytes(validateHex32(pool2Hex32));
+    const p3 = hexToBytes(validateHex32(pool3Hex32));
+    const p4 = hexToBytes(validateHex32(pool4Hex32));
+    const p5 = hexToBytes(validateHex32(pool5Hex32));
+    const p6 = hexToBytes(validateHex32(pool6Hex32));
+    const out = new Uint8Array(1184);
+    out.set(selectorWord(SELECTOR_NATIVE_DEX_SWAP6_ROUTER_160));
+    out.set(p1, 32);
+    out.set(inner1_160, 64);
+    out.set(p2, 224);
+    out.set(inner2_160, 256);
+    out.set(p3, 416);
+    out.set(inner3_160, 448);
+    out.set(p4, 608);
+    out.set(inner4_160, 640);
+    out.set(p5, 800);
+    out.set(inner5_160, 832);
+    out.set(p6, 992);
+    out.set(inner6_160, 1024);
+    return out;
+}
+export function encodeNativeDexSwap6RouterCalldata160Hex(pool1Hex32, inner1_160, pool2Hex32, inner2_160, pool3Hex32, inner3_160, pool4Hex32, inner4_160, pool5Hex32, inner5_160, pool6Hex32, inner6_160) {
+    return bytesToHex(encodeNativeDexSwap6RouterCalldata160(pool1Hex32, inner1_160, pool2Hex32, inner2_160, pool3Hex32, inner3_160, pool4Hex32, inner4_160, pool5Hex32, inner5_160, pool6Hex32, inner6_160));
+}

package/dist/nativeLpShareToken.d.ts

@@ -0,0 +1,54 @@
+/**
+ * LP share token calldata (minter-gated `mint` + `transfer`) + Express / JSON-RPC access lists.
+ * Matches `boing_execution::native_lp_share_token`.
+ * See `docs/NATIVE-LP-SHARE-TOKEN.md`.
+ */
+import type { BoingClient } from './client.js';
+import type { SimulateResult } from './types.js';
+/** `transfer(to, amount)` — **96** bytes. */
+export declare const SELECTOR_LP_SHARE_TRANSFER = 1;
+/** `mint(to, amount)` — **96** bytes; only minter may call. */
+export declare const SELECTOR_LP_SHARE_MINT = 6;
+/** `set_minter_once(minter)` — **64** bytes. */
+export declare const SELECTOR_LP_SHARE_SET_MINTER_ONCE = 7;
+/** Storage key for minter slot (`k[31] == 0xb1`), 32-byte word. */
+export declare const LP_SHARE_MINTER_KEY_U8: Uint8Array;
+/** `boing_getContractStorage` key for LP share **minter** (`native_lp_share_token::LP_SHARE_MINTER_KEY`). */
+export declare const LP_SHARE_MINTER_KEY_HEX: `0x${string}`;
+/**
+ * `boing_getContractStorage` key for **`holder`**'s LP share balance (`account_id ^ LP_SHARE_BALANCE_XOR`).
+ */
+export declare function lpShareTokenBalanceStorageKeyHex(holderHex32: string): string;
+/**
+ * Read **holder**'s LP share balance (u128 in storage word) from the share token contract.
+ */
+export declare function fetchLpShareTokenBalanceRaw(client: BoingClient, shareTokenHex32: string, holderHex32: string): Promise<bigint>;
+/**
+ * Read designated **minter** `AccountId` for the LP share token, or **`null`** if unset (all-zero word).
+ */
+export declare function fetchLpShareTokenMinterAccountHex(client: BoingClient, shareHex32: string): Promise<`0x${string}` | null>;
+export declare function encodeLpShareTransferCalldata(toHex32: string, amount: bigint): Uint8Array;
+export declare function encodeLpShareTransferCalldataHex(toHex32: string, amount: bigint): string;
+export declare function encodeLpShareMintCalldata(toHex32: string, amount: bigint): Uint8Array;
+export declare function encodeLpShareMintCalldataHex(toHex32: string, amount: bigint): string;
+export declare function encodeLpShareSetMinterOnceCalldata(minterHex32: string): Uint8Array;
+export declare function encodeLpShareSetMinterOnceCalldataHex(minterHex32: string): string;
+/** `read` / `write`: signer + share token contract (parallel-scheduling minimum). */
+export declare function buildLpShareTokenAccessList(senderHex32: string, shareTokenHex32: string): {
+    read: string[];
+    write: string[];
+};
+export declare function buildLpShareTokenContractCallTx(senderHex32: string, shareTokenHex32: string, calldataHex: string): {
+    type: 'contract_call';
+    contract: string;
+    calldata: string;
+    access_list: {
+        read: string[];
+        write: string[];
+    };
+};
+export declare function mergeLpShareTokenAccessListWithSimulation(senderHex32: string, shareTokenHex32: string, sim: SimulateResult): {
+    read: string[];
+    write: string[];
+};
+//# sourceMappingURL=nativeLpShareToken.d.ts.map

package/dist/nativeLpShareToken.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nativeLpShareToken.d.ts","sourceRoot":"","sources":["../src/nativeLpShareToken.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,6CAA6C;AAC7C,eAAO,MAAM,0BAA0B,IAAO,CAAC;AAC/C,+DAA+D;AAC/D,eAAO,MAAM,sBAAsB,IAAO,CAAC;AAC3C,gDAAgD;AAChD,eAAO,MAAM,iCAAiC,IAAO,CAAC;AAEtD,mEAAmE;AACnE,eAAO,MAAM,sBAAsB,EAAE,UAIjC,CAAC;AAEL,6GAA6G;AAC7G,eAAO,MAAM,uBAAuB,EAAwD,KAAK,MAAM,EAAE,CAAC;AAS1G;;GAEG;AACH,wBAAgB,gCAAgC,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAQ5E;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,WAAW,EACnB,eAAe,EAAE,MAAM,EACvB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CAKjB;AAED;;GAEG;AACH,wBAAsB,iCAAiC,CACrD,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,KAAK,MAAM,EAAE,GAAG,IAAI,CAAC,CAI/B;AAuBD,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,CAMzF;AAED,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAExF;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,CAMrF;AAED,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEpF;AAED,wBAAgB,kCAAkC,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,CAKlF;AAED,wBAAgB,qCAAqC,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEjF;AAgBD,qFAAqF;AACrF,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,GACtB;IAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAIrC;AAED,wBAAgB,+BAA+B,CAC7C,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,EACvB,WAAW,EAAE,MAAM,GAClB;IACD,IAAI,EAAE,eAAe,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE;QAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAClD,CAOA;AAED,wBAAgB,yCAAyC,CACvD,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,EACvB,GAAG,EAAE,cAAc,GAClB;IAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAGrC"}

package/dist/nativeLpShareToken.js

@@ -0,0 +1,135 @@
+/**
+ * LP share token calldata (minter-gated `mint` + `transfer`) + Express / JSON-RPC access lists.
+ * Matches `boing_execution::native_lp_share_token`.
+ * See `docs/NATIVE-LP-SHARE-TOKEN.md`.
+ */
+import { mergeAccessListWithSimulation } from './accessList.js';
+import { bytesToHex, decodeBoingStorageWordAccountId, ensureHex, hexToBytes, validateHex32 } from './hex.js';
+import { decodeBoingStorageWordU128 } from './nativeAmmPool.js';
+/** `transfer(to, amount)` — **96** bytes. */
+export const SELECTOR_LP_SHARE_TRANSFER = 0x01;
+/** `mint(to, amount)` — **96** bytes; only minter may call. */
+export const SELECTOR_LP_SHARE_MINT = 0x06;
+/** `set_minter_once(minter)` — **64** bytes. */
+export const SELECTOR_LP_SHARE_SET_MINTER_ONCE = 0x07;
+/** Storage key for minter slot (`k[31] == 0xb1`), 32-byte word. */
+export const LP_SHARE_MINTER_KEY_U8 = (() => {
+    const k = new Uint8Array(32);
+    k[31] = 0xb1;
+    return k;
+})();
+/** `boing_getContractStorage` key for LP share **minter** (`native_lp_share_token::LP_SHARE_MINTER_KEY`). */
+export const LP_SHARE_MINTER_KEY_HEX = validateHex32(bytesToHex(LP_SHARE_MINTER_KEY_U8));
+/** XOR mask for balance slots (`native_lp_share_token::LP_SHARE_BALANCE_XOR`): UTF-8 `BOING_LP_SHARE_BAL_V1` zero-padded to 32 bytes. */
+const LP_SHARE_BALANCE_XOR_U8 = (() => {
+    const u8 = new Uint8Array(32);
+    u8.set(new TextEncoder().encode('BOING_LP_SHARE_BAL_V1'));
+    return u8;
+})();
+/**
+ * `boing_getContractStorage` key for **`holder`**'s LP share balance (`account_id ^ LP_SHARE_BALANCE_XOR`).
+ */
+export function lpShareTokenBalanceStorageKeyHex(holderHex32) {
+    const raw = validateHex32(holderHex32).slice(2).toLowerCase();
+    let out = '';
+    for (let i = 0; i < 32; i++) {
+        const b = parseInt(raw.slice(i * 2, i * 2 + 2), 16) ^ LP_SHARE_BALANCE_XOR_U8[i];
+        out += b.toString(16).padStart(2, '0');
+    }
+    return `0x${out}`;
+}
+/**
+ * Read **holder**'s LP share balance (u128 in storage word) from the share token contract.
+ */
+export async function fetchLpShareTokenBalanceRaw(client, shareTokenHex32, holderHex32) {
+    const share = validateHex32(shareTokenHex32);
+    const key = lpShareTokenBalanceStorageKeyHex(holderHex32);
+    const w = await client.getContractStorage(share, key);
+    return decodeBoingStorageWordU128(w.value);
+}
+/**
+ * Read designated **minter** `AccountId` for the LP share token, or **`null`** if unset (all-zero word).
+ */
+export async function fetchLpShareTokenMinterAccountHex(client, shareHex32) {
+    const share = validateHex32(shareHex32);
+    const w = await client.getContractStorage(share, LP_SHARE_MINTER_KEY_HEX);
+    return decodeBoingStorageWordAccountId(w.value);
+}
+function selectorWord(selector) {
+    const w = new Uint8Array(32);
+    w[31] = selector & 0xff;
+    return w;
+}
+function amountWord(amount) {
+    const w = new Uint8Array(32);
+    if (amount < 0n || amount > (1n << 128n) - 1n) {
+        throw new RangeError('amount must fit in u128');
+    }
+    const be = new Uint8Array(16);
+    let x = amount;
+    for (let i = 15; i >= 0; i--) {
+        be[i] = Number(x & 0xffn);
+        x >>= 8n;
+    }
+    w.set(be, 16);
+    return w;
+}
+export function encodeLpShareTransferCalldata(toHex32, amount) {
+    const out = new Uint8Array(96);
+    out.set(selectorWord(SELECTOR_LP_SHARE_TRANSFER));
+    out.set(hexToBytes(validateHex32(toHex32)), 32);
+    out.set(amountWord(amount), 64);
+    return out;
+}
+export function encodeLpShareTransferCalldataHex(toHex32, amount) {
+    return bytesToHex(encodeLpShareTransferCalldata(toHex32, amount));
+}
+export function encodeLpShareMintCalldata(toHex32, amount) {
+    const out = new Uint8Array(96);
+    out.set(selectorWord(SELECTOR_LP_SHARE_MINT));
+    out.set(hexToBytes(validateHex32(toHex32)), 32);
+    out.set(amountWord(amount), 64);
+    return out;
+}
+export function encodeLpShareMintCalldataHex(toHex32, amount) {
+    return bytesToHex(encodeLpShareMintCalldata(toHex32, amount));
+}
+export function encodeLpShareSetMinterOnceCalldata(minterHex32) {
+    const out = new Uint8Array(64);
+    out.set(selectorWord(SELECTOR_LP_SHARE_SET_MINTER_ONCE));
+    out.set(hexToBytes(validateHex32(minterHex32)), 32);
+    return out;
+}
+export function encodeLpShareSetMinterOnceCalldataHex(minterHex32) {
+    return bytesToHex(encodeLpShareSetMinterOnceCalldata(minterHex32));
+}
+const CALldata_HEX_RE = /^[0-9a-fA-F]+$/;
+function normalizeCalldataHex(calldataHex) {
+    const h = ensureHex(calldataHex.trim());
+    const raw = h.slice(2);
+    if (raw.length % 2 !== 0) {
+        throw new Error('calldata must be even-length hex');
+    }
+    if (!CALldata_HEX_RE.test(raw)) {
+        throw new Error('calldata: invalid hex');
+    }
+    return `0x${raw.toLowerCase()}`;
+}
+/** `read` / `write`: signer + share token contract (parallel-scheduling minimum). */
+export function buildLpShareTokenAccessList(senderHex32, shareTokenHex32) {
+    const s = validateHex32(senderHex32).toLowerCase();
+    const c = validateHex32(shareTokenHex32).toLowerCase();
+    return { read: [s, c], write: [s, c] };
+}
+export function buildLpShareTokenContractCallTx(senderHex32, shareTokenHex32, calldataHex) {
+    return {
+        type: 'contract_call',
+        contract: validateHex32(shareTokenHex32).toLowerCase(),
+        calldata: normalizeCalldataHex(calldataHex),
+        access_list: buildLpShareTokenAccessList(senderHex32, shareTokenHex32),
+    };
+}
+export function mergeLpShareTokenAccessListWithSimulation(senderHex32, shareTokenHex32, sim) {
+    const base = buildLpShareTokenAccessList(senderHex32, shareTokenHex32);
+    return mergeAccessListWithSimulation(base.read, base.write, sim);
+}