@geeqdev/geeq-sdk 0.1.0 → 0.2.0

package/dist/tests/fee.test.js

@@ -0,0 +1,179 @@
+import { afterEach, beforeAll, describe, expect, it } from '@jest/globals';
+import { GeeqChain, createAttestationTx, createCoinTransferTx, createNftMintProxyTx, createNftMintTx, decodeValidationLedger, generateKeypair, initGeeq, keypairFromMnemonic, } from '../src/index';
+import { WasmPayload, WasmUserAppTx, WasmUserValTx } from '../src/runtime/bindings';
+import { buildVll, vllResponse } from './fixtures/build-vll';
+import { fakeTransport } from './fixtures/fake-transport';
+/**
+ * The fee, as geeq_node_core charges it (wrappers/base.ts, calculateTransactionFee):
+ * geeqNorm per byte of the signed flatten (plus the payload's, for a UAT), and for anything
+ * that sends coin, a quarter of a percent of the amount, capped at geeqNorm x 10^7.
+ */
+const MNEMONIC = 'legal winner thank year wave sausage worth useful legal winner thank yellow';
+const ENDPOINT = 'https://10.0.0.1:2082';
+const ATTEST_HASH = new Uint8Array(32).fill(7);
+let sender;
+let receiver;
+beforeAll(async () => {
+    await initGeeq();
+    sender = await keypairFromMnemonic(MNEMONIC);
+    receiver = await generateKeypair();
+});
+afterEach(() => {
+    GeeqChain.reset();
+});
+const decode = (base64) => new Uint8Array(Buffer.from(base64, 'base64'));
+/** The node's own measure: the flatten with the signature, through the non-Data class. */
+function signedUvtBytes(transaction) {
+    const handle = WasmUserValTx.fromUserValTxCapnp(decode(transaction));
+    const length = handle.flatten().length;
+    handle.free();
+    return length;
+}
+function signedUatBytes(transaction, payload) {
+    const tx = WasmUserAppTx.fromUserAppTxCapnp(decode(transaction));
+    const body = WasmPayload.fromPayloadCapnp(decode(payload));
+    const length = tx.flatten().length + body.flatten().length;
+    tx.free();
+    body.free();
+    return length;
+}
+const state = (geeqNorm) => ({
+    chainNumber: 1,
+    blockNumber: 42,
+    nodeNumber: 3,
+    nonce: 7,
+    ...(geeqNorm === undefined ? {} : { geeqNorm }),
+});
+describe('the fee on a coin transfer', () => {
+    it('charges geeqNorm per signed byte, plus a quarter of a percent of the amount', async () => {
+        const tx = await createCoinTransferTx({
+            keypair: sender,
+            to: receiver.accountId,
+            amount: 10000n,
+            chainState: state(3n),
+        });
+        const bytes = signedUvtBytes(tx.transaction);
+        expect(tx.fee).toEqual({ total: BigInt(bytes) * 3n + 25n, data: BigInt(bytes) * 3n, coin: 25n, bytes });
+    });
+    it('rounds the coin part down, as the node divides', async () => {
+        const tx = await createCoinTransferTx({
+            keypair: sender,
+            to: receiver.accountId,
+            amount: 799n,
+            chainState: state(1n),
+        });
+        expect(tx.fee?.coin).toBe(1n);
+    });
+    it('caps the coin part at geeqNorm x 10^7', async () => {
+        const tx = await createCoinTransferTx({
+            keypair: sender,
+            to: receiver.accountId,
+            amount: 10n ** 12n,
+            chainState: state(2n),
+        });
+        expect(tx.fee?.coin).toBe(20000000n);
+    });
+    it('is undefined when the chain state has no geeqNorm to work it out from', async () => {
+        const tx = await createCoinTransferTx({
+            keypair: sender,
+            to: receiver.accountId,
+            amount: 150n,
+            ...state(),
+        });
+        expect(tx.fee).toBeUndefined();
+    });
+});
+describe('the fee on the other transactions', () => {
+    it('charges an attestation for the transaction and the payload, and nothing on coin', async () => {
+        const tx = await createAttestationTx({
+            keypair: sender,
+            attestHash: ATTEST_HASH,
+            metadata: ['Invoice 41'],
+            chainState: state(2n),
+        });
+        const bytes = signedUatBytes(tx.transaction, tx.payload);
+        expect(tx.fee).toEqual({ total: BigInt(bytes) * 2n, data: BigInt(bytes) * 2n, coin: 0n, bytes });
+    });
+    it('charges a proxy creation on its funding, as a transfer on its amount', async () => {
+        const tx = await createNftMintProxyTx({
+            keypair: sender,
+            index: 1,
+            amount: 4000n,
+            chainState: state(1n),
+        });
+        const bytes = signedUvtBytes(tx.transaction);
+        expect(tx.fee).toEqual({ total: BigInt(bytes) + 10n, data: BigInt(bytes), coin: 10n, bytes });
+    });
+    it('charges an NFT mint on the payload too, and on the coin sent with it', async () => {
+        const tx = await createNftMintTx({
+            keypair: sender,
+            proxyAccountId: new Uint8Array(32).fill(9),
+            attestHash: ATTEST_HASH,
+            to: receiver.accountId,
+            amount: 800n,
+            chainState: state(1n),
+        });
+        const bytes = signedUatBytes(tx.transaction, tx.payload);
+        expect(tx.fee).toEqual({ total: BigInt(bytes) + 2n, data: BigInt(bytes), coin: 2n, bytes });
+    });
+    it('refuses a geeqNorm that is not a bigint', async () => {
+        await expect(createCoinTransferTx({
+            keypair: sender,
+            to: receiver.accountId,
+            amount: 150n,
+            chainState: { ...state(), geeqNorm: 1 },
+        })).rejects.toMatchObject({ code: 'invalid-argument' });
+    });
+});
+describe('geeqNorm in the ledger', () => {
+    const nodes = [{ ip: '10.0.0.1', nodeNumber: 3 }];
+    it('is read from the parameter list', () => {
+        expect(decodeValidationLedger(buildVll({ nodes, geeqNorm: 5n })).geeqNorm).toBe(5n);
+    });
+    it('is undefined when the chain does not publish it', () => {
+        expect(decodeValidationLedger(buildVll({ nodes, geeqNorm: null })).geeqNorm).toBeUndefined();
+    });
+});
+describe('a chain checks the balance against the amount plus the fee', () => {
+    function connect(balance, overrides = {}) {
+        const body = vllResponse({
+            chainNumber: 1,
+            blockNumber: 41,
+            nodes: [{ ip: '10.0.0.1', nodeNumber: 3 }],
+            accounts: [{ accountId: sender.accountId, kind: 'asset', nonce: 7, balance }],
+            ...overrides,
+        });
+        return GeeqChain.connect({ penniesPerGeeq: 1000000000n, endpoint: ENDPOINT, transport: fakeTransport(() => ({ body })) });
+    }
+    const send = (chain) => chain.createTransfer({ from: sender, to: receiver.accountId, amount: { pennies: 1000n } });
+    it('puts the fee on what it builds, from the geeqNorm it read', async () => {
+        const tx = await send(await connect(100000n));
+        expect(tx.fee?.total).toBe(BigInt(signedUvtBytes(tx.transaction)) + 2n);
+        expect(tx.chainState.geeqNorm).toBe(1n);
+    });
+    it('accepts a balance of exactly the amount plus the fee, and refuses a penny less', async () => {
+        const fee = (await send(await connect(100000n))).fee?.total;
+        await expect(send(await connect(1000n + fee))).resolves.toBeDefined();
+        const short = send(await connect(1000n + fee - 1n));
+        await expect(short).rejects.toMatchObject({ code: 'insufficient-funds' });
+        await expect(short).rejects.toThrow(/needs 0\.000001 plus a fee of/u);
+    });
+    it('refuses an attestation the account cannot pay the fee for', async () => {
+        const attempt = (await connect(10n)).createAttestation({ keypair: sender, content: 'a deed' });
+        await expect(attempt).rejects.toMatchObject({ code: 'insufficient-funds' });
+        await expect(attempt).rejects.toThrow(/needs a fee of/u);
+    });
+    it('does not spend the nonce on a transaction it refused', async () => {
+        const fee = (await send(await connect(100000n))).fee?.total;
+        const chain = await connect(1000n + fee - 1n);
+        await expect(send(chain)).rejects.toMatchObject({ code: 'insufficient-funds' });
+        // Not a nonce-collision: the refused build never claimed the nonce.
+        await expect(send(chain)).rejects.toMatchObject({ code: 'insufficient-funds' });
+    });
+    it('checks only the amount when the chain publishes no geeqNorm', async () => {
+        const chain = await connect(1000n, { geeqNorm: null, minTxAmt: null });
+        const tx = await send(chain);
+        expect(tx.fee).toBeUndefined();
+    });
+});
+//# sourceMappingURL=fee.test.js.map

