@geeqdev/geeq-sdk 0.1.1 → 0.2.0

package/dist/src/capnp/valLayLedger.capnp.js

@@ -0,0 +1,75 @@
+/* tslint:disable */
+/**
+ * This file has been automatically generated by the [capnpc-ts utility](https://github.com/jdiaz5513/capnp-ts).
+ */
+import * as capnp from "capnp-ts";
+import { ObjectSize as __O, Struct as __S } from 'capnp-ts';
+import { TokenAssetSubgroup, NftAssetSubgroup, CoinAssetRec, CoinHlRec, CoinMicroRec, CoinAcctRec } from "./coinAcctRec.capnp";
+import { NetActorRec } from "./netActorRec.capnp";
+import { ParamBoolean, ParamCountTwo, ParamCountEight, ParamAcctRec } from "./paramAcctRec.capnp";
+import { MultiUserSubgroup, ProxyDceRec, ProxyFundingRec, ProxyMultisigRec, ProxyNftMintRec, ProxyTokenMintRec, ProxyAcctRec } from "./proxyAcctRec.capnp";
+import { SysAcctRec } from "./sysAcctRec.capnp";
+export const _capnpFileId = "fc9fd9e8367eae85";
+export class NetActorList extends __S {
+    static { this._capnp = { displayName: "NetActorList", id: "cb69154de78302bf", size: new __O(0, 1) }; }
+    adoptNetActorRecs(value) { __S.adopt(value, __S.getPointer(0, this)); }
+    disownNetActorRecs() { return __S.disown(this.getNetActorRecs()); }
+    getNetActorRecs() { return __S.getList(0, NetActorList._NetActorRecs, this); }
+    hasNetActorRecs() { return !__S.isNull(__S.getPointer(0, this)); }
+    initNetActorRecs(length) { return __S.initList(0, NetActorList._NetActorRecs, length, this); }
+    setNetActorRecs(value) { __S.copyFrom(value, __S.getPointer(0, this)); }
+    toString() { return "NetActorList_" + super.toString(); }
+}
+export class ParamAcctList extends __S {
+    static { this._capnp = { displayName: "ParamAcctList", id: "9f10966c1823b346", size: new __O(0, 1) }; }
+    adoptParamAcctRecs(value) { __S.adopt(value, __S.getPointer(0, this)); }
+    disownParamAcctRecs() { return __S.disown(this.getParamAcctRecs()); }
+    getParamAcctRecs() { return __S.getList(0, ParamAcctList._ParamAcctRecs, this); }
+    hasParamAcctRecs() { return !__S.isNull(__S.getPointer(0, this)); }
+    initParamAcctRecs(length) { return __S.initList(0, ParamAcctList._ParamAcctRecs, length, this); }
+    setParamAcctRecs(value) { __S.copyFrom(value, __S.getPointer(0, this)); }
+    toString() { return "ParamAcctList_" + super.toString(); }
+}
+export class ValLayLedger extends __S {
+    static { this._capnp = { displayName: "ValLayLedger", id: "ce5af3ba903430bd", size: new __O(8, 5) }; }
+    getBlockNum() { return __S.getUint32(0, this); }
+    setBlockNum(value) { __S.setUint32(0, value, this); }
+    getChainNum() { return __S.getUint32(4, this); }
+    setChainNum(value) { __S.setUint32(4, value, this); }
+    adoptSysAcctRec(value) { __S.adopt(value, __S.getPointer(0, this)); }
+    disownSysAcctRec() { return __S.disown(this.getSysAcctRec()); }
+    getSysAcctRec() { return __S.getStruct(0, SysAcctRec, this); }
+    hasSysAcctRec() { return !__S.isNull(__S.getPointer(0, this)); }
+    initSysAcctRec() { return __S.initStructAt(0, SysAcctRec, this); }
+    setSysAcctRec(value) { __S.copyFrom(value, __S.getPointer(0, this)); }
+    adoptNetActorList(value) { __S.adopt(value, __S.getPointer(1, this)); }
+    disownNetActorList() { return __S.disown(this.getNetActorList()); }
+    getNetActorList() { return __S.getStruct(1, NetActorList, this); }
+    hasNetActorList() { return !__S.isNull(__S.getPointer(1, this)); }
+    initNetActorList() { return __S.initStructAt(1, NetActorList, this); }
+    setNetActorList(value) { __S.copyFrom(value, __S.getPointer(1, this)); }
+    adoptParamAcctList(value) { __S.adopt(value, __S.getPointer(2, this)); }
+    disownParamAcctList() { return __S.disown(this.getParamAcctList()); }
+    getParamAcctList() { return __S.getStruct(2, ParamAcctList, this); }
+    hasParamAcctList() { return !__S.isNull(__S.getPointer(2, this)); }
+    initParamAcctList() { return __S.initStructAt(2, ParamAcctList, this); }
+    setParamAcctList(value) { __S.copyFrom(value, __S.getPointer(2, this)); }
+    adoptCoinAcctRecs(value) { __S.adopt(value, __S.getPointer(3, this)); }
+    disownCoinAcctRecs() { return __S.disown(this.getCoinAcctRecs()); }
+    getCoinAcctRecs() { return __S.getList(3, ValLayLedger._CoinAcctRecs, this); }
+    hasCoinAcctRecs() { return !__S.isNull(__S.getPointer(3, this)); }
+    initCoinAcctRecs(length) { return __S.initList(3, ValLayLedger._CoinAcctRecs, length, this); }
+    setCoinAcctRecs(value) { __S.copyFrom(value, __S.getPointer(3, this)); }
+    adoptProxyAcctRecs(value) { __S.adopt(value, __S.getPointer(4, this)); }
+    disownProxyAcctRecs() { return __S.disown(this.getProxyAcctRecs()); }
+    getProxyAcctRecs() { return __S.getList(4, ValLayLedger._ProxyAcctRecs, this); }
+    hasProxyAcctRecs() { return !__S.isNull(__S.getPointer(4, this)); }
+    initProxyAcctRecs(length) { return __S.initList(4, ValLayLedger._ProxyAcctRecs, length, this); }
+    setProxyAcctRecs(value) { __S.copyFrom(value, __S.getPointer(4, this)); }
+    toString() { return "ValLayLedger_" + super.toString(); }
+}
+NetActorList._NetActorRecs = capnp.CompositeList(NetActorRec);
+ParamAcctList._ParamAcctRecs = capnp.CompositeList(ParamAcctRec);
+ValLayLedger._CoinAcctRecs = capnp.CompositeList(CoinAcctRec);
+ValLayLedger._ProxyAcctRecs = capnp.CompositeList(ProxyAcctRec);
+//# sourceMappingURL=valLayLedger.capnp.js.map

