boing-sdk 0.3.0

package/dist/nativeDexDirectoryApi.js

@@ -0,0 +1,408 @@
+/**
+ * HTTP JSON for the Cloudflare Worker `workers/native-dex-indexer` D1 directory
+ * (`GET /v1/directory/meta`, `GET /v1/directory/pools`). Not Boing JSON-RPC.
+ */
+import { validateHex32 } from './hex.js';
+/** `api` field value on successful directory responses. */
+export const NATIVE_DEX_DIRECTORY_API_ID = 'boing-native-dex-directory/v1';
+/** Bumped when D1 schema or meta semantics change in a breaking way for clients. */
+export const NATIVE_DEX_DIRECTORY_SCHEMA_VERSION = 2;
+export class NativeDexDirectoryHttpError extends Error {
+    constructor(message, status, url, bodySnippet) {
+        super(message);
+        this.status = status;
+        this.url = url;
+        this.bodySnippet = bodySnippet;
+        this.name = 'NativeDexDirectoryHttpError';
+    }
+}
+/** Trim and strip a trailing slash (no path segment — base is worker origin). */
+export function normalizeNativeDexDirectoryWorkerBaseUrl(raw) {
+    return String(raw || '')
+        .trim()
+        .replace(/\/+$/, '');
+}
+function isPlainObject(v) {
+    return v !== null && typeof v === 'object' && !Array.isArray(v);
+}
+function tryParseIndexerPoolRow(o) {
+    if (!isPlainObject(o))
+        return null;
+    try {
+        validateHex32(String(o.poolHex));
+        validateHex32(String(o.tokenAHex));
+        validateHex32(String(o.tokenBHex));
+    }
+    catch {
+        return null;
+    }
+    return o;
+}
+/**
+ * Parse `GET /v1/directory/meta` JSON. Returns `null` if shape is invalid.
+ */
+export function parseNativeDexDirectoryMetaResponse(data) {
+    if (!isPlainObject(data))
+        return null;
+    const api = data.api;
+    if (api !== NATIVE_DEX_DIRECTORY_API_ID)
+        return null;
+    const schemaVersion = data.schemaVersion;
+    if (schemaVersion != null && (typeof schemaVersion !== 'number' || !Number.isFinite(schemaVersion) || schemaVersion < 1)) {
+        return null;
+    }
+    const poolCount = data.poolCount;
+    if (typeof poolCount !== 'number' || !Number.isFinite(poolCount) || poolCount < 0)
+        return null;
+    const latestSyncBatch = data.latestSyncBatch;
+    if (latestSyncBatch != null && typeof latestSyncBatch !== 'string')
+        return null;
+    const eventCount = data.eventCount;
+    if (eventCount != null && (typeof eventCount !== 'number' || !Number.isFinite(eventCount) || eventCount < 0)) {
+        return null;
+    }
+    const indexedTipHeightRaw = data.indexedTipHeight;
+    if (indexedTipHeightRaw != null) {
+        if (typeof indexedTipHeightRaw !== 'number' || !Number.isFinite(indexedTipHeightRaw) || indexedTipHeightRaw < 0) {
+            return null;
+        }
+    }
+    const indexedTipBlockHashRaw = data.indexedTipBlockHash;
+    if (indexedTipBlockHashRaw != null && typeof indexedTipBlockHashRaw !== 'string')
+        return null;
+    if (typeof indexedTipBlockHashRaw === 'string' &&
+        indexedTipBlockHashRaw !== '' &&
+        !/^0x[0-9a-f]{64}$/i.test(indexedTipBlockHashRaw)) {
+        return null;
+    }
+    const out = {
+        api,
+        poolCount,
+        latestSyncBatch: latestSyncBatch ?? null,
+    };
+    if (eventCount != null)
+        out.eventCount = eventCount;
+    if (data.indexedTipHeight !== undefined) {
+        out.indexedTipHeight = indexedTipHeightRaw === null || indexedTipHeightRaw === undefined ? null : indexedTipHeightRaw;
+    }
+    if (indexedTipBlockHashRaw !== undefined) {
+        out.indexedTipBlockHash =
+            indexedTipBlockHashRaw == null || indexedTipBlockHashRaw === ''
+                ? null
+                : indexedTipBlockHashRaw.toLowerCase();
+    }
+    const indexedParentBlockHashRaw = data.indexedParentBlockHash;
+    if (indexedParentBlockHashRaw != null && typeof indexedParentBlockHashRaw !== 'string')
+        return null;
+    if (typeof indexedParentBlockHashRaw === 'string' &&
+        indexedParentBlockHashRaw !== '' &&
+        !/^0x[0-9a-f]{64}$/i.test(indexedParentBlockHashRaw)) {
+        return null;
+    }
+    if (indexedParentBlockHashRaw !== undefined) {
+        out.indexedParentBlockHash =
+            indexedParentBlockHashRaw == null || indexedParentBlockHashRaw === ''
+                ? null
+                : indexedParentBlockHashRaw.toLowerCase();
+    }
+    const nftOwnerRowCount = data.nftOwnerRowCount;
+    if (nftOwnerRowCount != null && (typeof nftOwnerRowCount !== 'number' || !Number.isFinite(nftOwnerRowCount) || nftOwnerRowCount < 0)) {
+        return null;
+    }
+    if (schemaVersion != null)
+        out.schemaVersion = schemaVersion;
+    if (nftOwnerRowCount != null)
+        out.nftOwnerRowCount = nftOwnerRowCount;
+    const receiptLogCount = data.receiptLogCount;
+    if (receiptLogCount != null && (typeof receiptLogCount !== 'number' || !Number.isFinite(receiptLogCount) || receiptLogCount < 0)) {
+        return null;
+    }
+    if (receiptLogCount != null)
+        out.receiptLogCount = receiptLogCount;
+    return out;
+}
+/**
+ * Parse `GET /v1/directory/pools` JSON. Drops pool objects that fail minimal hex validation.
+ */
+export function parseNativeDexDirectoryPoolsPageResponse(data) {
+    if (!isPlainObject(data))
+        return null;
+    const api = data.api;
+    if (api !== NATIVE_DEX_DIRECTORY_API_ID)
+        return null;
+    const limit = data.limit;
+    if (typeof limit !== 'number' || !Number.isFinite(limit) || limit < 1)
+        return null;
+    const cursor = data.cursor;
+    if (cursor != null && typeof cursor !== 'string')
+        return null;
+    const nextCursor = data.nextCursor;
+    if (nextCursor != null && typeof nextCursor !== 'string')
+        return null;
+    const hasMore = data.hasMore;
+    if (typeof hasMore !== 'boolean')
+        return null;
+    const rawPools = data.pools;
+    if (!Array.isArray(rawPools))
+        return null;
+    const pools = [];
+    for (const row of rawPools) {
+        const p = tryParseIndexerPoolRow(row);
+        if (p)
+            pools.push(p);
+    }
+    return {
+        api,
+        limit,
+        cursor: cursor ?? null,
+        nextCursor: nextCursor ?? null,
+        hasMore,
+        pools,
+    };
+}
+const NATIVE_AMM_LOG2_KINDS = new Set(['swap', 'addLiquidity', 'removeLiquidity']);
+function tryParseMaterializedPoolEvent(o) {
+    if (!isPlainObject(o))
+        return null;
+    const kind = o.kind;
+    if (typeof kind !== 'string' || !NATIVE_AMM_LOG2_KINDS.has(kind))
+        return null;
+    const poolHex = String(o.poolHex || '').trim().toLowerCase();
+    if (!/^0x[0-9a-f]{64}$/.test(poolHex))
+        return null;
+    const blockHeight = o.blockHeight;
+    if (typeof blockHeight !== 'number' || !Number.isFinite(blockHeight))
+        return null;
+    const txId = o.txId;
+    if (typeof txId !== 'string' || !txId.trim())
+        return null;
+    const logIndex = o.logIndex;
+    if (typeof logIndex !== 'number' || !Number.isFinite(logIndex))
+        return null;
+    const callerHex = String(o.callerHex || '').trim().toLowerCase();
+    if (!/^0x[0-9a-f]{64}$/.test(callerHex))
+        return null;
+    const blockHashRaw = o.blockHash;
+    let blockHash = null;
+    if (blockHashRaw !== undefined && blockHashRaw !== null) {
+        if (typeof blockHashRaw !== 'string' || (blockHashRaw !== '' && !/^0x[0-9a-f]{64}$/i.test(blockHashRaw))) {
+            return null;
+        }
+        blockHash = blockHashRaw === '' ? null : blockHashRaw.toLowerCase();
+    }
+    const payload = o.payload;
+    if (!isPlainObject(payload))
+        return null;
+    const payloadOut = {};
+    for (const [k, v] of Object.entries(payload)) {
+        if (typeof v !== 'string')
+            return null;
+        payloadOut[k] = v;
+    }
+    return {
+        kind: kind,
+        poolHex,
+        blockHeight: Math.floor(blockHeight),
+        blockHash,
+        txId: txId.trim(),
+        logIndex: Math.floor(logIndex),
+        callerHex,
+        payload: payloadOut,
+    };
+}
+/**
+ * Parse `GET /v1/history/pool/{pool}/events` JSON. Drops malformed event objects.
+ */
+export function parseNativeDexDirectoryPoolEventsPageResponse(data) {
+    if (!isPlainObject(data))
+        return null;
+    const api = data.api;
+    if (api !== NATIVE_DEX_DIRECTORY_API_ID)
+        return null;
+    const poolHex = String(data.poolHex || '').trim().toLowerCase();
+    if (!/^0x[0-9a-f]{64}$/.test(poolHex))
+        return null;
+    const limit = data.limit;
+    if (typeof limit !== 'number' || !Number.isFinite(limit) || limit < 1)
+        return null;
+    const cursor = data.cursor;
+    if (cursor != null && typeof cursor !== 'string')
+        return null;
+    const nextCursor = data.nextCursor;
+    if (nextCursor != null && typeof nextCursor !== 'string')
+        return null;
+    const hasMore = data.hasMore;
+    if (typeof hasMore !== 'boolean')
+        return null;
+    const rawEvents = data.events;
+    if (!Array.isArray(rawEvents))
+        return null;
+    const events = [];
+    for (const row of rawEvents) {
+        const e = tryParseMaterializedPoolEvent(row);
+        if (e)
+            events.push(e);
+    }
+    return {
+        api,
+        poolHex,
+        limit,
+        cursor: cursor ?? null,
+        nextCursor: nextCursor ?? null,
+        hasMore,
+        events,
+    };
+}
+/**
+ * Parse `GET /v1/history/user/{caller}/events` JSON. Drops malformed event objects.
+ */
+export function parseNativeDexDirectoryUserEventsPageResponse(data) {
+    if (!isPlainObject(data))
+        return null;
+    const api = data.api;
+    if (api !== NATIVE_DEX_DIRECTORY_API_ID)
+        return null;
+    const callerHex = String(data.callerHex || '').trim().toLowerCase();
+    if (!/^0x[0-9a-f]{64}$/.test(callerHex))
+        return null;
+    const limit = data.limit;
+    if (typeof limit !== 'number' || !Number.isFinite(limit) || limit < 1)
+        return null;
+    const cursor = data.cursor;
+    if (cursor != null && typeof cursor !== 'string')
+        return null;
+    const nextCursor = data.nextCursor;
+    if (nextCursor != null && typeof nextCursor !== 'string')
+        return null;
+    const hasMore = data.hasMore;
+    if (typeof hasMore !== 'boolean')
+        return null;
+    const rawEvents = data.events;
+    if (!Array.isArray(rawEvents))
+        return null;
+    const events = [];
+    for (const row of rawEvents) {
+        const e = tryParseMaterializedPoolEvent(row);
+        if (e)
+            events.push(e);
+    }
+    return {
+        api,
+        callerHex,
+        limit,
+        cursor: cursor ?? null,
+        nextCursor: nextCursor ?? null,
+        hasMore,
+        events,
+    };
+}
+async function readJsonOrThrow(url, res) {
+    const text = await res.text();
+    let data;
+    try {
+        data = JSON.parse(text);
+    }
+    catch {
+        throw new NativeDexDirectoryHttpError(`Invalid JSON from directory worker`, res.status, url, text.slice(0, 200));
+    }
+    if (!res.ok) {
+        const errMsg = isPlainObject(data) && typeof data.error === 'string' ? data.error : `HTTP ${res.status}`;
+        throw new NativeDexDirectoryHttpError(errMsg, res.status, url, text.slice(0, 200));
+    }
+    return data;
+}
+/**
+ * `GET {baseUrl}/v1/directory/meta`
+ */
+export async function fetchNativeDexDirectoryMeta(baseUrl, init) {
+    const root = normalizeNativeDexDirectoryWorkerBaseUrl(baseUrl);
+    const url = `${root}/v1/directory/meta`;
+    const res = await fetch(url, { ...init, method: 'GET', headers: { Accept: 'application/json', ...init?.headers } });
+    const data = await readJsonOrThrow(url, res);
+    const parsed = parseNativeDexDirectoryMetaResponse(data);
+    if (!parsed) {
+        throw new NativeDexDirectoryHttpError('Unexpected /v1/directory/meta JSON shape', res.status, url);
+    }
+    return parsed;
+}
+/**
+ * `GET {baseUrl}/v1/directory/pools?limit=&cursor=`
+ */
+export async function fetchNativeDexDirectoryPoolsPage(baseUrl, query = {}, init) {
+    const root = normalizeNativeDexDirectoryWorkerBaseUrl(baseUrl);
+    const u = new URL(`${root}/v1/directory/pools`);
+    if (query.limit != null)
+        u.searchParams.set('limit', String(query.limit));
+    if (query.cursor != null && query.cursor !== '')
+        u.searchParams.set('cursor', query.cursor);
+    const url = u.toString();
+    const res = await fetch(url, { ...init, method: 'GET', headers: { Accept: 'application/json', ...init?.headers } });
+    const data = await readJsonOrThrow(url, res);
+    const parsed = parseNativeDexDirectoryPoolsPageResponse(data);
+    if (!parsed) {
+        throw new NativeDexDirectoryHttpError('Unexpected /v1/directory/pools JSON shape', res.status, url);
+    }
+    return parsed;
+}
+/**
+ * `GET {baseUrl}/v1/history/pool/{poolHex}/events?limit=&cursor=`
+ */
+export async function fetchNativeDexDirectoryPoolEventsPage(baseUrl, poolHex32, query = {}, init) {
+    const root = normalizeNativeDexDirectoryWorkerBaseUrl(baseUrl);
+    const pool = validateHex32(String(poolHex32).trim()).toLowerCase();
+    const u = new URL(`${root}/v1/history/pool/${pool}/events`);
+    if (query.limit != null)
+        u.searchParams.set('limit', String(query.limit));
+    if (query.cursor != null && query.cursor !== '')
+        u.searchParams.set('cursor', query.cursor);
+    const url = u.toString();
+    const res = await fetch(url, { ...init, method: 'GET', headers: { Accept: 'application/json', ...init?.headers } });
+    const data = await readJsonOrThrow(url, res);
+    const parsed = parseNativeDexDirectoryPoolEventsPageResponse(data);
+    if (!parsed) {
+        throw new NativeDexDirectoryHttpError('Unexpected pool events JSON shape', res.status, url);
+    }
+    return parsed;
+}
+/**
+ * `GET {baseUrl}/v1/history/user/{callerHex}/events?limit=&cursor=`
+ */
+export async function fetchNativeDexDirectoryUserEventsPage(baseUrl, callerHex32, query = {}, init) {
+    const root = normalizeNativeDexDirectoryWorkerBaseUrl(baseUrl);
+    const caller = validateHex32(String(callerHex32).trim()).toLowerCase();
+    const u = new URL(`${root}/v1/history/user/${caller}/events`);
+    if (query.limit != null)
+        u.searchParams.set('limit', String(query.limit));
+    if (query.cursor != null && query.cursor !== '')
+        u.searchParams.set('cursor', query.cursor);
+    const url = u.toString();
+    const res = await fetch(url, { ...init, method: 'GET', headers: { Accept: 'application/json', ...init?.headers } });
+    const data = await readJsonOrThrow(url, res);
+    const parsed = parseNativeDexDirectoryUserEventsPageResponse(data);
+    if (!parsed) {
+        throw new NativeDexDirectoryHttpError('Unexpected user pool events JSON shape', res.status, url);
+    }
+    return parsed;
+}
+/**
+ * Walk cursor pages until `hasMore` is false or limits hit.
+ */
+export async function collectAllNativeDexDirectoryPools(baseUrl, opts = {}) {
+    const pageLimit = Math.min(100, Math.max(1, opts.pageLimit ?? 100));
+    const maxPools = opts.maxPools ?? Number.POSITIVE_INFINITY;
+    const maxPages = opts.maxPages ?? 10000;
+    const out = [];
+    let cursor;
+    for (let page = 0; page < maxPages; page++) {
+        const pageRes = await fetchNativeDexDirectoryPoolsPage(baseUrl, { limit: pageLimit, cursor: cursor ?? null }, opts.init);
+        for (const p of pageRes.pools) {
+            out.push(p);
+            if (out.length >= maxPools)
+                return out.slice(0, maxPools);
+        }
+        if (!pageRes.hasMore || pageRes.nextCursor == null || pageRes.nextCursor === '')
+            break;
+        cursor = pageRes.nextCursor;
+    }
+    return out;
+}