package/dist/tests/fee.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fee.test.js","sourceRoot":"","sources":["../../tests/fee.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,eAAe,CAAA;AAE1E,OAAO,EACL,SAAS,EACT,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,sBAAsB,EACtB,eAAe,EACf,QAAQ,EACR,mBAAmB,GACpB,MAAM,cAAc,CAAA;AAErB,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AACnF,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAE5D,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAEzD;;;;GAIG;AAEH,MAAM,QAAQ,GAAG,6EAA6E,CAAA;AAC9F,MAAM,QAAQ,GAAG,uBAAuB,CAAA;AACxC,MAAM,WAAW,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AAE9C,IAAI,MAAmB,CAAA;AACvB,IAAI,QAAqB,CAAA;AAEzB,SAAS,CAAC,KAAK,IAAI,EAAE;IACnB,MAAM,QAAQ,EAAE,CAAA;IAChB,MAAM,GAAG,MAAM,mBAAmB,CAAC,QAAQ,CAAC,CAAA;IAC5C,QAAQ,GAAG,MAAM,eAAe,EAAE,CAAA;AACpC,CAAC,CAAC,CAAA;AAEF,SAAS,CAAC,GAAG,EAAE;IACb,SAAS,CAAC,KAAK,EAAE,CAAA;AACnB,CAAC,CAAC,CAAA;AAEF,MAAM,MAAM,GAAG,CAAC,MAAc,EAAE,EAAE,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAA;AAEhF,0FAA0F;AAC1F,SAAS,cAAc,CAAC,WAAmB;IACzC,MAAM,MAAM,GAAG,aAAa,CAAC,kBAAkB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAA;IACpE,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,MAAM,CAAA;IACtC,MAAM,CAAC,IAAI,EAAE,CAAA;IACb,OAAO,MAAM,CAAA;AACf,CAAC;AAED,SAAS,cAAc,CAAC,WAAmB,EAAE,OAAe;IAC1D,MAAM,EAAE,GAAG,aAAa,CAAC,kBAAkB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAA;IAChE,MAAM,IAAI,GAAG,WAAW,CAAC,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAA;IAC1D,MAAM,MAAM,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,MAAM,CAAA;IAC1D,EAAE,CAAC,IAAI,EAAE,CAAA;IACT,IAAI,CAAC,IAAI,EAAE,CAAA;IACX,OAAO,MAAM,CAAA;AACf,CAAC;AAED,MAAM,KAAK,GAAG,CAAC,QAAiB,EAAE,EAAE,CAAC,CAAC;IACpC,WAAW,EAAE,CAAC;IACd,WAAW,EAAE,EAAE;IACf,UAAU,EAAE,CAAC;IACb,KAAK,EAAE,CAAC;IACR,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC;CAChD,CAAC,CAAA;AAEF,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;IAC1C,EAAE,CAAC,6EAA6E,EAAE,KAAK,IAAI,EAAE;QAC3F,MAAM,EAAE,GAAG,MAAM,oBAAoB,CAAC;YACpC,OAAO,EAAE,MAAM;YACf,EAAE,EAAE,QAAQ,CAAC,SAAS;YACtB,MAAM,EAAE,MAAO;YACf,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC;SACtB,CAAC,CAAA;QACF,MAAM,KAAK,GAAG,cAAc,CAAC,EAAE,CAAC,WAAW,CAAC,CAAA;QAE5C,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAA;IACzG,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;QAC9D,MAAM,EAAE,GAAG,MAAM,oBAAoB,CAAC;YACpC,OAAO,EAAE,MAAM;YACf,EAAE,EAAE,QAAQ,CAAC,SAAS;YACtB,MAAM,EAAE,IAAI;YACZ,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC;SACtB,CAAC,CAAA;QACF,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAC/B,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,uCAAuC,EAAE,KAAK,IAAI,EAAE;QACrD,MAAM,EAAE,GAAG,MAAM,oBAAoB,CAAC;YACpC,OAAO,EAAE,MAAM;YACf,EAAE,EAAE,QAAQ,CAAC,SAAS;YACtB,MAAM,EAAE,GAAG,IAAI,GAAG;YAClB,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC;SACtB,CAAC,CAAA;QACF,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,SAAW,CAAC,CAAA;IACxC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,uEAAuE,EAAE,KAAK,IAAI,EAAE;QACrF,MAAM,EAAE,GAAG,MAAM,oBAAoB,CAAC;YACpC,OAAO,EAAE,MAAM;YACf,EAAE,EAAE,QAAQ,CAAC,SAAS;YACtB,MAAM,EAAE,IAAI;YACZ,GAAG,KAAK,EAAE;SACX,CAAC,CAAA;QACF,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,aAAa,EAAE,CAAA;IAChC,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,mCAAmC,EAAE,GAAG,EAAE;IACjD,EAAE,CAAC,iFAAiF,EAAE,KAAK,IAAI,EAAE;QAC/F,MAAM,EAAE,GAAG,MAAM,mBAAmB,CAAC;YACnC,OAAO,EAAE,MAAM;YACf,UAAU,EAAE,WAAW;YACvB,QAAQ,EAAE,CAAC,YAAY,CAAC;YACxB,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC;SACtB,CAAC,CAAA;QACF,MAAM,KAAK,GAAG,cAAc,CAAC,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,OAAO,CAAC,CAAA;QAExD,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAA;IAClG,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,sEAAsE,EAAE,KAAK,IAAI,EAAE;QACpF,MAAM,EAAE,GAAG,MAAM,oBAAoB,CAAC;YACpC,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,CAAC;YACR,MAAM,EAAE,KAAM;YACd,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC;SACtB,CAAC,CAAA;QACF,MAAM,KAAK,GAAG,cAAc,CAAC,EAAE,CAAC,WAAW,CAAC,CAAA;QAE5C,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAA;IAC/F,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,sEAAsE,EAAE,KAAK,IAAI,EAAE;QACpF,MAAM,EAAE,GAAG,MAAM,eAAe,CAAC;YAC/B,OAAO,EAAE,MAAM;YACf,cAAc,EAAE,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;YAC1C,UAAU,EAAE,WAAW;YACvB,EAAE,EAAE,QAAQ,CAAC,SAAS;YACtB,MAAM,EAAE,IAAI;YACZ,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC;SACtB,CAAC,CAAA;QACF,MAAM,KAAK,GAAG,cAAc,CAAC,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,OAAO,CAAC,CAAA;QAExD,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAA;IAC7F,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;QACvD,MAAM,MAAM,CACV,oBAAoB,CAAC;YACnB,OAAO,EAAE,MAAM;YACf,EAAE,EAAE,QAAQ,CAAC,SAAS;YACtB,MAAM,EAAE,IAAI;YACZ,UAAU,EAAE,EAAE,GAAG,KAAK,EAAE,EAAE,QAAQ,EAAE,CAAsB,EAAE;SAC7D,CAAC,CACH,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC,CAAA;IACvD,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,MAAM,KAAK,GAAG,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAA;IAEjD,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,CAAC,sBAAsB,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACrF,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,CAAC,sBAAsB,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,aAAa,EAAE,CAAA;IAC9F,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,4DAA4D,EAAE,GAAG,EAAE;IAC1E,SAAS,OAAO,CAAC,OAAe,EAAE,YAA2B,EAAE;QAC7D,MAAM,IAAI,GAAG,WAAW,CAAC;YACvB,WAAW,EAAE,CAAC;YACd,WAAW,EAAE,EAAE;YACf,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;YAC1C,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC;YAC7E,GAAG,SAAS;SACb,CAAC,CAAA;QACF,OAAO,SAAS,CAAC,OAAO,CAAC,EAAE,cAAc,EAAE,WAAc,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAA;IAC9H,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,KAAgB,EAAE,EAAE,CAChC,KAAK,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,KAAM,EAAE,EAAE,CAAC,CAAA;IAE7F,EAAE,CAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;QACzE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,OAAO,CAAC,OAAQ,CAAC,CAAC,CAAA;QAC9C,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,GAAG,EAAE,CAAC,CAAA;QACvE,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACzC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,gFAAgF,EAAE,KAAK,IAAI,EAAE;QAC9F,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,CAAC,MAAM,OAAO,CAAC,OAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,KAAe,CAAA;QAEtE,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,OAAO,CAAC,KAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAA;QAEtE,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,OAAO,CAAC,KAAM,GAAG,GAAG,GAAG,EAAE,CAAC,CAAC,CAAA;QACpD,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC,CAAA;QACzE,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,gCAAgC,CAAC,CAAA;IACvE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;QACzE,MAAM,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAA;QAC9F,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC,CAAA;QAC3E,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAA;IAC1D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACpE,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,CAAC,MAAM,OAAO,CAAC,OAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,KAAe,CAAA;QACtE,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,KAAM,GAAG,GAAG,GAAG,EAAE,CAAC,CAAA;QAE9C,MAAM,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC,CAAA;QAC/E,oEAAoE;QACpE,MAAM,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC,CAAA;IACjF,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6DAA6D,EAAE,KAAK,IAAI,EAAE;QAC3E,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,KAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAA;QACvE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,CAAA;QAC5B,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,aAAa,EAAE,CAAA;IAChC,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/tests/fixtures/build-vll.d.ts