package/dist/src/capnp/valLayLedger.capnp.js.map

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

package/dist/src/chain/geeq-chain.d.ts

@@ -0,0 +1,474 @@
+import type { AccountRef } from '../crypto/account-id';
+import type { GeeqAmount } from '../amount';
+import type { AttestationTx, CoinTransferTx, GeeqChainState, GeeqKeypair, GeeqNft, GeeqNftMintProxies, NftMintProxyTx, NftMintTx } from '../types';
+import type { GeeqDiscoveredNode } from '../net/discovery';
+import type { GeeqLedger } from '../ledger/geeq-ledger';
+import type { GeeqLedgerNode } from '../ledger/net-actors';
+import type { GeeqTransport } from '../net/transport';
+import type { GeeqContent } from '../tx/content';
+import { GeeqNode } from './geeq-node';
+import type { NodeRequestConfig } from './geeq-node';
+export interface GeeqChainOptions {
+    /**
+     * How many pennies make one Geeq: a power of ten, as a bigint.
+     *
+     * The chain counts only pennies and does not publish this, so the app says — use the
+     * divisor its wallet and explorer show amounts with. {@link GeeqChain.toPennies} reads
+     * `{ geeq }` figures with it, and {@link GeeqChain.formatGeeq} and the chain's own
+     * messages show amounts with it.
+     */
+    readonly penniesPerGeeq: bigint;
+    /**
+     * The chain's node directory — the simulator URL for your environment — which the SDK
+     * asks for an active node. Works for every chain and environment.
+     *
+     * Supply this or {@link endpoint}, not both. The directory is the only thing that
+     * knows which nodes exist and which are running; the ledger then says which actor the
+     * chosen one is. Note the directory is a deployment control plane with no
+     * authentication — the SDK reads two of its routes and never touches the rest.
+     */
+    readonly discovery?: string | URL;
+    /**
+     * A specific node, when you already know one.
+     *
+     * Supply this or {@link discovery}, not both.
+     */
+    readonly endpoint?: string | URL;
+    /**
+     * Which chain to use, by the name its directory gives it.
+     *
+     * Only meaningful with {@link discovery} — a name exists nowhere but the directory.
+     * Matched case-insensitively.
+     */
+    readonly chainName?: string;
+    /**
+     * Which chain to use, by protocol number.
+     *
+     * With {@link discovery} this selects the chain when no {@link chainName} is given,
+     * and asserts it when one is. With {@link endpoint} it asserts the node serves the
+     * chain you expect, and a mismatch throws `chain-mismatch` on the first ledger read.
+     */
+    readonly chainNumber?: number;
+    /** Defaults to a call through `globalThis.fetch`. */
+    readonly transport?: GeeqTransport;
+    /** Per request. Defaults to 10000. */
+    readonly timeoutMs?: number;
+    /** Extra headers on every request — a proxy token, a trace id. */
+    readonly headers?: Readonly<Record<string, string>>;
+    /** How long a read ledger may be reused. Defaults to 5000. 0 disables the cache. */
+    readonly ledgerMaxAgeMs?: number;
+    /** Skip host matching. Required behind a gateway or when using a DNS name. */
+    readonly nodeNumber?: number;
+    /**
+     * The port discovered nodes are reached on. Defaults to 2082.
+     *
+     * Deployment configuration, not node selection — override it only when running
+     * against nodes that are not behind the standard TLS front door, such as a local
+     * test harness.
+     */
+    readonly nodePort?: number;
+    /** Retries on transport failure only, never on a response. Defaults to 1. */
+    readonly retries?: number;
+    readonly signal?: AbortSignal;
+}
+export interface AttestationRequest {
+    /** The account that signs. Must be a coin-asset account on this chain. */
+    readonly keypair: GeeqKeypair;
+    /**
+     * What to attest. Hashed here with BLAKE3-32; the content never leaves the device.
+     *
+     * A `File` straight from a file input works, as does a string or raw bytes.
+     */
+    readonly content?: GeeqContent;
+    /** Or supply the digest yourself. Exactly one of `content` and `attestHash`. */
+    readonly attestHash?: Uint8Array;
+    /** Public labels, checked against this chain's limits before anything is signed. */
+    readonly metadata?: readonly (string | Uint8Array)[];
+    /** Override the derived nonce. See {@link NonceGuard} for when that is needed. */
+    readonly nonce?: number;
+    readonly signal?: AbortSignal;
+}
+export interface CoinTransferRequest {
+    /** The account paying. Must be a coin-asset account on this chain. */
+    readonly from: GeeqKeypair;
+    /**
+     * Who receives it.
+     *
+     * A base58 wallet address is the usual thing — it is what a person pastes — and the
+     * chain it encodes is checked against this one. A raw account id or public key works
+     * too, but carries no chain to check.
+     */
+    readonly to: string | AccountRef;
+    /**
+     * How much. State the unit: `{ geeq: "1.5" }`, read at {@link GeeqChainOptions.penniesPerGeeq},
+     * or `{ pennies }` as the chain counts them. May be left out
+     * when sending NFTs, which then go with the chain's minimum transfer.
+     */
+    readonly amount?: GeeqAmount;
+    /** NFTs to send, by id — see {@link GeeqChain.findNfts}. The sender must hold each one. */
+    readonly nfts?: readonly Uint8Array[];
+    /** Override the derived nonce. See {@link NonceGuard}. */
+    readonly nonce?: number;
+    readonly signal?: AbortSignal;
+}
+export interface ChainStateRequest {
+    readonly account: AccountRef;
+    readonly maxAgeMs?: number;
+    readonly signal?: AbortSignal;
+}
+export interface NftMintProxyRequest {
+    /**
+     * The account paying for the proxy, which also becomes its admin: the only key that
+     * can later mint NFTs through it. Must be a coin-asset account on this chain.
+     */
+    readonly admin: GeeqKeypair;
+    /**
+     * Coin moved onto the proxy, `{ geeq }` or `{ pennies }` like any amount. It pays for the
+     * mints made through it, so fund it for more than one.
+     */
+    readonly amount: GeeqAmount;
+    /**
+     * Which of the admin's proxies this is, from 1. Leave it out to take the next one —
+     * one past the highest the ledger holds for this admin, see
+     * {@link GeeqChain.findNftMintProxies}. An index already in use is refused.
+     */
+    readonly index?: number;
+    /** Override the derived nonce. See {@link NonceGuard}. */
+    readonly nonce?: number;
+    readonly signal?: AbortSignal;
+}
+export interface NftMintProxiesRequest {
+    /**
+     * The admin whose proxies to find. A keypair will do; so will a bare public key, since
+     * listing needs no signature. Not an account id: an index is derived from the key.
+     */
+    readonly admin: {
+        readonly publicKey: Uint8Array;
+    };
+    /** How old a cached ledger may be. 0 reads afresh — a new proxy shows only once confirmed. */
+    readonly maxAgeMs?: number;
+    readonly signal?: AbortSignal;
+}
+export interface NftsRequest {
+    /** Whose NFTs. A keypair will do, as will an account id or a public key. */
+    readonly owner: AccountRef;
+    /** How old a cached ledger may be. 0 reads afresh — a new NFT shows only once confirmed. */
+    readonly maxAgeMs?: number;
+    readonly signal?: AbortSignal;
+}
+export interface NftMintRequest {
+    /** The proxy's admin: the only key that can mint through it. It signs the mint. */
+    readonly admin: GeeqKeypair;
+    /**
+     * Which of the admin's proxies mints it, by index — see
+     * {@link GeeqChain.findNftMintProxies}. The proxy pays the fee and {@link amount}, and
+     * spends its own nonce, not the admin's.
+     */
+    readonly index: number;
+    /**
+     * What the NFT stands for. Hashed here with BLAKE3-32; the content never leaves the
+     * device. A `File` straight from a file input works, as does a string or raw bytes.
+     */
+    readonly content?: GeeqContent;
+    /** Or supply the digest yourself. Exactly one of `content` and `attestHash`. */
+    readonly attestHash?: Uint8Array;
+    /** Public labels stored with the NFT, checked against this chain's limits before signing. */
+    readonly metadata?: readonly (string | Uint8Array)[];
+    /** Who receives the NFT. Defaults to the admin. An address is checked against this chain. */
+    readonly to?: string | AccountRef;
+    /** Coin the proxy sends to the receiver with it. Defaults to the chain's minimum transfer. */
+    readonly amount?: GeeqAmount;
+    /** Override the proxy's derived nonce. See {@link NonceGuard}. */
+    readonly nonce?: number;
+    readonly signal?: AbortSignal;
+}
+/**
+ * A chain, reached through one node.
+ *
+ * Holds the node directory, the metadata limits and a short-lived ledger cache, so an
+ * attestation needs only a keypair and something to attest. Everything a transaction is
+ * pinned to — chain number, target block, node number, nonce — is read from the ledger
+ * rather than asked of the caller, because none of it can be known offline and a wrong
+ * value is rejected by the chain.
+ *
+ * A chain is bound to the endpoint it was connected to. To use a different node, connect
+ * another one: a different node means a different address, certificate and CORS origin,
+ * which is not something to switch silently.
+ *
+ * In a reactive framework, mark an instance raw (Vue's `markRaw`) rather than letting it
+ * be proxied.
+ */
+export declare class GeeqChain {
+    /** The node this chain reads from and builds transactions for. */
+    readonly endpoint: string;
+    /** What the directory said about the nodes on this chain, when one was used. */
+    readonly candidates: readonly GeeqDiscoveredNode[];
+    /** The chain's name, when a directory supplied one. Display only — chains are numbered. */
+    readonly chainName: string | undefined;
+    /** How many pennies make one Geeq, as given to {@link GeeqChain.connect}. */
+    readonly penniesPerGeeq: bigint;
+    private readonly request;
+    private readonly ledgerMaxAgeMs;
+    private readonly nonces;
+    private readonly declaredChainNumber;
+    private readonly nodeNumberOverride;
+    private cached;
+    private resolved;
+    private inflight;
+    /** @internal */
+    constructor(init: {
+        endpoint: string;
+        candidates: readonly GeeqDiscoveredNode[];
+        chainName: string | undefined;
+        chainNumber: number | undefined;
+        nodeNumber: number | undefined;
+        penniesPerGeeq: bigint;
+        request: NodeRequestConfig;
+        ledgerMaxAgeMs: number;
+    });
+    /**
+     * Choose a chain and a node, without reading anything from the chain itself.
+     *
+     * With `discovery`, the directory is asked which nodes exist and one of the active
+     * ones is taken. With `endpoint`, that node is used as given. Either way **no ledger
+     * is fetched here** — a ledger read is only valid for a few blocks, so it happens when
+     * a transaction is actually being built rather than when the app starts.
+     */
+    static connect(options: GeeqChainOptions): Promise<GeeqChain>;
+    /** {@link GeeqChain.connect}, and install the result as the process-wide default. */
+    static init(options: GeeqChainOptions): Promise<GeeqChain>;
+    /** The default chain. Throws `not-initialized` when there is none. */
+    static current(): GeeqChain;
+    /** Whether a default chain has been installed. */
+    static get initialized(): boolean;
+    /** Clear the default. Call this from `afterEach` so tests do not leak into each other. */
+    static reset(): void;
+    /** Resolve an amount to pennies, reading a `{ geeq }` figure at {@link penniesPerGeeq}. */
+    toPennies(amount: GeeqAmount): bigint;
+    /** Show pennies as a Geeq figure at {@link penniesPerGeeq}, as the Geeq wallet does. */
+    formatGeeq(pennies: bigint): string;
+    /**
+     * This chain's number.
+     *
+     * Known immediately when a directory named the chain, or once a ledger has been read.
+     * `undefined` in between — with a bare endpoint and no declared number, only the node
+     * can say.
+     */
+    get chainNumber(): number | undefined;
+    /**
+     * The node, once a ledger read has identified it in the net actor list.
+     *
+     * `undefined` until then: a node's number is the one thing the directory cannot say,
+     * so it is not known before the first read.
+     */
+    get node(): GeeqNode | undefined;
+    /** The net actor directory from the last ledger read, if there has been one. */
+    get nodes(): readonly GeeqLedgerNode[];
+    /** Those of them that accept transactions. */
+    get processingNodes(): readonly GeeqLedgerNode[];
+    /** The ledger from the last read, if it is still cached. */
+    get ledger(): GeeqLedger | undefined;
+    /**
+     * A URL for another node in this chain.
+     *
+     * Every node answers client traffic on {@link GEEQ_NODE_PORT}, so only the scheme is
+     * carried over from the endpoint in use. The port recorded against a node in the
+     * ledger is its own internal listener and is never what you connect to.
+     */
+    endpointFor(host: string): string;
+    /**
+     * The current ledger, from cache when it is fresh enough.
+     *
+     * Staleness is safe in exactly one direction. The node accepts a target block within
+     * `[N-8, N+1]` of its own head, and a cached ledger can only be *behind*, so the
+     * target it yields is never in the future — the only rejected direction. The default
+     * five seconds is set by the node list and metadata limits, which have no such
+     * tolerance, not by the block window.
+     */
+    getLedger(options?: {
+        readonly maxAgeMs?: number;
+        readonly signal?: AbortSignal;
+    }): Promise<GeeqLedger>;
+    /** Discard the cached ledger and read again. */
+    refresh(options?: {
+        readonly signal?: AbortSignal;
+    }): Promise<GeeqLedger>;
+    /**
+     * One read at a time.
+     *
+     * Same single-flight shape as `initGeeq`, including clearing the promise on failure so
+     * a later call can retry rather than being stuck with the first error. Without it, a
+     * page that builds several transactions at once pulls the whole ledger several times
+     * from an endpoint with no rate limiting of any kind.
+     *
+     * The read is shared, so it carries no caller's signal: one caller aborting must not
+     * fail the others waiting on it. Each caller stops waiting on its own signal instead,
+     * and the read runs on, bounded by `timeoutMs`, to fill the cache for whoever is next.
+     */
+    private read;
+    /**
+     * Everything a transaction must be pinned to, read from this chain.
+     *
+     * Throws rather than guessing when the account cannot sign: absent from the ledger
+     * (the ordinary state of an unfunded keypair), or present as a record type the
+     * protocol will not accept.
+     */
+    getChainState(request: ChainStateRequest): Promise<GeeqChainState>;
+    /**
+     * What every transaction built from `ledger` is pinned to, bar the signer's nonce: the
+     * same for a signer's own transaction and for a proxy's.
+     */
+    private pinnedTo;
+    /** {@link getChainState} against a ledger already in hand, so a build reads only one. */
+    private stateIn;
+    /**
+     * The ledger a build is made from, and the state of `signer` in it.
+     *
+     * A cached ledger is up to a few seconds old, so "this account already built against
+     * this block" may only mean "we are looking at an old block". Look again once before
+     * letting the nonce guard refuse — otherwise a caller who waited out the block interval
+     * is told to wait for a block that has already passed. An explicit nonce is the caller
+     * taking responsibility, so it skips the check.
+     *
+     * Everything the build then needs — what the sender holds, which proxies exist — comes
+     * from this same ledger, so it all describes one block.
+     */
+    private readForBuild;
+    /** Read afresh if `guardKey` already built against `ledger`'s block. See {@link readForBuild}. */
+    private recheckIfClaimed;
+    /**
+     * Build and sign an attestation, deriving everything the chain decides.
+     *
+     * This is where the ledger is read, because this is the first moment the values it
+     * carries are actually needed — and they go stale within a handful of blocks, so
+     * reading them any earlier would only mean reading them twice.
+     *
+     * The result is **not submitted**. Hand it to {@link GeeqSocket.track} first, so its
+     * verdict has somewhere to arrive, then POST `transaction` and `payload` to
+     * {@link AttestationTx.nodeUrl}; any other node rejects it, because the node number is
+     * checked with strict equality.
+     */
+    createAttestation(input: AttestationRequest): Promise<AttestationTx>;
+    /**
+     * Record the nonce a finished build took, so a second build against the same block is
+     * refused rather than sent to share it.
+     *
+     * Claimed only once a transaction really exists, so a build that failed validation does
+     * not consume the account's one nonce for this block. An explicit nonce is the caller
+     * taking responsibility, so it bypasses the guard entirely.
+     */
+    private claimNonce;
+    /**
+     * Resolve a recipient, checking the chain it belongs to when one is stated.
+     *
+     * An address carries a chain number, and an address from another chain is almost
+     * always a paste from the wrong place. The account id inside it would still be
+     * technically usable here, which is exactly why this is worth refusing rather than
+     * quietly sending.
+     */
+    private resolveRecipient;
+    /**
+     * Send coin to another account, and NFTs with it if you name them.
+     *
+     * Reads the ledger, so it also knows what the sender holds and what the chain's minimum
+     * transfer is. The amount is checked against the minimum, and the sender's NFTs against
+     * the ones named, before anything is signed; the balance against the amount plus the
+     * fee once the signed transaction gives the fee. NFTs always travel with coin: leave
+     * `amount` out and they go with the chain's minimum transfer.
+     *
+     * The result is **not submitted**. Hand it to {@link GeeqSocket.track} first, then POST
+     * `transaction` to {@link CoinTransferTx.nodeUrl} using `coinTransferSubmitBody`, which
+     * sends it as type `uvt` — a different shape from an attestation, and with no separate
+     * payload.
+     */
+    createTransfer(input: CoinTransferRequest): Promise<CoinTransferTx>;
+    /**
+     * The NFTs an account holds on this chain, in the order its record lists them, each with
+     * the hash and labels it was minted with.
+     *
+     * Which NFTs it holds comes from the validation layer ledger; what each stands for, from
+     * the application layer ledger, which is read afresh every time. An account the chain
+     * does not know holds none. A new NFT shows once a block has confirmed it, so pass
+     * `maxAgeMs: 0` to look straight after one was minted or sent.
+     */
+    findNfts(request: NftsRequest): Promise<readonly GeeqNft[]>;
+    /**
+     * The NFT mint proxies an admin has on this chain, each with its index, and the index
+     * its next proxy takes: one past the highest in use, or 1 for an admin with none.
+     *
+     * A proxy appears once a block has confirmed it, so pass `maxAgeMs: 0` to look
+     * straight after one was submitted.
+     */
+    findNftMintProxies(request: NftMintProxiesRequest): Promise<GeeqNftMintProxies>;
+    /**
+     * Create a proxy to mint NFTs through.
+     *
+     * A proxy is a record of its own: it holds coin, carries its own nonce, and names one
+     * admin — `admin` here — who signs every mint made through it. Its id is derived from
+     * the admin's key and an index, as the Geeq wallet derives it: by default the next
+     * index {@link findNftMintProxies} reports, so it is found again from the key alone.
+     *
+     * Checks the funding against the chain's minimum, and the admin's balance against the
+     * funding plus the fee. The result is **not submitted** — track it, then post it with
+     * `coinTransferSubmitBody`, exactly as a transfer. The proxy exists once a block
+     * confirms it.
+     */
+    createNftMintProxy(input: NftMintProxyRequest): Promise<NftMintProxyTx>;
+    /**
+     * Mint an NFT through one of the admin's proxies.
+     *
+     * The proxy is the sender: it pays the fee and the coin sent with the NFT, and spends
+     * its own nonce, not the admin's. The admin signs. The NFT itself is the content's hash
+     * and labels, as an attestation is, and its id is derived from them — so the same
+     * content with the same labels through the same proxy cannot be minted twice.
+     *
+     * Reads the ledger to find the proxy and check what it holds. The result is **not
+     * submitted** — track it, then post it with `attestationSubmitBody`, exactly as an
+     * attestation: two fields, as `uat`.
+     */
+    mintNft(input: NftMintRequest): Promise<NftMintTx>;
+    /**
+     * Whether a built transaction is now too old to send: the chain is past its
+     * `validUntilBlock`, and a node would refuse it with an HTTP 400.
+     *
+     * Reads the ledger afresh, because a cached one can only be behind the chain and would
+     * say "not yet" when it already is. Call it before submitting a transaction that may
+     * have waited.
+     */
+    isExpired(tx: {
+        readonly validUntilBlock: number;
+    }): Promise<boolean>;
+    /**
+     * Give back the nonce a built transaction took, because it will never be sent — the
+     * user changed something and is building again. The next build may then take the same
+     * nonce in the same block instead of being refused with `nonce-collision`.
+     *
+     * Only for a transaction that was not submitted: if it reaches the node as well as its
+     * rebuild, the two share a nonce and the node rejects both.
+     */
+    discard(tx: {
+        readonly transactionHash: Uint8Array;
+    }): void;
+    /** Forget which accounts have built a transaction against the current block. */
+    forgetNonces(): void;
+    /** Drop cached state, and step down as the default if this chain holds that slot. */
+    dispose(): void;
+    toJSON(): Record<string, unknown>;
+    toString(): string;
+}
+/**
+ * Connect to a chain and make it the default.
+ *
+ * Thin alias for {@link GeeqChain.init} — the name most applications reach for, and one
+ * line so there is no second implementation to keep in step.
+ *
+ * ```ts
+ * await initChain({ endpoint: 'https://1.2.3.4:2082' })
+ * const tx = await attest({ keypair, content: fileBytes })
+ * ```
+ */
+export declare function initChain(options: GeeqChainOptions): Promise<GeeqChain>;
+/** Build an attestation on the default chain. See {@link GeeqChain.createAttestation}. */
+export declare function attest(input: AttestationRequest): Promise<AttestationTx>;
+/** Send coin on the default chain. See {@link GeeqChain.createTransfer}. */
+export declare function transfer(input: CoinTransferRequest): Promise<CoinTransferTx>;