package/dist/nativeDexFactory.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Native DEX **pair directory** calldata (Boing VM). Matches `boing_execution::native_dex_factory`.
+ * See `docs/NATIVE-DEX-FACTORY.md`.
+ */
+/** `register_pair(token_a, token_b, pool)` — **128** bytes. */
+export declare const SELECTOR_NATIVE_DEX_REGISTER_PAIR = 208;
+/** `pairs_count` — **32** bytes; return data is one word (count in low **8** bytes). */
+export declare const SELECTOR_NATIVE_DEX_PAIRS_COUNT = 209;
+/** `get_pair_at(index)` — **64** bytes; return data is **96** bytes (three account words). */
+export declare const SELECTOR_NATIVE_DEX_GET_PAIR_AT = 210;
+/** Max pairs the on-chain directory stores (`NATIVE_DEX_FACTORY_MAX_PAIRS`). */
+export declare const NATIVE_DEX_FACTORY_MAX_PAIRS = 4096;
+/** `Log3` topic0 hex after `register_pair` (matches Rust `NATIVE_DEX_FACTORY_TOPIC_REGISTER`). */
+export declare const NATIVE_DEX_FACTORY_TOPIC_REGISTER_HEX: string;
+/** CREATE2 salt v1 (hex `0x` + 64 hex chars). */
+export declare const NATIVE_DEX_FACTORY_CREATE2_SALT_V1_HEX: string;
+/** Build `register_pair` calldata bytes. */
+export declare function encodeNativeDexRegisterPairCalldata(tokenAHex32: string, tokenBHex32: string, poolHex32: string): Uint8Array;
+/** `0x`-prefixed hex calldata for RPC / Express. */
+export declare function encodeNativeDexRegisterPairCalldataHex(tokenAHex32: string, tokenBHex32: string, poolHex32: string): string;
+export declare function encodeNativeDexPairsCountCalldata(): Uint8Array;
+export declare function encodeNativeDexPairsCountCalldataHex(): string;
+export declare function encodeNativeDexGetPairAtCalldata(index: number): Uint8Array;
+export declare function encodeNativeDexGetPairAtCalldataHex(index: number): string;
+//# sourceMappingURL=nativeDexFactory.d.ts.map