@@ -0,0 +1,71 @@
+import { NetActorStatus, NetActorType } from '../../src/capnp/netActorRec.capnp';
+/**
+ * Build a validation layer ledger for tests.
+ *
+ * A builder rather than a recorded blob on purpose: a captured `.b64` rots silently the
+ * day the schema moves, whereas this stops compiling. The trade is that it proves the
+ * SDK's logic, not that a real node's bytes parse — for that, capture one real response
+ * and add a golden test beside these.
+ */
+export interface FixtureNode {
+    readonly ip: string;
+    readonly port?: number;
+    readonly nodeNumber: number;
+    readonly type?: NetActorType;
+    readonly status?: NetActorStatus;
+    readonly sponsorNumber?: number;
+    /** `blockNumRemove`. Defaults to well clear of the ledger's block. */
+    readonly retiresAtBlock?: number;
+}
+export interface FixtureAccount {
+    readonly accountId: Uint8Array;
+    /** `'asset-empty'` sets the ASSET tag but leaves the pointer null — the zero-value trap. */
+    readonly kind: 'asset' | 'hl' | 'micro' | 'asset-empty';
+    readonly nonce?: number;
+    /** Balance in pennies. Defaults to 1,000 geeq, enough that transfers are not the limit. */
+    readonly balance?: bigint;
+    /** NFT ids an asset record holds, in order. */
+    readonly nfts?: readonly (Uint8Array | {
+        readonly id: Uint8Array;
+        readonly counterparty: true;
+    })[];
+}
+export interface FixtureLedger {
+    readonly chainNumber?: number;
+    readonly blockNumber?: number;
+    readonly nodes?: readonly FixtureNode[];
+    readonly accounts?: readonly FixtureAccount[];
+    /** `null` omits the parameter entirely, so the limits come back undefined. */
+    readonly metadataVarNum?: number | null;
+    readonly metadataVarBytes?: number | null;
+    /** The two parameters a chain's minimum transfer is computed from. */
+    readonly minTxAmt?: bigint | null;
+    readonly geeqNorm?: bigint | null;
+    /** Omitted means no proxy list at all, as a ledger without proxies may carry. */
+    readonly proxies?: readonly FixtureProxy[];
+}
+export interface FixtureProxy {
+    readonly accountId: Uint8Array;
+    /** Defaults to `'nft-mint'`. */
+    readonly kind?: 'nft-mint' | 'funding';
+    /** The admin's account id, for an NFT mint proxy. */
+    readonly admin?: Uint8Array;
+    readonly nonce?: number;
+    readonly balance?: bigint;
+}
+export declare function buildVll(spec?: FixtureLedger): Uint8Array;
+/** The same bytes as a node would serve them. */
+export declare function vllBase64(spec?: FixtureLedger): string;
+/** A whole `GET /api/blocks?type=vll` response body. */
+export declare function vllResponse(spec?: FixtureLedger): string;
+export interface FixtureNftRecord {
+    readonly id: Uint8Array;
+    readonly attestHash: Uint8Array;
+    readonly metadata?: readonly string[];
+}
+/**
+ * A whole `GET /api/blocks?type=all` response body: an application layer ledger holding
+ * these NFT records, and an attestation-style record first so a reader has to skip it.
+ */
+export declare function allResponse(nfts?: readonly FixtureNftRecord[]): string;
+export { NetActorStatus, NetActorType };

