@geeqdev/geeq-sdk 0.1.0 → 0.2.0

package/dist/src/ledger/params.d.ts

@@ -0,0 +1,34 @@
+import type { ParamAcctRec } from '../capnp/paramAcctRec.capnp';
+import type { GeeqMetadataLimits } from '../types';
+/**
+ * Read the metadata limits a chain publishes in its parameter account list.
+ *
+ * `metadataVarNum` caps the NUMBER of entries and `metadataVarBytes` caps the bytes in
+ * ONE entry; there is no aggregate cap. The node enforces both at submit time, so
+ * having them here is what lets a transaction be rejected before it is signed rather
+ * than after it is sent.
+ *
+ * Returns `undefined` when either parameter is absent. A chain that does not publish
+ * them is a schema difference, not a caller error, so the preflight is skipped and the
+ * node stays the authority.
+ *
+ * `metadataFixedNum` / `metadataFixedBytes` exist in the schema but are read nowhere in
+ * the current node, so they are ignored here too.
+ */
+export declare function readMetadataLimits(records: readonly ParamAcctRec[]): GeeqMetadataLimits | undefined;
+/**
+ * The smallest transfer this chain will accept, in pennies: `minTxAmt × geeqNorm + 1`.
+ *
+ * The node rejects anything below `minTxAmt × geeqNorm` (geeq_node_core, Transaction
+ * Amount Conformity); the Geeq wallet asks for one penny more, and so does this. Knowing
+ * it here turns a rejected transaction into a message before it is signed.
+ *
+ * Returns `undefined` when either parameter is missing, in which case nothing is checked
+ * and the node stays the authority.
+ */
+export declare function readMinimumTransfer(records: readonly ParamAcctRec[]): bigint | undefined;
+/**
+ * The chain's `geeqNorm` parameter: the multiplier behind its minimum transfer and every
+ * fee. `undefined` when the chain does not publish it.
+ */
+export declare function readGeeqNorm(records: readonly ParamAcctRec[]): bigint | undefined;

package/dist/src/ledger/params.js