package/dist/nativeDexFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nativeDexFactory.d.ts","sourceRoot":"","sources":["../src/nativeDexFactory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,+DAA+D;AAC/D,eAAO,MAAM,iCAAiC,MAAO,CAAC;AACtD,wFAAwF;AACxF,eAAO,MAAM,+BAA+B,MAAO,CAAC;AACpD,8FAA8F;AAC9F,eAAO,MAAM,+BAA+B,MAAO,CAAC;AAEpD,gFAAgF;AAChF,eAAO,MAAM,4BAA4B,OAAO,CAAC;AAEjD,kGAAkG;AAClG,eAAO,MAAM,qCAAqC,QAI9C,CAAC;AAEL,iDAAiD;AACjD,eAAO,MAAM,sCAAsC,QAK/C,CAAC;AA4BL,4CAA4C;AAC5C,wBAAgB,mCAAmC,CACjD,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,UAAU,CAKZ;AAED,oDAAoD;AACpD,wBAAgB,sCAAsC,CACpD,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,MAAM,CAER;AAED,wBAAgB,iCAAiC,IAAI,UAAU,CAE9D;AAED,wBAAgB,oCAAoC,IAAI,MAAM,CAE7D;AAED,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAE1E;AAED,wBAAgB,mCAAmC,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzE"}