package/dist/tests/fixtures/build-vll.js

@@ -0,0 +1,141 @@
+import { Message } from 'capnp-ts';
+import { ValLayLedger } from '../../src/capnp/valLayLedger.capnp';
+import { AppLayLedger } from '../../src/capnp/appLayLedger.capnp';
+import { NetActorStatus, NetActorType, } from '../../src/capnp/netActorRec.capnp';
+import { penniesToUint64 } from '../../src/amount';
+export function buildVll(spec = {}) {
+    const message = new Message();
+    const vll = message.initRoot(ValLayLedger);
+    vll.setChainNum(spec.chainNumber ?? 1);
+    vll.setBlockNum(spec.blockNumber ?? 41);
+    const nodes = spec.nodes ?? [{ ip: '127.0.0.1', nodeNumber: 3 }];
+    const netActors = vll.initNetActorList().initNetActorRecs(nodes.length);
+    nodes.forEach((node, index) => {
+        const record = netActors.get(index);
+        record.setIpAddr(node.ip);
+        record.setPortNum(node.port ?? 2082);
+        record.setNodeNumSelf(node.nodeNumber);
+        record.setNodeNumSponsor(node.sponsorNumber ?? 99);
+        // Real ledgers set this 100–355 blocks ahead on promotion. The capnp zero value
+        // would read as "already rotating out", so every fixture node gets a real one.
+        record.setBlockNumRemove(node.retiresAtBlock ?? (spec.blockNumber ?? 41) + 200);
+        // Both are set explicitly on every node, always. The capnp zero values are
+        // ANCHOR_NODE + CHAIN_ADMIN, which is NOT processing-capable, so a forgotten setter
+        // would quietly build a node that can never be selected.
+        record.setNetActorType(node.type ?? NetActorType.NET_ACTOR_TYPE_ANON_NODE);
+        record.setRecStatus(node.status ?? NetActorStatus.NET_ACTOR_STATUS_NODE);
+        record.initAcctNumVal(32);
+        record.getAcctNumVal().copyBuffer(new Uint8Array(32).fill(0xa0 + index));
+    });
+    // Two shapes of parameter: the metadata ones are 16-bit counts, the transfer ones are
+    // 64-bit penny amounts. Building them separately keeps each loop honest about its type.
+    const counts = [];
+    if (spec.metadataVarNum !== null)
+        counts.push(['num', spec.metadataVarNum ?? 4]);
+    if (spec.metadataVarBytes !== null)
+        counts.push(['bytes', spec.metadataVarBytes ?? 64]);
+    const amounts = [];
+    if (spec.minTxAmt !== null)
+        amounts.push(['minTxAmt', spec.minTxAmt ?? 1n]);
+    if (spec.geeqNorm !== null)
+        amounts.push(['geeqNorm', spec.geeqNorm ?? 1n]);
+    const paramRecs = vll.initParamAcctList().initParamAcctRecs(counts.length + amounts.length);
+    counts.forEach(([kind, value], index) => {
+        const paramType = paramRecs.get(index).initParamType();
+        const slot = kind === 'num' ? paramType.initMetadataVarNum() : paramType.initMetadataVarBytes();
+        slot.setCurrentValue(value);
+        // Min and max are deliberately different from the current value, so a decoder that
+        // reads the wrong accessor fails the test instead of coincidentally passing.
+        slot.setMinimumValue(0);
+        slot.setMaximumValue(0xffff);
+    });
+    amounts.forEach(([kind, value], index) => {
+        const paramType = paramRecs.get(counts.length + index).initParamType();
+        const slot = kind === 'minTxAmt' ? paramType.initMinTxAmt() : paramType.initGeeqNorm();
+        slot.setCurrentValue(penniesToUint64(value));
+    });
+    const accounts = spec.accounts ?? [];
+    const coinAccounts = vll.initCoinAcctRecs(accounts.length);
+    accounts.forEach((account, index) => {
+        const record = coinAccounts.get(index);
+        record.initAcctNumVal(32);
+        record.getAcctNumVal().copyBuffer(account.accountId);
+        record.setAmtCoin(penniesToUint64(account.balance ?? 1000000000000n));
+        const recType = record.getRecType();
+        if (account.kind === 'asset') {
+            const asset = recType.initAsset();
+            asset.setNonce(account.nonce ?? 0);
+            const nfts = account.nfts ?? [];
+            const list = asset.initNftAssetSubgroups(nfts.length);
+            nfts.forEach((nft, position) => {
+                const id = nft instanceof Uint8Array ? nft : nft.id;
+                list.get(position).initAcctNumApp(32).copyBuffer(id);
+                list.get(position).setFlagCounterpartyNft(!(nft instanceof Uint8Array));
+            });
+        }
+        else if (account.kind === 'hl')
+            recType.initHl();
+        else if (account.kind === 'micro')
+            recType.initMicro().setNonce(account.nonce ?? 0);
+        // 'asset-empty' writes nothing: the union keeps its ASSET zero tag with a null
+        // pointer, which is the case that makes a naive reader return nonce 0.
+    });
+    if (spec.proxies !== undefined) {
+        const proxyRecs = vll.initProxyAcctRecs(spec.proxies.length);
+        spec.proxies.forEach((proxy, index) => {
+            const record = proxyRecs.get(index);
+            record.initAcctNumVal(32);
+            record.getAcctNumVal().copyBuffer(proxy.accountId);
+            // A node starts every new proxy at 1.
+            record.setNonce(proxy.nonce ?? 1);
+            record.setAmtCoin(penniesToUint64(proxy.balance ?? 500n));
+            if (proxy.kind === 'funding') {
+                record.getRecType().initFunding();
+            }
+            else {
+                const nftMint = record.getRecType().initNftMint();
+                nftMint.initAcctNumAdminUser(32);
+                nftMint.getAcctNumAdminUser().copyBuffer(proxy.admin ?? new Uint8Array(32));
+            }
+        });
+    }
+    return new Uint8Array(message.toPackedArrayBuffer());
+}
+/** The same bytes as a node would serve them. */
+export function vllBase64(spec = {}) {
+    return Buffer.from(buildVll(spec)).toString('base64');
+}
+/** A whole `GET /api/blocks?type=vll` response body. */
+export function vllResponse(spec = {}) {
+    return JSON.stringify({ result: vllBase64(spec) });
+}
+/**
+ * A whole `GET /api/blocks?type=all` response body: an application layer ledger holding
+ * these NFT records, and an attestation-style record first so a reader has to skip it.
+ */
+export function allResponse(nfts = []) {
+    const message = new Message();
+    const all = message.initRoot(AppLayLedger);
+    all.setChainNum(1);
+    all.setBlockNum(41);
+    const records = all.initAppLayRecs(nfts.length + 1);
+    records.get(0).getRecType().initStackable().initAttestationSubgroups(0);
+    records.get(0).initAcctNumApp(32).copyBuffer(new Uint8Array(32).fill(0xee));
+    nfts.forEach((nft, index) => {
+        const record = records.get(index + 1);
+        record.initAcctNumApp(32).copyBuffer(nft.id);
+        const data = record.getRecType().initNft().initAttestationSubgroup().initData();
+        data.initAttestHash(32).copyBuffer(nft.attestHash);
+        const labels = nft.metadata ?? [];
+        // Written in reverse with their positions, so a reader that ignores position fails.
+        const list = data.initMetadata(labels.length);
+        labels.forEach((label, position) => {
+            const entry = list.get(labels.length - 1 - position);
+            entry.setPosition(position + 1);
+            entry.initItem(Buffer.byteLength(label)).copyBuffer(new TextEncoder().encode(label));
+        });
+    });
+    return JSON.stringify({ result: Buffer.from(message.toPackedArrayBuffer()).toString('base64') });
+}
+export { NetActorStatus, NetActorType };
+//# sourceMappingURL=build-vll.js.map