@@ -0,0 +1,71 @@
+import { uint64ToPennies } from '../amount';
+/**
+ * Read the metadata limits a chain publishes in its parameter account list.
+ *
+ * `metadataVarNum` caps the NUMBER of entries and `metadataVarBytes` caps the bytes in
+ * ONE entry; there is no aggregate cap. The node enforces both at submit time, so
+ * having them here is what lets a transaction be rejected before it is signed rather
+ * than after it is sent.
+ *
+ * Returns `undefined` when either parameter is absent. A chain that does not publish
+ * them is a schema difference, not a caller error, so the preflight is skipped and the
+ * node stays the authority.
+ *
+ * `metadataFixedNum` / `metadataFixedBytes` exist in the schema but are read nowhere in
+ * the current node, so they are ignored here too.
+ */
+export function readMetadataLimits(records) {
+    let maxEntries;
+    let maxBytesPerEntry;
+    for (const record of records) {
+        const param = record.getParamType();
+        if (maxEntries === undefined && param.isMetadataVarNum() && param.hasMetadataVarNum()) {
+            maxEntries = param.getMetadataVarNum().getCurrentValue();
+            continue;
+        }
+        if (maxBytesPerEntry === undefined &&
+            param.isMetadataVarBytes() &&
+            param.hasMetadataVarBytes()) {
+            maxBytesPerEntry = param.getMetadataVarBytes().getCurrentValue();
+        }
+    }
+    if (maxEntries === undefined || maxBytesPerEntry === undefined)
+        return undefined;
+    return Object.freeze({ maxEntries, maxBytesPerEntry });
+}
+/**
+ * The smallest transfer this chain will accept, in pennies: `minTxAmt × geeqNorm + 1`.
+ *
+ * The node rejects anything below `minTxAmt × geeqNorm` (geeq_node_core, Transaction
+ * Amount Conformity); the Geeq wallet asks for one penny more, and so does this. Knowing
+ * it here turns a rejected transaction into a message before it is signed.
+ *
+ * Returns `undefined` when either parameter is missing, in which case nothing is checked
+ * and the node stays the authority.
+ */
+export function readMinimumTransfer(records) {
+    const geeqNorm = readGeeqNorm(records);
+    for (const record of records) {
+        const param = record.getParamType();
+        if (param.isMinTxAmt() && param.hasMinTxAmt()) {
+            if (geeqNorm === undefined)
+                return undefined;
+            return uint64ToPennies(param.getMinTxAmt().getCurrentValue()) * geeqNorm + 1n;
+        }
+    }
+    return undefined;
+}
+/**
+ * The chain's `geeqNorm` parameter: the multiplier behind its minimum transfer and every
+ * fee. `undefined` when the chain does not publish it.
+ */
+export function readGeeqNorm(records) {
+    for (const record of records) {
+        const param = record.getParamType();
+        if (param.isGeeqNorm() && param.hasGeeqNorm()) {
+            return uint64ToPennies(param.getGeeqNorm().getCurrentValue());
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=params.js.map

package/dist/src/ledger/params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"params.js","sourceRoot":"","sources":["../../../src/ledger/params.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAG3C;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAgC;IAEhC,IAAI,UAA8B,CAAA;IAClC,IAAI,gBAAoC,CAAA;IAExC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,YAAY,EAAE,CAAA;QACnC,IAAI,UAAU,KAAK,SAAS,IAAI,KAAK,CAAC,gBAAgB,EAAE,IAAI,KAAK,CAAC,iBAAiB,EAAE,EAAE,CAAC;YACtF,UAAU,GAAG,KAAK,CAAC,iBAAiB,EAAE,CAAC,eAAe,EAAE,CAAA;YACxD,SAAQ;QACV,CAAC;QACD,IACE,gBAAgB,KAAK,SAAS;YAC9B,KAAK,CAAC,kBAAkB,EAAE;YAC1B,KAAK,CAAC,mBAAmB,EAAE,EAC3B,CAAC;YACD,gBAAgB,GAAG,KAAK,CAAC,mBAAmB,EAAE,CAAC,eAAe,EAAE,CAAA;QAClE,CAAC;IACH,CAAC;IAED,IAAI,UAAU,KAAK,SAAS,IAAI,gBAAgB,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IAChF,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,gBAAgB,EAAE,CAAC,CAAA;AACxD,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAgC;IAEhC,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,CAAA;IACtC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,YAAY,EAAE,CAAA;QACnC,IAAI,KAAK,CAAC,UAAU,EAAE,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YAC9C,IAAI,QAAQ,KAAK,SAAS;gBAAE,OAAO,SAAS,CAAA;YAC5C,OAAO,eAAe,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,eAAe,EAAE,CAAC,GAAG,QAAQ,GAAG,EAAE,CAAA;QAC/E,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,OAAgC;IAC3D,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,YAAY,EAAE,CAAA;QACnC,IAAI,KAAK,CAAC,UAAU,EAAE,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YAC9C,OAAO,eAAe,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,eAAe,EAAE,CAAC,CAAA;QAC/D,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC"}

package/dist/src/ledger/proxy-accounts.d.ts

@@ -0,0 +1,26 @@
+import type { ProxyAcctRec } from '../capnp/proxyAcctRec.capnp';
+/** Which kind of proxy a record is. Only `'nft-mint'` is read further. */
+export type GeeqProxyKind = 'nft-mint' | 'token-mint' | 'funding' | 'multisig' | 'dce' | 'unknown';
+/** One proxy account record, as plain values. */
+export interface GeeqProxyAccount {
+    readonly accountId: Uint8Array;
+    readonly kind: GeeqProxyKind;
+    /**
+     * The proxy's own nonce. A mint through it spends this one, not the admin's — a proxy
+     * carries its nonce on the record itself.
+     */
+    readonly nonce: number;
+    /** Balance in pennies. Use `formatGeeq` to show it. */
+    readonly balance: bigint;
+    /** The account id of the only key that can sign for it. Read for NFT mint proxies only. */
+    readonly admin: Uint8Array | undefined;
+}
+/** What we keep per proxy. The id is the map key, so it is not repeated here. */
+export type ProxyAccountFacts = Omit<GeeqProxyAccount, 'accountId'>;
+/**
+ * Read a proxy record's kind and admin.
+ *
+ * The same zero-value trap as a coin account: `DCE` is the union's zero value, so every
+ * arm is checked with `isX()` before anything is read from it.
+ */
+export declare function readProxyAccount(record: ProxyAcctRec): ProxyAccountFacts;

package/dist/src/ledger/proxy-accounts.js

@@ -0,0 +1,27 @@
+import { uint64ToPennies } from '../amount';
+/**
+ * Read a proxy record's kind and admin.
+ *
+ * The same zero-value trap as a coin account: `DCE` is the union's zero value, so every
+ * arm is checked with `isX()` before anything is read from it.
+ */
+export function readProxyAccount(record) {
+    const recType = record.getRecType();
+    const nonce = record.getNonce();
+    const balance = uint64ToPennies(record.getAmtCoin());
+    if (recType.isNftMint() && recType.hasNftMint()) {
+        const admin = new Uint8Array(recType.getNftMint().getAcctNumAdminUser().toArrayBuffer());
+        return { kind: 'nft-mint', nonce, balance, admin };
+    }
+    const kind = recType.isTokenMint()
+        ? 'token-mint'
+        : recType.isFunding()
+            ? 'funding'
+            : recType.isMultisig()
+                ? 'multisig'
+                : recType.isDce() && recType.hasDce()
+                    ? 'dce'
+                    : 'unknown';
+    return { kind, nonce, balance, admin: undefined };
+}
+//# sourceMappingURL=proxy-accounts.js.map

package/dist/src/ledger/proxy-accounts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy-accounts.js","sourceRoot":"","sources":["../../../src/ledger/proxy-accounts.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAuB3C;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAoB;IACnD,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,EAAE,CAAA;IACnC,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAA;IAC/B,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAA;IAEpD,IAAI,OAAO,CAAC,SAAS,EAAE,IAAI,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;QAChD,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,mBAAmB,EAAE,CAAC,aAAa,EAAE,CAAC,CAAA;QACxF,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAA;IACpD,CAAC;IACD,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,EAAE;QAChC,CAAC,CAAC,YAAY;QACd,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE;YACnB,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE;gBACpB,CAAC,CAAC,UAAU;gBACZ,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,OAAO,CAAC,MAAM,EAAE;oBACnC,CAAC,CAAC,KAAK;oBACP,CAAC,CAAC,SAAS,CAAA;IACnB,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAA;AACnD,CAAC"}

package/dist/src/net/discovery.d.ts

@@ -0,0 +1,62 @@
+import type { RequestOptions } from './transport';
+/** How the directory classifies a node. Only `'active'` processes transactions. */
+export type GeeqNodeKind = 'active' | 'relay' | 'listener' | 'chain-admin' | 'none' | 'unknown';
+/** One chain the directory knows about. */
+export interface GeeqDiscoveredChain {
+    /** The directory's own row id, which every other directory route calls `systemId`. */
+    readonly systemId: number;
+    /** The protocol chain number — what a transaction carries and a node checks. */
+    readonly chainNumber: number;
+    readonly name: string | undefined;
+}
+/**
+ * One node the directory knows about.
+ *
+ * Note what is **missing**: a node number. The directory can say where a node is but
+ * not who it is in the chain's own net actor list, so the ledger read is still the only
+ * way to learn the number a transaction must carry.
+ */
+export interface GeeqDiscoveredNode {
+    readonly host: string;
+    readonly kind: GeeqNodeKind;
+    /** The directory's own lifecycle state — `new`, `ready`, `stopped`. */
+    readonly status: string;
+    /** Where to reach it. Always the client port; the directory's own port is internal. */
+    readonly url: string;
+}
+/** Every chain the directory knows about. */
+export declare function listChains(origin: string, request: RequestOptions): Promise<GeeqDiscoveredChain[]>;
+export interface NodeAddressing {
+    /** Scheme for the node URLs. Defaults to the directory's own. */
+    readonly protocol?: string | undefined;
+    /** Client port. Defaults to {@link GEEQ_NODE_PORT}; override only for local setups. */
+    readonly port?: number | undefined;
+}
+/** Every node the directory lists for one chain. */
+export declare function listNodes(origin: string, systemId: number, request: RequestOptions, addressing?: NodeAddressing): Promise<GeeqDiscoveredNode[]>;
+export interface DiscoverOptions extends NodeAddressing {
+    readonly origin: string;
+    /** Select the chain by the name the directory gives it. Matched case-insensitively. */
+    readonly chainName?: string | undefined;
+    /** Select by protocol chain number, or — alongside `chainName` — assert it. */
+    readonly chainNumber?: number | undefined;
+    readonly request: RequestOptions;
+}
+export interface Discovery {
+    readonly chain: GeeqDiscoveredChain;
+    /** Every node listed for the chain, in directory order. */
+    readonly nodes: readonly GeeqDiscoveredNode[];
+    /** Those that will actually take a transaction. */
+    readonly usable: readonly GeeqDiscoveredNode[];
+}
+/** True when the directory says this node is an active one that has not been stopped. */
+export declare function isUsable(node: GeeqDiscoveredNode): boolean;
+/**
+ * Find a chain in the directory and list its nodes.
+ *
+ * This reads two routes and nothing else. The directory is a deployment control plane:
+ * it has no authentication, and its other routes create and destroy machines and serve
+ * private keys. Treat every value it returns as a hint about *where* to look, never as
+ * authority about the chain itself — that comes from the ledger.
+ */
+export declare function discover(options: DiscoverOptions): Promise<Discovery>;

package/dist/src/net/discovery.js

@@ -0,0 +1,136 @@
+import { invalidArgument, nodeUnusable } from '../errors';
+import { GEEQ_NODE_PORT } from '../chain/select';
+import { chainsRoute, nodesRoute } from './routes';
+import { requestText } from './transport';
+const KINDS = new Set([
+    'active',
+    'relay',
+    'listener',
+    'chain-admin',
+    'none',
+]);
+function resultOf(body, url) {
+    let parsed;
+    try {
+        parsed = JSON.parse(body);
+    }
+    catch (cause) {
+        throw nodeUnusable(`The directory at ${url} did not answer with JSON. A proxy or login page in front ` +
+            'of it is the usual reason.', cause);
+    }
+    const result = parsed?.result;
+    if (!Array.isArray(result)) {
+        throw nodeUnusable(`The directory at ${url} answered without a "result" array, so it does not look ` +
+            'like a Geeq node directory.');
+    }
+    return result;
+}
+/** Every chain the directory knows about. */
+export async function listChains(origin, request) {
+    const url = chainsRoute(origin);
+    const rows = resultOf(await requestText(url, request), url);
+    return rows
+        .map((row) => row)
+        .filter((row) => typeof row.id === 'number' && typeof row.chainNumber === 'number')
+        .map((row) => Object.freeze({
+        systemId: row.id,
+        chainNumber: row.chainNumber,
+        name: typeof row.name === 'string' ? row.name : undefined,
+    }));
+}
+/** Every node the directory lists for one chain. */
+export async function listNodes(origin, systemId, request, addressing = {}) {
+    const protocol = addressing.protocol ?? new URL(origin).protocol;
+    const port = addressing.port ?? GEEQ_NODE_PORT;
+    const url = nodesRoute(origin, systemId);
+    const rows = resultOf(await requestText(url, request), url);
+    return rows
+        .map((row) => row)
+        .filter((row) => typeof row.ip === 'string' && row.ip !== '')
+        .map((row) => {
+        const kind = typeof row.type === 'string' && KINDS.has(row.type) ? row.type : 'unknown';
+        return Object.freeze({
+            host: row.ip,
+            kind: kind,
+            status: typeof row.status === 'string' ? row.status : 'unknown',
+            // The directory reports the node's own internal listener, which is not where
+            // clients connect, so its port field is deliberately ignored in favour of the
+            // one port every node answers on.
+            url: `${protocol}//${row.ip}:${port}`,
+        });
+    });
+}
+/** True when the directory says this node is an active one that has not been stopped. */
+export function isUsable(node) {
+    return node.kind === 'active' && node.status !== 'stopped';
+}
+/**
+ * Find a chain in the directory and list its nodes.
+ *
+ * This reads two routes and nothing else. The directory is a deployment control plane:
+ * it has no authentication, and its other routes create and destroy machines and serve
+ * private keys. Treat every value it returns as a hint about *where* to look, never as
+ * authority about the chain itself — that comes from the ledger.
+ */
+export async function discover(options) {
+    const chains = await listChains(options.origin, options.request);
+    if (chains.length === 0) {
+        throw nodeUnusable(`The directory at ${options.origin} lists no chains.`);
+    }
+    const listed = chains
+        .map((c) => `${c.name ?? '(unnamed)'} (chain ${c.chainNumber})`)
+        .join(', ');
+    let chain;
+    if (options.chainName !== undefined) {
+        // Names are what a person types, so match them the way a person means them.
+        const wanted = options.chainName.trim().toLowerCase();
+        const matches = chains.filter((c) => c.name?.trim().toLowerCase() === wanted);
+        if (matches.length === 0) {
+            throw invalidArgument(`The directory at ${options.origin} has no chain named ` +
+                `${JSON.stringify(options.chainName)}. Available: ${listed}.`);
+        }
+        if (matches.length > 1) {
+            throw invalidArgument(`The directory at ${options.origin} lists ${matches.length} chains named ` +
+                `${JSON.stringify(options.chainName)} (numbers ` +
+                `${matches.map((c) => c.chainNumber).join(', ')}), so the name does not identify ` +
+                'one. Select it by chainNumber instead.');
+        }
+        chain = matches[0];
+    }
+    else if (options.chainNumber !== undefined) {
+        chain = chains.find((c) => c.chainNumber === options.chainNumber);
+        if (chain === undefined) {
+            throw invalidArgument(`The directory at ${options.origin} does not list chain ${options.chainNumber}. ` +
+                `Available: ${listed}.`);
+        }
+    }
+    else {
+        if (chains.length > 1) {
+            throw invalidArgument(`The directory at ${options.origin} lists ${chains.length} chains, so chainName ` +
+                `or chainNumber is required to choose one. Available: ${listed}.`);
+        }
+        chain = chains[0];
+    }
+    const resolved = chain;
+    // A name and a number together are an assertion, not two ways of choosing.
+    if (options.chainName !== undefined &&
+        options.chainNumber !== undefined &&
+        resolved.chainNumber !== options.chainNumber) {
+        throw invalidArgument(`The directory at ${options.origin} says ${JSON.stringify(options.chainName)} is ` +
+            `chain ${resolved.chainNumber}, but chainNumber was given as ` +
+            `${options.chainNumber}. Drop one of the two.`);
+    }
+    const nodes = await listNodes(options.origin, resolved.systemId, options.request, {
+        ...(options.protocol === undefined ? {} : { protocol: options.protocol }),
+        ...(options.port === undefined ? {} : { port: options.port }),
+    });
+    const usable = nodes.filter(isUsable);
+    if (usable.length === 0) {
+        const seen = nodes.map((n) => `${n.host} (${n.kind}/${n.status})`).join(', ');
+        throw nodeUnusable(`The directory at ${options.origin} lists no node for chain ${resolved.chainNumber} ` +
+            'that is active and running. Only an active node processes transactions. ' +
+            (seen === '' ? 'It listed none at all.' : `It listed: ${seen}.`));
+    }
+    return Object.freeze({ chain: resolved, nodes: Object.freeze([...nodes]), usable: Object.freeze(usable) });
+}
+//# sourceMappingURL=discovery.js.map

package/dist/src/net/discovery.js.map

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

package/dist/src/net/explorer.d.ts

@@ -0,0 +1,57 @@
+import type { GeeqTransport } from './transport';
+/** A transaction as a block explorer reports it, field for field. */
+export interface GeeqExplorerTransaction {
+    /** Hex — the form the explorer files transactions under. */
+    readonly refHash: string;
+    /** The transaction's kind, such as `coin`. */
+    readonly type: string;
+    /** The explorer's verdict on it. */
+    readonly status: string;
+    readonly block: number;
+    readonly chainName: string;
+    readonly chainNumber: number;
+    /** The sender's wallet address. */
+    readonly from: string;
+    readonly senderType: string;
+    /** The receiver's wallet address, or empty when it has none. */
+    readonly to: string;
+    readonly receiverType: string;
+    readonly publicKey: string;
+    readonly signature: string;
+    readonly createdAt: string;
+    readonly fee: string;
+    readonly acctNumApp?: string;
+    /** What it moved — coin, tokens, NFTs — with amounts as decimal strings. */
+    readonly values: readonly {
+        readonly type: string;
+        readonly value: string;
+        readonly name?: string;
+    }[];
+    /** An attestation's hash and metadata. */
+    readonly payload?: {
+        readonly attestationHash: string;
+        readonly metadata: readonly string[];
+    };
+}
+export interface ExplorerTransactionRequest {
+    /** The explorer's base URL, such as `https://blkexp.geeq-test.io`. */
+    readonly explorerUrl: string | URL;
+    /**
+     * The transaction's refHash in base64 — what `transactionIdOf(tx)` returns and socket
+     * status events carry. It is sent to the explorer as hex.
+     */
+    readonly refHash: string;
+    /** Defaults to `globalThis.fetch`. */
+    readonly transport?: GeeqTransport;
+    /** Defaults to 10000. */
+    readonly timeoutMs?: number;
+    readonly signal?: AbortSignal;
+}
+/**
+ * Look a transaction up in a block explorer by its refHash.
+ *
+ * Resolves `null` when the explorer does not have it — not indexed yet, or never put in a
+ * block. The explorer only knows a transaction once a block has decided it, so for one
+ * you have just sent, the node socket answers first.
+ */
+export declare function getExplorerTransaction(request: ExplorerTransactionRequest): Promise<GeeqExplorerTransaction | null>;

package/dist/src/net/explorer.js

@@ -0,0 +1,64 @@
+import { GeeqError, invalidArgument, nodeUnusable } from '../errors';
+import { fromBase64 } from '../encoding/base64';
+import { toHex } from '../encoding/hex';
+import { explorerTransactionRoute } from './routes';
+import { defaultTransport, requestText } from './transport';
+const DEFAULT_TIMEOUT_MS = 10_000;
+const HASH_BYTES = 32;
+/** What the explorer answers, with HTTP 500, for a refHash it does not have. */
+const NOT_FOUND = 'Transaction does not exist';
+function explorerBase(explorerUrl) {
+    let url;
+    try {
+        url = new URL(String(explorerUrl));
+    }
+    catch {
+        url = undefined;
+    }
+    if (url === undefined || (url.protocol !== 'https:' && url.protocol !== 'http:')) {
+        throw invalidArgument('explorerUrl must be an absolute http(s) URL, such as https://blkexp.geeq-test.io, ' +
+            `received ${JSON.stringify(String(explorerUrl))}.`);
+    }
+    return `${url.origin}${url.pathname.replace(/\/+$/u, '')}`;
+}
+/**
+ * Look a transaction up in a block explorer by its refHash.
+ *
+ * Resolves `null` when the explorer does not have it — not indexed yet, or never put in a
+ * block. The explorer only knows a transaction once a block has decided it, so for one
+ * you have just sent, the node socket answers first.
+ */
+export async function getExplorerTransaction(request) {
+    const hash = fromBase64(request.refHash, 'refHash');
+    if (hash.length !== HASH_BYTES) {
+        throw invalidArgument(`refHash must be the base64 of a ${HASH_BYTES}-byte hash, received ${hash.length} bytes.`);
+    }
+    const url = explorerTransactionRoute(explorerBase(request.explorerUrl), toHex(hash));
+    let body;
+    try {
+        body = await requestText(url, {
+            transport: request.transport ?? defaultTransport,
+            timeoutMs: request.timeoutMs ?? DEFAULT_TIMEOUT_MS,
+            retries: 1,
+            signal: request.signal,
+        });
+    }
+    catch (error) {
+        if (error instanceof GeeqError && error.nodeDetails === NOT_FOUND)
+            return null;
+        throw error;
+    }
+    let result;
+    try {
+        result = JSON.parse(body)?.result;
+    }
+    catch {
+        result = undefined;
+    }
+    if (result === null || typeof result !== 'object' || !('refHash' in result)) {
+        throw nodeUnusable(`${url} did not answer with a transaction, so it does not look like a Geeq block ` +
+            'explorer.');
+    }
+    return result;
+}
+//# sourceMappingURL=explorer.js.map

package/dist/src/net/explorer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explorer.js","sourceRoot":"","sources":["../../../src/net/explorer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AACvC,OAAO,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAA;AACnD,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAG3D,MAAM,kBAAkB,GAAG,MAAM,CAAA;AACjC,MAAM,UAAU,GAAG,EAAE,CAAA;AACrB,gFAAgF;AAChF,MAAM,SAAS,GAAG,4BAA4B,CAAA;AAoD9C,SAAS,YAAY,CAAC,WAAyB;IAC7C,IAAI,GAAoB,CAAA;IACxB,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAA;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,GAAG,GAAG,SAAS,CAAA;IACjB,CAAC;IACD,IAAI,GAAG,KAAK,SAAS,IAAI,CAAC,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO,CAAC,EAAE,CAAC;QACjF,MAAM,eAAe,CACnB,oFAAoF;YAClF,YAAY,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,GAAG,CACrD,CAAA;IACH,CAAC;IACD,OAAO,GAAG,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,CAAA;AAC5D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAAmC;IAEnC,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;IACnD,IAAI,IAAI,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QAC/B,MAAM,eAAe,CACnB,mCAAmC,UAAU,wBAAwB,IAAI,CAAC,MAAM,SAAS,CAC1F,CAAA;IACH,CAAC;IACD,MAAM,GAAG,GAAG,wBAAwB,CAAC,YAAY,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;IAEpF,IAAI,IAAY,CAAA;IAChB,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE;YAC5B,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,gBAAgB;YAChD,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,kBAAkB;YAClD,OAAO,EAAE,CAAC;YACV,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAA;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,SAAS,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS;YAAE,OAAO,IAAI,CAAA;QAC9E,MAAM,KAAK,CAAA;IACb,CAAC;IAED,IAAI,MAAe,CAAA;IACnB,IAAI,CAAC;QACH,MAAM,GAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAA0B,EAAE,MAAM,CAAA;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,GAAG,SAAS,CAAA;IACpB,CAAC;IACD,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,SAAS,IAAI,MAAM,CAAC,EAAE,CAAC;QAC5E,MAAM,YAAY,CAChB,GAAG,GAAG,4EAA4E;YAChF,WAAW,CACd,CAAA;IACH,CAAC;IACD,OAAO,MAAiC,CAAA;AAC1C,CAAC"}

package/dist/src/net/read-ledger.d.ts

@@ -0,0 +1,7 @@
+import type { GeeqLedger } from '../ledger/geeq-ledger';
+import type { NftRecordFacts } from '../ledger/nft-records';
+import type { RequestOptions } from './transport';
+/** Read and decode the validation layer ledger from one node. */
+export declare function readLedger(origin: string, options: RequestOptions): Promise<GeeqLedger>;
+/** Read the NFT records in the application layer ledger from one node. */
+export declare function readNftRecords(origin: string, options: RequestOptions): Promise<Map<string, NftRecordFacts>>;

package/dist/src/net/read-ledger.js

@@ -0,0 +1,39 @@
+import { ledgerUnreadable } from '../errors';
+import { decodeValidationLedger } from '../ledger/decode';
+import { decodeNftRecords } from '../ledger/nft-records';
+import { appLedgerRoute, ledgerRoute } from './routes';
+import { requestText } from './transport';
+/** Pull `result` out of a node's response envelope. */
+function resultOf(body, url) {
+    let parsed;
+    try {
+        parsed = JSON.parse(body);
+    }
+    catch (cause) {
+        throw ledgerUnreadable(`The node at ${url} did not answer with JSON. A login page or a proxy error is ` +
+            `the usual reason. First 120 characters: ${JSON.stringify(body.slice(0, 120))}.`, cause);
+    }
+    if (parsed === null || typeof parsed !== 'object' || !('result' in parsed)) {
+        throw ledgerUnreadable(`The node at ${url} answered JSON with no "result" field, so this is probably ` +
+            'not a Geeq node.');
+    }
+    const { result } = parsed;
+    if (typeof result !== 'string') {
+        throw ledgerUnreadable(`The node at ${url} answered with a "result" of type ${typeof result}, expected a ` +
+            'base64 string.');
+    }
+    return result;
+}
+/** Read and decode the validation layer ledger from one node. */
+export async function readLedger(origin, options) {
+    const url = ledgerRoute(origin);
+    const body = await requestText(url, options);
+    return decodeValidationLedger(resultOf(body, url), { nodeUrl: origin });
+}
+/** Read the NFT records in the application layer ledger from one node. */
+export async function readNftRecords(origin, options) {
+    const url = appLedgerRoute(origin);
+    const body = await requestText(url, options);
+    return decodeNftRecords(resultOf(body, url));
+}
+//# sourceMappingURL=read-ledger.js.map

package/dist/src/net/read-ledger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-ledger.js","sourceRoot":"","sources":["../../../src/net/read-ledger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAC5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAEzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAExD,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAEtD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAEzC,uDAAuD;AACvD,SAAS,QAAQ,CAAC,IAAY,EAAE,GAAW;IACzC,IAAI,MAAe,CAAA;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,gBAAgB,CACpB,eAAe,GAAG,8DAA8D;YAC9E,2CAA2C,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,EAClF,KAAK,CACN,CAAA;IACH,CAAC;IAED,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,IAAI,MAAM,CAAC,EAAE,CAAC;QAC3E,MAAM,gBAAgB,CACpB,eAAe,GAAG,6DAA6D;YAC7E,kBAAkB,CACrB,CAAA;IACH,CAAC;IAED,MAAM,EAAE,MAAM,EAAE,GAAG,MAA6B,CAAA;IAChD,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,gBAAgB,CACpB,eAAe,GAAG,qCAAqC,OAAO,MAAM,eAAe;YACjF,gBAAgB,CACnB,CAAA;IACH,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED,iEAAiE;AACjE,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAc,EACd,OAAuB;IAEvB,MAAM,GAAG,GAAG,WAAW,CAAC,MAAM,CAAC,CAAA;IAC/B,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;IAC5C,OAAO,sBAAsB,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAA;AACzE,CAAC;AAED,0EAA0E;AAC1E,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAc,EACd,OAAuB;IAEvB,MAAM,GAAG,GAAG,cAAc,CAAC,MAAM,CAAC,CAAA;IAClC,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;IAC5C,OAAO,gBAAgB,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAA;AAC9C,CAAC"}

package/dist/src/net/routes.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Every node route the SDK knows, in one place.
+ *
+ * `origin` is an absolute node URL with no trailing slash — see `originOf`.
+ */
+/** `GET` the current validation layer ledger, base64 packed capnp under `result`. */
+export declare function ledgerRoute(origin: string): string;
+/** `GET` the current application layer ledger, where NFT records live. Same envelope. */
+export declare function appLedgerRoute(origin: string): string;
+/**
+ * Where a signed transaction is POSTed.
+ *
+ * The SDK does not submit — this is exported so an application builds the same URL the
+ * SDK read from, rather than keeping its own copy of the path.
+ */
+export declare function submitRoute(origin: string): string;
+/**
+ * The node's client WebSocket, where transaction status events arrive.
+ *
+ * Same host and port as the HTTP API — the node's TLS front door routes `/ws/` to the
+ * socket server and `/api/` to the HTTP one — so the only change is the scheme. The
+ * trailing slash is part of the route: the proxy answers `/ws` with a redirect, and a
+ * WebSocket handshake treats a redirect as failure.
+ */
+export declare function socketRoute(origin: string): string;
+/**
+ * The body a node expects for an application-layer transaction: an attestation or an NFT
+ * mint, each a transaction and its payload.
+ */
+export declare function attestationSubmitBody(transaction: string, payload: string): string;
+/**
+ * The body a node expects for a coin transfer.
+ *
+ * A different type and a different shape from an attestation: a validation-layer
+ * transaction carries no separate payload, so there is one blob rather than two.
+ */
+export declare function coinTransferSubmitBody(transaction: string): string;
+/**
+ * Discovery routes on the chain's directory service.
+ *
+ * Only these two are ever called. The same service also exposes routes that start and
+ * stop nodes, install a genesis block, and — on `/api/accounts` — hand out plaintext
+ * private keys. None of those belong anywhere near an SDK, so the paths live here and
+ * nowhere else, and nothing constructs a URL against that origin by hand.
+ */
+export declare function chainsRoute(origin: string): string;
+export declare function nodesRoute(origin: string, systemId: number): string;
+/** A block explorer's transaction lookup. The explorer files transactions by hex refHash. */
+export declare function explorerTransactionRoute(explorer: string, refHashHex: string): string;