package/dist/nativeDexFactory.js

@@ -0,0 +1,72 @@
+/**
+ * Native DEX **pair directory** calldata (Boing VM). Matches `boing_execution::native_dex_factory`.
+ * See `docs/NATIVE-DEX-FACTORY.md`.
+ */
+import { bytesToHex, hexToBytes, validateHex32 } from './hex.js';
+/** `register_pair(token_a, token_b, pool)` — **128** bytes. */
+export const SELECTOR_NATIVE_DEX_REGISTER_PAIR = 0xd0;
+/** `pairs_count` — **32** bytes; return data is one word (count in low **8** bytes). */
+export const SELECTOR_NATIVE_DEX_PAIRS_COUNT = 0xd1;
+/** `get_pair_at(index)` — **64** bytes; return data is **96** bytes (three account words). */
+export const SELECTOR_NATIVE_DEX_GET_PAIR_AT = 0xd2;
+/** Max pairs the on-chain directory stores (`NATIVE_DEX_FACTORY_MAX_PAIRS`). */
+export const NATIVE_DEX_FACTORY_MAX_PAIRS = 4096;
+/** `Log3` topic0 hex after `register_pair` (matches Rust `NATIVE_DEX_FACTORY_TOPIC_REGISTER`). */
+export const NATIVE_DEX_FACTORY_TOPIC_REGISTER_HEX = (() => {
+    const u8 = new Uint8Array(32);
+    u8.set(new TextEncoder().encode('BOING_NATIVE_DEX_FACTORY_REG1'));
+    return bytesToHex(u8);
+})();
+/** CREATE2 salt v1 (hex `0x` + 64 hex chars). */
+export const NATIVE_DEX_FACTORY_CREATE2_SALT_V1_HEX = (() => {
+    const u8 = new Uint8Array(32);
+    const s = new TextEncoder().encode('BOING_NATIVEDEX_FACTORY_V1');
+    u8.set(s);
+    return bytesToHex(u8);
+})();
+function selectorWord(selector) {
+    const w = new Uint8Array(32);
+    w[31] = selector & 0xff;
+    return w;
+}
+function u64Word(n) {
+    if (!Number.isInteger(n) || n < 0 || n > Number.MAX_SAFE_INTEGER) {
+        throw new RangeError('index must be a non-negative safe integer');
+    }
+    const w = new Uint8Array(32);
+    new DataView(w.buffer).setBigUint64(24, BigInt(n), false);
+    return w;
+}
+function concatWords(parts) {
+    const n = parts.reduce((a, p) => a + p.length, 0);
+    const out = new Uint8Array(n);
+    let o = 0;
+    for (const p of parts) {
+        out.set(p, o);
+        o += p.length;
+    }
+    return out;
+}
+/** Build `register_pair` calldata bytes. */
+export function encodeNativeDexRegisterPairCalldata(tokenAHex32, tokenBHex32, poolHex32) {
+    const a = hexToBytes(validateHex32(tokenAHex32));
+    const b = hexToBytes(validateHex32(tokenBHex32));
+    const p = hexToBytes(validateHex32(poolHex32));
+    return concatWords([selectorWord(SELECTOR_NATIVE_DEX_REGISTER_PAIR), a, b, p]);
+}
+/** `0x`-prefixed hex calldata for RPC / Express. */
+export function encodeNativeDexRegisterPairCalldataHex(tokenAHex32, tokenBHex32, poolHex32) {
+    return bytesToHex(encodeNativeDexRegisterPairCalldata(tokenAHex32, tokenBHex32, poolHex32));
+}
+export function encodeNativeDexPairsCountCalldata() {
+    return selectorWord(SELECTOR_NATIVE_DEX_PAIRS_COUNT);
+}
+export function encodeNativeDexPairsCountCalldataHex() {
+    return bytesToHex(encodeNativeDexPairsCountCalldata());
+}
+export function encodeNativeDexGetPairAtCalldata(index) {
+    return concatWords([selectorWord(SELECTOR_NATIVE_DEX_GET_PAIR_AT), u64Word(index)]);
+}
+export function encodeNativeDexGetPairAtCalldataHex(index) {
+    return bytesToHex(encodeNativeDexGetPairAtCalldata(index));
+}