package/dist/tests/fixtures/build-vll.js.map

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

package/dist/tests/fixtures/fake-socket.d.ts

@@ -0,0 +1,44 @@
+import type { GeeqWebSocketFactory, GeeqWebSocketLike, GeeqWebSocketMessageEvent } from '../../src/index';
+/**
+ * A WebSocket driven by a script instead of a node.
+ *
+ * The SDK's socket type is a structural subset of the browser's, so this needs no library:
+ * it records what was sent and lets a test decide when the handshake completes, what the
+ * node says, and when the connection drops.
+ */
+export declare class FakeSocket implements GeeqWebSocketLike {
+    readonly url: string;
+    readyState: number;
+    readonly sent: string[];
+    private readonly listeners;
+    constructor(url: string);
+    addEventListener(type: 'open', listener: (event: unknown) => void): void;
+    addEventListener(type: 'message', listener: (event: GeeqWebSocketMessageEvent) => void): void;
+    addEventListener(type: 'close', listener: (event: unknown) => void): void;
+    addEventListener(type: 'error', listener: (event: unknown) => void): void;
+    send(data: string): void;
+    close(): void;
+    /** Complete the handshake. */
+    open(): void;
+    /** The node sends a frame. Objects are sent as JSON, strings as they are. */
+    receive(frame: unknown): void;
+    /** The connection is lost, as a proxy timeout or a node restart would lose it. */
+    drop(): void;
+    /** What the SDK sent, parsed, leaving out the keepalive. */
+    frames(): {
+        event: string;
+        payload?: unknown;
+    }[];
+    private fire;
+}
+export interface FakeSocketFactory extends GeeqWebSocketFactory {
+    readonly sockets: FakeSocket[];
+    /** The most recently opened connection. */
+    last(): FakeSocket;
+}
+export declare function fakeSocketFactory(): FakeSocketFactory;
+/** A `uut_status` frame as a node sends it. */
+export declare function uutStatus(refHash: string, status: 'nonsane' | 'incorrectlyIncluded' | 'invalid' | 'valid', extra?: Record<string, unknown>): {
+    event: 'uut_status';
+    payload: Record<string, unknown>;
+};

package/dist/tests/fixtures/fake-socket.js

@@ -0,0 +1,93 @@
+/**
+ * A WebSocket driven by a script instead of a node.
+ *
+ * The SDK's socket type is a structural subset of the browser's, so this needs no library:
+ * it records what was sent and lets a test decide when the handshake completes, what the
+ * node says, and when the connection drops.
+ */
+export class FakeSocket {
+    constructor(url) {
+        this.url = url;
+        this.readyState = 0;
+        this.sent = [];
+        this.listeners = {
+            open: [],
+            message: [],
+            close: [],
+            error: [],
+        };
+    }
+    addEventListener(type, listener) {
+        this.listeners[type].push(listener);
+    }
+    send(data) {
+        if (this.readyState !== 1)
+            throw new Error('InvalidStateError: the socket is not open');
+        this.sent.push(data);
+    }
+    close() {
+        if (this.readyState === 3)
+            return;
+        this.readyState = 3;
+        this.fire('close', { code: 1000 });
+    }
+    /** Complete the handshake. */
+    open() {
+        this.readyState = 1;
+        this.fire('open', {});
+    }
+    /** The node sends a frame. Objects are sent as JSON, strings as they are. */
+    receive(frame) {
+        this.fire('message', { data: typeof frame === 'string' ? frame : JSON.stringify(frame) });
+    }
+    /** The connection is lost, as a proxy timeout or a node restart would lose it. */
+    drop() {
+        this.readyState = 3;
+        this.fire('error', {});
+        this.fire('close', { code: 1006 });
+    }
+    /** What the SDK sent, parsed, leaving out the keepalive. */
+    frames() {
+        return this.sent.filter((frame) => frame !== 'ping').map((frame) => JSON.parse(frame));
+    }
+    fire(type, event) {
+        for (const listener of [...this.listeners[type]])
+            listener(event);
+    }
+}
+export function fakeSocketFactory() {
+    const sockets = [];
+    const factory = (url) => {
+        const socket = new FakeSocket(url);
+        sockets.push(socket);
+        return socket;
+    };
+    return Object.assign(factory, {
+        sockets,
+        last: () => {
+            const socket = sockets[sockets.length - 1];
+            if (socket === undefined)
+                throw new Error('no socket has been opened');
+            return socket;
+        },
+    });
+}
+/** A `uut_status` frame as a node sends it. */
+export function uutStatus(refHash, status, extra = {}) {
+    return {
+        event: 'uut_status',
+        payload: {
+            refHash,
+            publicKeys: ['AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA='],
+            blockNumber: 42,
+            vlbBlock: 43,
+            isValid: status === 'valid',
+            status,
+            error: status === 'valid' ? '' : `${status} because the test said so`,
+            type: 'outgoing',
+            createdAt: 'Date:Wed Sep 30 2026 10:00:00 GMT+0000 (Coordinated Universal Time)',
+            ...extra,
+        },
+    };
+}
+//# sourceMappingURL=fake-socket.js.map