package/dist/nativeDexFactoryLogs.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Parse pair-directory **`Log3`** after `register_pair` (`topic0` + token_a + token_b, **data** = pool).
+ * Matches `native_dex_factory::NATIVE_DEX_FACTORY_TOPIC_REGISTER`.
+ */
+import type { ExecutionLog, ExecutionReceipt, RpcLogEntry } from './types.js';
+export type NativeDexFactoryRegisterEvent = {
+    tokenAHex: string;
+    tokenBHex: string;
+    poolHex: string;
+};
+export type NativeDexFactoryRegisterRpcParsed = NativeDexFactoryRegisterEvent & Pick<RpcLogEntry, 'block_height' | 'tx_index' | 'tx_id' | 'log_index' | 'address'>;
+/** True if normalized `topic0` is the factory register topic. */
+export declare function isNativeDexFactoryRegisterTopic0(topic: string): boolean;
+/** `Log3` with known topic0; **data** must be exactly **32** bytes (pool id). */
+export declare function isNativeDexFactoryRegisterLog3Shape(log: Pick<ExecutionLog, 'topics'>): boolean;
+export declare function tryParseNativeDexFactoryRegisterLog3(log: Pick<ExecutionLog, 'topics' | 'data'>): NativeDexFactoryRegisterEvent | null;
+export declare function tryParseNativeDexFactoryRegisterRpcLogEntry(log: RpcLogEntry): NativeDexFactoryRegisterRpcParsed | null;
+export declare function collectNativeDexFactoryRegisterLogsFromReceipt(receipt: ExecutionReceipt): NativeDexFactoryRegisterEvent[];
+//# sourceMappingURL=nativeDexFactoryLogs.d.ts.map