package/dist/tests/fixtures/fake-socket.js.map

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

package/dist/tests/fixtures/fake-transport.d.ts

@@ -0,0 +1,24 @@
+import type { GeeqRequestInit, GeeqTransport } from '../../src/index';
+export interface FakeReply {
+    readonly status?: number;
+    readonly body: string;
+}
+export interface FakeCall {
+    readonly url: string;
+    readonly init: GeeqRequestInit | undefined;
+}
+export type FakeHandler = (url: string, init: GeeqRequestInit | undefined, callIndex: number) => FakeReply | Error;
+export interface FakeTransport extends GeeqTransport {
+    readonly calls: FakeCall[];
+}
+/**
+ * A transport driven by a script instead of a network.
+ *
+ * The SDK's transport type is a structural subset of `fetch`, so this needs no library
+ * and no live node — returning an object with `ok`, `status` and `text()` is enough.
+ * Throwing from the handler reproduces a transport failure, which is what a browser
+ * reports for CORS, TLS distrust, mixed content and an unreachable host alike.
+ */
+export declare function fakeTransport(script: FakeReply | Error | FakeHandler): FakeTransport;
+/** A transport failure carrying a Node-style code, as undici and friends produce. */
+export declare function networkError(code: string, message?: string): Error;

package/dist/tests/fixtures/fake-transport.js