package/dist/nativeDexFactoryLogs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nativeDexFactoryLogs.d.ts","sourceRoot":"","sources":["../src/nativeDexFactoryLogs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAI9E,MAAM,MAAM,6BAA6B,GAAG;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,iCAAiC,GAAG,6BAA6B,GAC3E,IAAI,CAAC,WAAW,EAAE,cAAc,GAAG,UAAU,GAAG,OAAO,GAAG,WAAW,GAAG,SAAS,CAAC,CAAC;AAErF,iEAAiE;AACjE,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAMvE;AAED,iFAAiF;AACjF,wBAAgB,mCAAmC,CAAC,GAAG,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,GAAG,OAAO,CAG9F;AAED,wBAAgB,oCAAoC,CAClD,GAAG,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,GAAG,MAAM,CAAC,GACzC,6BAA6B,GAAG,IAAI,CAYtC;AAED,wBAAgB,2CAA2C,CACzD,GAAG,EAAE,WAAW,GACf,iCAAiC,GAAG,IAAI,CAW1C;AAED,wBAAgB,8CAA8C,CAAC,OAAO,EAAE,gBAAgB,GAAG,6BAA6B,EAAE,CAOzH"}

package/dist/nativeDexFactoryLogs.js

@@ -0,0 +1,61 @@
+/**
+ * Parse pair-directory **`Log3`** after `register_pair` (`topic0` + token_a + token_b, **data** = pool).
+ * Matches `native_dex_factory::NATIVE_DEX_FACTORY_TOPIC_REGISTER`.
+ */
+import { NATIVE_DEX_FACTORY_TOPIC_REGISTER_HEX } from './nativeDexFactory.js';
+import { iterReceiptLogs, normalizeTopicWord } from './receiptLogs.js';
+import { validateHex32 } from './hex.js';
+const T0_REG = normalizeTopicWord(NATIVE_DEX_FACTORY_TOPIC_REGISTER_HEX);
+/** True if normalized `topic0` is the factory register topic. */
+export function isNativeDexFactoryRegisterTopic0(topic) {
+    try {
+        return normalizeTopicWord(topic) === T0_REG;
+    }
+    catch {
+        return false;
+    }
+}
+/** `Log3` with known topic0; **data** must be exactly **32** bytes (pool id). */
+export function isNativeDexFactoryRegisterLog3Shape(log) {
+    if (log.topics.length !== 3)
+        return false;
+    return isNativeDexFactoryRegisterTopic0(log.topics[0]);
+}
+export function tryParseNativeDexFactoryRegisterLog3(log) {
+    try {
+        if (!isNativeDexFactoryRegisterLog3Shape(log))
+            return null;
+        const raw = log.data.trim().replace(/^0x/i, '');
+        if (raw.length < 64)
+            return null;
+        const poolHex = validateHex32(`0x${raw.slice(0, 64)}`);
+        const tokenAHex = validateHex32(log.topics[1]);
+        const tokenBHex = validateHex32(log.topics[2]);
+        return { tokenAHex, tokenBHex, poolHex };
+    }
+    catch {
+        return null;
+    }
+}
+export function tryParseNativeDexFactoryRegisterRpcLogEntry(log) {
+    const p = tryParseNativeDexFactoryRegisterLog3(log);
+    if (!p)
+        return null;
+    return {
+        ...p,
+        block_height: log.block_height,
+        tx_index: log.tx_index,
+        tx_id: log.tx_id,
+        log_index: log.log_index,
+        address: log.address,
+    };
+}
+export function collectNativeDexFactoryRegisterLogsFromReceipt(receipt) {
+    const out = [];
+    for (const { log } of iterReceiptLogs(receipt)) {
+        const p = tryParseNativeDexFactoryRegisterLog3(log);
+        if (p)
+            out.push(p);
+    }
+    return out;
+}