@@ -0,0 +1,30 @@
+/**
+ * A transport driven by a script instead of a network.
+ *
+ * The SDK's transport type is a structural subset of `fetch`, so this needs no library
+ * and no live node — returning an object with `ok`, `status` and `text()` is enough.
+ * Throwing from the handler reproduces a transport failure, which is what a browser
+ * reports for CORS, TLS distrust, mixed content and an unreachable host alike.
+ */
+export function fakeTransport(script) {
+    const calls = [];
+    const transport = async (url, init) => {
+        const index = calls.length;
+        calls.push({ url, init });
+        const reply = typeof script === 'function' ? script(url, init, index) : script;
+        if (reply instanceof Error)
+            throw reply;
+        const status = reply.status ?? 200;
+        return {
+            ok: status >= 200 && status < 300,
+            status,
+            text: async () => reply.body,
+        };
+    };
+    return Object.assign(transport, { calls });
+}
+/** A transport failure carrying a Node-style code, as undici and friends produce. */
+export function networkError(code, message = code) {
+    return Object.assign(new Error(message), { code });
+}
+//# sourceMappingURL=fake-transport.js.map

package/dist/tests/fixtures/fake-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-transport.js","sourceRoot":"","sources":["../../../tests/fixtures/fake-transport.ts"],"names":[],"mappings":"AAsBA;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,MAAuC;IACnE,MAAM,KAAK,GAAe,EAAE,CAAA;IAE5B,MAAM,SAAS,GAAG,KAAK,EAAE,GAAW,EAAE,IAAsB,EAAE,EAAE;QAC9D,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAA;QAC1B,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAA;QAEzB,MAAM,KAAK,GAAG,OAAO,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;QAC9E,IAAI,KAAK,YAAY,KAAK;YAAE,MAAM,KAAK,CAAA;QAEvC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,GAAG,CAAA;QAClC,OAAO;YACL,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG;YACjC,MAAM;YACN,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI;SAC7B,CAAA;IACH,CAAC,CAAA;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,CAAA;AAC5C,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,OAAO,GAAG,IAAI;IACvD,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAA;AACpD,CAAC"}

package/dist/tests/keypair.test.d.ts

@@ -0,0 +1 @@
+export {};