package/dist/nativeDexFactoryPool.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Pair directory contract — access lists, `contract_call` payloads, storage reads.
+ * Matches `boing_execution::native_dex_factory` + `native_dex_factory_count_key`.
+ */
+import type { BoingClient } from './client.js';
+import type { SimulateResult } from './types.js';
+import { type Ed25519SecretKey32 } from './transactionBuilder.js';
+/**
+ * `boing_getContractStorage` key for pair count (`native_dex_factory::native_dex_factory_count_key`).
+ * 16 zero bytes, **`BOINGDEX`** (8 bytes), 4 zero bytes, **`0xffffffff`** (big-endian).
+ */
+export declare const NATIVE_DEX_FACTORY_COUNT_KEY_HEX: `0x${string}424f494e4744455800000000ffffffff`;
+/** `read` / `write`: signer + directory contract (parallel scheduling minimum). */
+export declare function buildNativeDexFactoryAccessList(senderHex32: string, factoryHex32: string): {
+    read: string[];
+    write: string[];
+};
+export declare function buildNativeDexFactoryContractCallTx(senderHex32: string, factoryHex32: string, calldataHex: string): {
+    type: 'contract_call';
+    contract: string;
+    calldata: string;
+    access_list: {
+        read: string[];
+        write: string[];
+    };
+};
+export declare function mergeNativeDexFactoryAccessListWithSimulation(senderHex32: string, factoryHex32: string, sim: SimulateResult): {
+    read: string[];
+    write: string[];
+};
+/** Decode `pairs_count` return data (32-byte word); count is in the low **8** bytes (matches on-chain layout). */
+export declare function decodeNativeDexFactoryPairsCountReturnData(returnDataHex: string): bigint;
+/**
+ * Decode `get_pair_at` return data (**96** bytes = three account words).
+ */
+export declare function decodeNativeDexFactoryGetPairAtReturnData(returnDataHex: string): {
+    tokenAHex: string;
+    tokenBHex: string;
+    poolHex: string;
+};
+/** Read registered pair count from contract storage (no simulation). */
+export declare function fetchNativeDexFactoryPairsCount(client: BoingClient, factoryHex32: string): Promise<bigint>;
+export type FindNativeDexFactoryPoolOptions = {
+    secretKey32: Ed25519SecretKey32;
+    senderHex: string;
+    /**
+     * Max directory indices to simulate (each index = one `boing_simulateTransaction`).
+     * Defaults to **`4096`** (on-chain max). Lower this on slow RPCs.
+     */
+    maxPairsToScan?: number;
+};
+/**
+ * Find a registered pool address for **`(tokenA, tokenB)`** in either order.
+ *
+ * There is no on-chain reverse map; this helper reads **`pairs_count`** from storage, then simulates
+ * **`get_pair_at(i)`** for each index until a matching triplet is found.
+ *
+ * Requires a signer because **`boing_simulateTransaction`** expects a signed tx envelope (same as submit).
+ */
+export declare function findNativeDexFactoryPoolByTokens(client: BoingClient, factoryHex32: string, tokenAHex32: string, tokenBHex32: string, options: FindNativeDexFactoryPoolOptions): Promise<string | null>;
+//# sourceMappingURL=nativeDexFactoryPool.d.ts.map

package/dist/nativeDexFactoryPool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nativeDexFactoryPool.d.ts","sourceRoot":"","sources":["../src/nativeDexFactoryPool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAK/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,yBAAyB,CAAC;AAgBjC;;;GAGG;AACH,eAAO,MAAM,gCAAgC,+CACoB,CAAC;AAElE,mFAAmF;AACnF,wBAAgB,+BAA+B,CAC7C,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB;IAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAIrC;AAED,wBAAgB,mCAAmC,CACjD,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,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,6CAA6C,CAC3D,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,GAAG,EAAE,cAAc,GAClB;IAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAGrC;AAED,kHAAkH;AAClH,wBAAgB,0CAA0C,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAGxF;AAED;;GAEG;AACH,wBAAgB,yCAAyC,CAAC,aAAa,EAAE,MAAM,GAAG;IAChF,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB,CAcA;AAED,wEAAwE;AACxE,wBAAsB,+BAA+B,CACnD,MAAM,EAAE,WAAW,EACnB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CAIjB;AAMD,MAAM,MAAM,+BAA+B,GAAG;IAC5C,WAAW,EAAE,kBAAkB,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAsB,gCAAgC,CACpD,MAAM,EAAE,WAAW,EACnB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,+BAA+B,GACvC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAqCxB"}