@geeqdev/geeq-sdk 0.1.0 → 0.2.0

package/dist/src/crypto/keypair.js

@@ -0,0 +1,158 @@
+import { toBase64 } from '../encoding/base64';
+import { invalidArgument, invalidKey } from '../errors';
+import { WasmKeypair, wasmVerify } from '../runtime/bindings';
+import { assertReady, initGeeq } from '../runtime/init';
+import { DEFAULT_RECORD_TYPE, toWasmCoinType, toWasmRecordType } from '../address/record-type';
+import { createWalletAddressSync } from '../address/wallet-address';
+import { PUBLIC_KEY_BYTES, accountIdFromPublicKey } from './account-id';
+import { normalizeMnemonic } from './mnemonic';
+const SECRET_KEY_BYTES = 32;
+const SIGNATURE_BYTES = 64;
+/**
+ * Wraps an engine-side keypair. The byte fields are copied out once at
+ * construction so the object stays fully readable after {@link dispose}, which
+ * only releases the engine handle used for signing.
+ */
+class Keypair {
+    constructor(inner) {
+        this.handle = inner;
+        Object.defineProperty(this, 'handle', { enumerable: false });
+        this.publicKey = inner.exportPublicKey();
+        this.privateKey = inner.exportSecretKey();
+        this.accountId = accountIdFromPublicKey(this.publicKey);
+    }
+    getAddress(options) {
+        return createWalletAddressSync({
+            accountId: this.accountId,
+            chainNumber: options.chainNumber,
+            recordType: options.recordType ?? DEFAULT_RECORD_TYPE,
+        });
+    }
+    sign(message) {
+        if (this.handle === null) {
+            throw invalidKey('This keypair has been disposed and can no longer sign.');
+        }
+        if (!(message instanceof Uint8Array)) {
+            throw invalidArgument('sign() expects a Uint8Array.');
+        }
+        return this.handle.sign(message);
+    }
+    dispose() {
+        this.handle?.free();
+        this.handle = null;
+    }
+    /** Keeps secret material out of logs, `console.log` and error breadcrumbs. */
+    toJSON() {
+        return { type: 'GeeqKeypair', publicKey: toBase64(this.publicKey) };
+    }
+    toString() {
+        return '[GeeqKeypair]';
+    }
+}
+function assertBytes(value, expected, label) {
+    if (!(value instanceof Uint8Array)) {
+        throw invalidKey(`${label} must be a Uint8Array.`);
+    }
+    if (value.length !== expected) {
+        throw invalidKey(`${label} must be ${expected} bytes, received ${value.length}.`);
+    }
+    return value;
+}
+/** Create a brand new random keypair. Synchronous; requires a loaded engine. */
+export function generateKeypairSync() {
+    assertReady('generateKeypairSync');
+    return new Keypair(WasmKeypair.generate());
+}
+/** Create a brand new random keypair, loading the engine if needed. */
+export async function generateKeypair() {
+    await initGeeq();
+    return generateKeypairSync();
+}
+/** Re-create a keypair from stored public and private key bytes. */
+export function importKeypairSync(publicKey, privateKey) {
+    assertReady('importKeypairSync');
+    assertBytes(publicKey, PUBLIC_KEY_BYTES, 'publicKey');
+    assertBytes(privateKey, SECRET_KEY_BYTES, 'privateKey');
+    let keypair;
+    try {
+        // Deliberately derived from the secret key rather than via the engine's
+        // import(), which accepts a mismatched pair and stores the given public key
+        // verbatim — yielding a keypair whose signatures the chain would reject.
+        keypair = new Keypair(WasmKeypair.fromSecretKey(privateKey));
+    }
+    catch (cause) {
+        throw invalidKey('Could not import this keypair. Check the private key is correct.', cause);
+    }
+    if (!bytesEqual(keypair.publicKey, publicKey)) {
+        keypair.dispose();
+        throw invalidKey('publicKey does not match privateKey. Check the two halves came from the same keypair.');
+    }
+    return keypair;
+}
+/** Re-create a keypair from stored key bytes, loading the engine if needed. */
+export async function importKeypair(publicKey, privateKey) {
+    await initGeeq();
+    return importKeypairSync(publicKey, privateKey);
+}
+/** Recover a keypair from its 32-byte secret key alone. */
+export function keypairFromSecretKeySync(privateKey) {
+    assertReady('keypairFromSecretKeySync');
+    assertBytes(privateKey, SECRET_KEY_BYTES, 'privateKey');
+    try {
+        return new Keypair(WasmKeypair.fromSecretKey(privateKey));
+    }
+    catch (cause) {
+        throw invalidKey('Could not derive a keypair from this secret key.', cause);
+    }
+}
+/** Recover a keypair from its secret key, loading the engine if needed. */
+export async function keypairFromSecretKey(privateKey) {
+    await initGeeq();
+    return keypairFromSecretKeySync(privateKey);
+}
+/**
+ * Derive a keypair from a BIP-39 mnemonic along Geeq's standard derivation path.
+ *
+ * The same mnemonic and options always produce the same keypair, so this is how a
+ * wallet is restored on another device.
+ */
+export function keypairFromMnemonicSync(mnemonic, options = {}) {
+    assertReady('keypairFromMnemonicSync');
+    if (typeof mnemonic !== 'string' || mnemonic.trim().length === 0) {
+        throw invalidArgument('mnemonic must be a non-empty BIP-39 phrase.');
+    }
+    const account = options.account ?? 0;
+    const addressIndex = options.addressIndex ?? 0;
+    for (const [label, value] of [['account', account], ['addressIndex', addressIndex]]) {
+        if (!Number.isInteger(value) || value < 0 || value > 0x7fffffff) {
+            throw invalidArgument(`${label} must be an integer between 0 and 2147483647.`);
+        }
+    }
+    try {
+        return new Keypair(WasmKeypair.tryFromMnemonicGeeqPath(normalizeMnemonic(mnemonic), options.passphrase ?? '', toWasmRecordType(options.recordType ?? DEFAULT_RECORD_TYPE), toWasmCoinType(options.coinType ?? 'mainnet'), account, addressIndex));
+    }
+    catch (cause) {
+        throw invalidKey('Could not derive a keypair from this mnemonic. Check the words and the passphrase.', cause);
+    }
+}
+/** Derive a keypair from a mnemonic, loading the engine if needed. */
+export async function keypairFromMnemonic(mnemonic, options = {}) {
+    await initGeeq();
+    return keypairFromMnemonicSync(mnemonic, options);
+}
+/** Verify an Ed25519 signature. Requires a loaded engine. */
+export function verifySignature(publicKey, signature, message) {
+    assertReady('verifySignature');
+    assertBytes(publicKey, PUBLIC_KEY_BYTES, 'publicKey');
+    assertBytes(signature, SIGNATURE_BYTES, 'signature');
+    return wasmVerify(publicKey, signature, message);
+}
+function bytesEqual(a, b) {
+    if (a.length !== b.length)
+        return false;
+    let diff = 0;
+    for (let i = 0; i < a.length; i += 1)
+        diff |= a[i] ^ b[i];
+    return diff === 0;
+}
+//# sourceMappingURL=keypair.js.map

package/dist/src/crypto/keypair.js.map

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

package/dist/src/crypto/mnemonic.d.ts

@@ -0,0 +1,34 @@
+/** Supported mnemonic lengths. 12 words is the common default; 24 is the strongest. */
+export type MnemonicWordCount = 12 | 15 | 18 | 21 | 24;
+export declare const MNEMONIC_WORD_COUNTS: readonly [12, 15, 18, 21, 24];
+export interface GenerateMnemonicOptions {
+    /** How many words to generate. Defaults to 12. */
+    readonly words?: MnemonicWordCount;
+}
+/**
+ * Generate a fresh BIP-39 recovery phrase, using the platform's cryptographically
+ * secure random source.
+ *
+ * Pure JavaScript — no engine needed, so this works before {@link initGeeq}
+ * resolves. Phrases are generated from the English wordlist, which is what
+ * {@link keypairFromMnemonic} expects.
+ *
+ * The phrase is the *only* way to recover the wallet. Show it to the user once,
+ * let them write it down, and never transmit or persist it in plaintext.
+ *
+ * ```ts
+ * const mnemonic = generateMnemonic()            // 12 words
+ * const long = generateMnemonic({ words: 24 })   // 24 words
+ * ```
+ */
+export declare function generateMnemonic(options?: GenerateMnemonicOptions): string;
+/**
+ * Check a recovery phrase for the right word count, known words, and a valid
+ * checksum. Use it to give immediate feedback on a restore form rather than
+ * waiting for {@link keypairFromMnemonic} to throw.
+ *
+ * Pure JavaScript — no engine needed.
+ */
+export declare function validateMnemonic(mnemonic: string): boolean;
+/** Trim and collapse whitespace so pasted phrases validate as typed ones do. */
+export declare function normalizeMnemonic(mnemonic: string): string;

package/dist/src/crypto/mnemonic.js

@@ -0,0 +1,57 @@
+import { generateMnemonic as scureGenerate, validateMnemonic as scureValidate } from '@scure/bip39';
+import { wordlist } from '@scure/bip39/wordlists/english';
+import { invalidArgument } from '../errors';
+const ENTROPY_BITS = {
+    12: 128,
+    15: 160,
+    18: 192,
+    21: 224,
+    24: 256,
+};
+export const MNEMONIC_WORD_COUNTS = Object.freeze([12, 15, 18, 21, 24]);
+/**
+ * Generate a fresh BIP-39 recovery phrase, using the platform's cryptographically
+ * secure random source.
+ *
+ * Pure JavaScript — no engine needed, so this works before {@link initGeeq}
+ * resolves. Phrases are generated from the English wordlist, which is what
+ * {@link keypairFromMnemonic} expects.
+ *
+ * The phrase is the *only* way to recover the wallet. Show it to the user once,
+ * let them write it down, and never transmit or persist it in plaintext.
+ *
+ * ```ts
+ * const mnemonic = generateMnemonic()            // 12 words
+ * const long = generateMnemonic({ words: 24 })   // 24 words
+ * ```
+ */
+export function generateMnemonic(options = {}) {
+    const words = options.words ?? 12;
+    const bits = ENTROPY_BITS[words];
+    if (bits === undefined) {
+        throw invalidArgument(`words must be one of ${MNEMONIC_WORD_COUNTS.join(', ')}, received ${String(words)}.`);
+    }
+    return scureGenerate(wordlist, bits);
+}
+/**
+ * Check a recovery phrase for the right word count, known words, and a valid
+ * checksum. Use it to give immediate feedback on a restore form rather than
+ * waiting for {@link keypairFromMnemonic} to throw.
+ *
+ * Pure JavaScript — no engine needed.
+ */
+export function validateMnemonic(mnemonic) {
+    if (typeof mnemonic !== 'string')
+        return false;
+    try {
+        return scureValidate(normalizeMnemonic(mnemonic), wordlist);
+    }
+    catch {
+        return false;
+    }
+}
+/** Trim and collapse whitespace so pasted phrases validate as typed ones do. */
+export function normalizeMnemonic(mnemonic) {
+    return mnemonic.trim().replace(/\s+/gu, ' ').toLowerCase();
+}
+//# sourceMappingURL=mnemonic.js.map

package/dist/src/crypto/mnemonic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mnemonic.js","sourceRoot":"","sources":["../../../src/crypto/mnemonic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,IAAI,aAAa,EAAE,gBAAgB,IAAI,aAAa,EAAE,MAAM,cAAc,CAAA;AACnG,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAA;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAK3C,MAAM,YAAY,GAAgD;IAChE,EAAE,EAAE,GAAG;IACP,EAAE,EAAE,GAAG;IACP,EAAE,EAAE,GAAG;IACP,EAAE,EAAE,GAAG;IACP,EAAE,EAAE,GAAG;CACR,CAAA;AAED,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAU,CAAC,CAAA;AAOhF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAmC,EAAE;IACpE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,EAAE,CAAA;IACjC,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,CAAA;IAChC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,eAAe,CACnB,wBAAwB,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,MAAM,CAAC,KAAK,CAAC,GAAG,CACtF,CAAA;IACH,CAAC;IACD,OAAO,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;AACtC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IAC9C,IAAI,CAAC;QACH,OAAO,aAAa,CAAC,iBAAiB,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAA;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAA;AAC5D,CAAC"}

package/dist/src/encoding/base64.d.ts

@@ -0,0 +1,8 @@
+export declare function toBase64(bytes: Uint8Array): string;
+/**
+ * Decode base64, rejecting anything the alphabet does not cover.
+ *
+ * `label` names the thing being decoded so the message points at the caller's data
+ * rather than at this function.
+ */
+export declare function fromBase64(value: string, label?: string): Uint8Array;

package/dist/src/encoding/base64.js

@@ -0,0 +1,53 @@
+import { invalidArgument } from '../errors';
+/**
+ * Base64 in both directions, with one behaviour on every runtime.
+ *
+ * The platform primitives disagree on bad input: `Buffer.from(s, 'base64')` silently
+ * drops characters it does not recognise and returns a short buffer, while `atob`
+ * throws. Decoding a ledger through the first would turn "this URL is not a Geeq node"
+ * into "this ledger is corrupt" — so the input is validated here and both paths take
+ * the same branch.
+ */
+/** Standard alphabet, correct padding, whole 4-character groups. */
+const BASE64 = /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/;
+export function toBase64(bytes) {
+    if (typeof btoa === 'function') {
+        let binary = '';
+        for (const byte of bytes)
+            binary += String.fromCharCode(byte);
+        return btoa(binary);
+    }
+    return Buffer.from(bytes).toString('base64');
+}
+/**
+ * Decode base64, rejecting anything the alphabet does not cover.
+ *
+ * `label` names the thing being decoded so the message points at the caller's data
+ * rather than at this function.
+ */
+export function fromBase64(value, label = 'value') {
+    if (typeof value !== 'string') {
+        throw invalidArgument(`${label} must be a base64 string, received ${typeof value}.`);
+    }
+    if (value === '')
+        return new Uint8Array(0);
+    if (!BASE64.test(value)) {
+        // Naming the offending character and its index is the difference between "this is
+        // not base64" and "your proxy returned an HTML login page".
+        const index = value.search(/[^A-Za-z0-9+/=]/u);
+        const detail = index === -1
+            ? `its length (${value.length}) is not a multiple of 4, or its padding is misplaced`
+            : `it contains ${JSON.stringify(value[index])} at index ${index}`;
+        throw invalidArgument(`${label} is not valid base64: ${detail}. ` +
+            'A value that looks like markup or JSON usually means the URL is not a Geeq node.');
+    }
+    if (typeof atob === 'function') {
+        const binary = atob(value);
+        const bytes = new Uint8Array(binary.length);
+        for (let i = 0; i < binary.length; i += 1)
+            bytes[i] = binary.charCodeAt(i);
+        return bytes;
+    }
+    return new Uint8Array(Buffer.from(value, 'base64'));
+}
+//# sourceMappingURL=base64.js.map

package/dist/src/encoding/base64.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64.js","sourceRoot":"","sources":["../../../src/encoding/base64.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAE3C;;;;;;;;GAQG;AAEH,oEAAoE;AACpE,MAAM,MAAM,GAAG,kEAAkE,CAAA;AAEjF,MAAM,UAAU,QAAQ,CAAC,KAAiB;IACxC,IAAI,OAAO,IAAI,KAAK,UAAU,EAAE,CAAC;QAC/B,IAAI,MAAM,GAAG,EAAE,CAAA;QACf,KAAK,MAAM,IAAI,IAAI,KAAK;YAAE,MAAM,IAAI,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAA;QAC7D,OAAO,IAAI,CAAC,MAAM,CAAC,CAAA;IACrB,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;AAC9C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,KAAK,GAAG,OAAO;IACvD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,eAAe,CAAC,GAAG,KAAK,sCAAsC,OAAO,KAAK,GAAG,CAAC,CAAA;IACtF,CAAC;IACD,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,IAAI,UAAU,CAAC,CAAC,CAAC,CAAA;IAE1C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,kFAAkF;QAClF,4DAA4D;QAC5D,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAA;QAC9C,MAAM,MAAM,GACV,KAAK,KAAK,CAAC,CAAC;YACV,CAAC,CAAC,eAAe,KAAK,CAAC,MAAM,uDAAuD;YACpF,CAAC,CAAC,eAAe,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,aAAa,KAAK,EAAE,CAAA;QACrE,MAAM,eAAe,CACnB,GAAG,KAAK,yBAAyB,MAAM,IAAI;YACzC,kFAAkF,CACrF,CAAA;IACH,CAAC;IAED,IAAI,OAAO,IAAI,KAAK,UAAU,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAA;QAC1B,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QAC3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC;YAAE,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;QAC1E,OAAO,KAAK,CAAA;IACd,CAAC;IACD,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAA;AACrD,CAAC"}

package/dist/src/encoding/hex.d.ts

@@ -0,0 +1,2 @@
+export declare function toHex(bytes: Uint8Array): string;
+export declare function fromHex(value: string, label?: string): Uint8Array;

package/dist/src/encoding/hex.js

@@ -0,0 +1,35 @@
+import { invalidArgument } from '../errors';
+/**
+ * Hex in both directions.
+ *
+ * Every hash this SDK returns is bytes, and almost every application immediately turns
+ * them into hex to show or log. Doing that by hand is three lines everyone writes
+ * slightly differently — and `toString(16)` without padding silently drops a leading
+ * zero, producing a 63-character "32-byte" hash that compares unequal to itself.
+ */
+const HEX = /^[0-9a-fA-F]*$/;
+export function toHex(bytes) {
+    let hex = '';
+    for (const byte of bytes)
+        hex += byte.toString(16).padStart(2, '0');
+    return hex;
+}
+export function fromHex(value, label = 'value') {
+    if (typeof value !== 'string') {
+        throw invalidArgument(`${label} must be a hex string, received ${typeof value}.`);
+    }
+    const text = value.startsWith('0x') || value.startsWith('0X') ? value.slice(2) : value;
+    if (text.length % 2 !== 0) {
+        throw invalidArgument(`${label} must have an even number of hex digits, received ${text.length}.`);
+    }
+    if (!HEX.test(text)) {
+        const index = text.search(/[^0-9a-fA-F]/u);
+        throw invalidArgument(`${label} is not valid hex: it contains ${JSON.stringify(text[index])} at index ${index}.`);
+    }
+    const bytes = new Uint8Array(text.length / 2);
+    for (let i = 0; i < bytes.length; i += 1) {
+        bytes[i] = Number.parseInt(text.slice(i * 2, i * 2 + 2), 16);
+    }
+    return bytes;
+}
+//# sourceMappingURL=hex.js.map

package/dist/src/encoding/hex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hex.js","sourceRoot":"","sources":["../../../src/encoding/hex.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAE3C;;;;;;;GAOG;AAEH,MAAM,GAAG,GAAG,gBAAgB,CAAA;AAE5B,MAAM,UAAU,KAAK,CAAC,KAAiB;IACrC,IAAI,GAAG,GAAG,EAAE,CAAA;IACZ,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IACnE,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,KAAa,EAAE,KAAK,GAAG,OAAO;IACpD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,eAAe,CAAC,GAAG,KAAK,mCAAmC,OAAO,KAAK,GAAG,CAAC,CAAA;IACnF,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;IACtF,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,eAAe,CACnB,GAAG,KAAK,qDAAqD,IAAI,CAAC,MAAM,GAAG,CAC5E,CAAA;IACH,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACpB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,CAAA;QAC1C,MAAM,eAAe,CACnB,GAAG,KAAK,kCAAkC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,aAAa,KAAK,GAAG,CAC3F,CAAA;IACH,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAC7C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IAC9D,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/src/errors.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Every error thrown by this SDK is a {@link GeeqError} carrying a stable
+ * {@link GeeqErrorCode}. Branch on `code`, never on the message text.
+ */
+export type GeeqErrorCode = 
+/** An SDK function was called before the engine finished loading. */
+'not-initialized'
+/** The WebAssembly engine could not be loaded. */
+ | 'init-failed'
+/** A public or private key was the wrong length, or the pair did not match. */
+ | 'invalid-key'
+/** A wallet address was malformed, or encoded a record type we do not know. */
+ | 'invalid-address'
+/** A caller-supplied argument was outside its allowed range. */
+ | 'invalid-argument'
+/** A node could not be reached at all — no HTTP response arrived. */
+ | 'network-unreachable'
+/** A node, simulator or explorer answered with an error status. See `status` and `nodeDetails`. */
+ | 'node-error'
+/** A node answered, but its ledger could not be decoded. */
+ | 'ledger-unreadable'
+/** The node's chain is not the one the caller said to expect. */
+ | 'chain-mismatch'
+/** The signing account has no record on this chain yet — it needs funding. */
+ | 'account-not-found'
+/** The account exists but its record type cannot sign this transaction. */
+ | 'account-not-attestable'
+/**
+ * The node being targeted cannot be identified, or cannot process transactions. Also
+ * thrown when a simulator or explorer answers with something it should not serve.
+ */
+ | 'node-unusable'
+/** Metadata exceeds a limit this chain publishes in its ledger. */
+ | 'metadata-too-large'
+/** A second transaction was built for one account against one block. */
+ | 'nonce-collision'
+/** The sending account does not hold enough coin. */
+ | 'insufficient-funds'
+/** The amount is below the smallest transfer this chain accepts. */
+ | 'amount-below-minimum'
+/** The sending account does not hold an NFT it was asked to send. */
+ | 'nft-not-owned'
+/** A node's WebSocket could not be opened, or this runtime has no WebSocket at all. */
+ | 'socket-unreachable'
+/** The {@link GeeqSocket} was disposed, so it will not send or receive again. */
+ | 'socket-closed';
+export interface GeeqErrorOptions {
+    readonly cause?: unknown;
+    /** HTTP status, when a server answered. */
+    readonly status?: number;
+    /**
+     * The server's own `details`, verbatim; a list of them is joined with `; `. Never parse
+     * it — branch on `code`.
+     */
+    readonly nodeDetails?: string;
+}
+export declare class GeeqError extends Error {
+    readonly code: GeeqErrorCode;
+    readonly status?: number | undefined;
+    readonly nodeDetails?: string | undefined;
+    constructor(code: GeeqErrorCode, message: string, options?: GeeqErrorOptions);
+}
+export declare function notInitialized(what: string): GeeqError;
+/** The default chain was used before one was installed. */
+export declare function noChain(what: string): GeeqError;
+export declare const invalidKey: (message: string, cause?: unknown) => GeeqError;
+export declare const invalidAddress: (message: string, cause?: unknown) => GeeqError;
+export declare const invalidArgument: (message: string, cause?: unknown) => GeeqError;
+export declare const ledgerUnreadable: (message: string, cause?: unknown) => GeeqError;
+export declare const chainMismatch: (message: string, cause?: unknown) => GeeqError;
+export declare const accountNotFound: (message: string, cause?: unknown) => GeeqError;
+export declare const accountNotAttestable: (message: string, cause?: unknown) => GeeqError;
+export declare const nodeUnusable: (message: string, cause?: unknown) => GeeqError;
+export declare const metadataTooLarge: (message: string, cause?: unknown) => GeeqError;
+export declare const nonceCollision: (message: string, cause?: unknown) => GeeqError;
+export declare const insufficientFunds: (message: string, cause?: unknown) => GeeqError;
+export declare const amountBelowMinimum: (message: string, cause?: unknown) => GeeqError;
+export declare const nftNotOwned: (message: string, cause?: unknown) => GeeqError;
+export declare const socketUnreachable: (message: string, cause?: unknown) => GeeqError;
+export declare const socketClosed: (message: string, cause?: unknown) => GeeqError;
+export declare const networkUnreachable: (message: string, cause?: unknown) => GeeqError;
+/** A node answered with an error status. `details` is the node's own message. */
+export declare function nodeError(message: string, status: number, details?: string): GeeqError;

package/dist/src/errors.js

@@ -0,0 +1,49 @@
+export class GeeqError extends Error {
+    constructor(code, message, options) {
+        // Only `cause` belongs to Error; the rest are ours. exactOptionalPropertyTypes
+        // forbids handing it an explicit undefined, hence the ternary.
+        super(message, options?.cause === undefined ? undefined : { cause: options.cause });
+        this.name = 'GeeqError';
+        this.code = code;
+        this.status = options?.status;
+        this.nodeDetails = options?.nodeDetails;
+    }
+}
+function make(code) {
+    return (message, cause) => new GeeqError(code, message, cause === undefined ? undefined : { cause });
+}
+export function notInitialized(what) {
+    return new GeeqError('not-initialized', `${what} was called before the Geeq engine finished loading. ` +
+        'Await initGeeq() once at startup, or use the async helpers (generateKeypair, ' +
+        'importKeypair, createWalletAddress) which load it for you.');
+}
+/** The default chain was used before one was installed. */
+export function noChain(what) {
+    return new GeeqError('not-initialized', `${what} was called before a chain was initialised. ` +
+        'Await GeeqChain.init({ endpoint }) once at startup, or pass an explicit chain ' +
+        'from GeeqChain.connect({ endpoint }).');
+}
+export const invalidKey = make('invalid-key');
+export const invalidAddress = make('invalid-address');
+export const invalidArgument = make('invalid-argument');
+export const ledgerUnreadable = make('ledger-unreadable');
+export const chainMismatch = make('chain-mismatch');
+export const accountNotFound = make('account-not-found');
+export const accountNotAttestable = make('account-not-attestable');
+export const nodeUnusable = make('node-unusable');
+export const metadataTooLarge = make('metadata-too-large');
+export const nonceCollision = make('nonce-collision');
+export const insufficientFunds = make('insufficient-funds');
+export const amountBelowMinimum = make('amount-below-minimum');
+export const nftNotOwned = make('nft-not-owned');
+export const socketUnreachable = make('socket-unreachable');
+export const socketClosed = make('socket-closed');
+export const networkUnreachable = make('network-unreachable');
+/** A node answered with an error status. `details` is the node's own message. */
+export function nodeError(message, status, details) {
+    return new GeeqError('node-error', message, {
+        status,
+        ...(details === undefined ? {} : { nodeDetails: details }),
+    });
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/errors.js.map

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

package/dist/src/index.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Geeq SDK — browser-first TypeScript access to the Geeq blockchain.
+ *
+ * ```ts
+ * import { generateKeypair } from '@geeqdev/geeq-sdk'
+ *
+ * const keypair = await generateKeypair()
+ * const address = keypair.getAddress({ chainNumber: 1 })
+ * ```
+ */
+export { initGeeq, isGeeqReady } from './runtime/init';
+export { generateKeypair, generateKeypairSync, importKeypair, importKeypairSync, keypairFromSecretKey, keypairFromSecretKeySync, keypairFromMnemonic, keypairFromMnemonicSync, verifySignature, } from './crypto/keypair';
+export { accountIdFromPublicKey, ACCOUNT_ID_BYTES, PUBLIC_KEY_BYTES } from './crypto/account-id';
+export type { AccountRef } from './crypto/account-id';
+export { generateMnemonic, validateMnemonic, normalizeMnemonic, MNEMONIC_WORD_COUNTS, } from './crypto/mnemonic';
+export type { GenerateMnemonicOptions, MnemonicWordCount } from './crypto/mnemonic';
+export { createWalletAddress, createWalletAddressSync, decodeWalletAddress, decodeWalletAddressSync, isValidWalletAddress, } from './address/wallet-address';
+export { GEEQ_RECORD_TYPES, DEFAULT_RECORD_TYPE } from './address/record-type';
+export { GeeqChain, attest, initChain, transfer } from './chain/geeq-chain';
+export { GeeqNode } from './chain/geeq-node';
+export { GEEQ_NODE_PORT, selectNode } from './chain/select';
+export { discover, listChains, listNodes } from './net/discovery';
+export { defaultTransport } from './net/transport';
+export { attestationSubmitBody, coinTransferSubmitBody, ledgerRoute, socketRoute, submitRoute, } from './net/routes';
+export type { AttestationRequest, ChainStateRequest, CoinTransferRequest, GeeqChainOptions, NftMintRequest, NftMintProxiesRequest, NftMintProxyRequest, NftsRequest, } from './chain/geeq-chain';
+export type { Discovery, GeeqDiscoveredChain, GeeqDiscoveredNode, GeeqNodeKind, } from './net/discovery';
+export type { GeeqHttpResponse, GeeqRequestInit, GeeqTransport, } from './net/transport';
+export { getExplorerTransaction } from './net/explorer';
+export type { ExplorerTransactionRequest, GeeqExplorerTransaction } from './net/explorer';
+export { GeeqSocket } from './socket/geeq-socket';
+export { GeeqTrackedTx } from './socket/tracked-tx';
+export { transactionIdOf } from './socket/tx-status';
+export { defaultWebSocketFactory } from './net/websocket';
+export type { GeeqListenOptions, GeeqSendOptions, GeeqSocketMessage, GeeqSocketOptions, GeeqSocketState, GeeqTrackable, GeeqTrackOptions, } from './socket/geeq-socket';
+export type { GeeqTxConfirmed, GeeqTxOutcome, GeeqTxRefusal, GeeqTxRejected, GeeqTxRejectionReason, GeeqTxState, GeeqTxUnknown, GeeqTxUnknownReason, } from './socket/tracked-tx';
+export type { GeeqTxStatusEvent, GeeqTxVerdict } from './socket/tx-status';
+export type { GeeqWebSocketFactory, GeeqWebSocketLike, GeeqWebSocketMessageEvent, } from './net/websocket';
+export { ATTEST_HASH_BYTES, assertAttestHash, attestHashOf, attestHashOfSync, readContent, } from './tx/content';
+export type { GeeqContent } from './tx/content';
+export { inspectMetadata } from './tx/metadata';
+export type { MetadataEntryReport, MetadataReport } from './tx/metadata';
+export { fromBase64, toBase64 } from './encoding/base64';
+export { fromHex, toHex } from './encoding/hex';
+export { decodeValidationLedger } from './ledger/decode';
+export { GeeqLedger } from './ledger/geeq-ledger';
+export type { DecodeLedgerOptions } from './ledger/decode';
+export type { GeeqCoinAccount, GeeqCoinRecordKind, GeeqHeldNft } from './ledger/coin-accounts';
+export type { GeeqLedgerNode, GeeqNodeRole, GeeqNodeStatus } from './ledger/net-actors';
+export type { GeeqProxyAccount, GeeqProxyKind } from './ledger/proxy-accounts';
+export { createAttestationTx, createAttestationTxSync } from './tx/attestation';
+export { createCoinTransferTx, createCoinTransferTxSync } from './tx/transfer';
+export { createNftMintProxyTx, createNftMintProxyTxSync } from './tx/proxy';
+export { createNftMintTx, createNftMintTxSync } from './tx/nft';
+export { formatGeeq, toPennies } from './amount';
+export type { GeeqAmount } from './amount';
+export { GeeqError } from './errors';
+export type { GeeqErrorCode } from './errors';
+export type { AttestationContent, AttestationTx, AttestationTxFlatInput, AttestationTxInput, AttestationTxStateInput, ChainStateInput, CoinTransferContent, CoinTransferTx, CoinTransferTxFlatInput, CoinTransferTxInput, CoinTransferTxStateInput, GeeqChainState, GeeqFee, GeeqMetadataLimits, DecodedWalletAddress, GeeqCoinType, GeeqKeypair, GeeqRecordType, InitOptions, MnemonicOptions, GeeqNft, GeeqNftMintProxies, GeeqNftMintProxy, NftMintProxyTx, NftMintProxyTxInput, NftMintTx, NftMintTxInput, NftTransferEntry, WalletAddressOptions, WasmSource, } from './types';
+export type { AccountIdentifier, CreateWalletAddressInput, } from './address/wallet-address';

package/dist/src/index.js

@@ -0,0 +1,53 @@
+/**
+ * Geeq SDK — browser-first TypeScript access to the Geeq blockchain.
+ *
+ * ```ts
+ * import { generateKeypair } from '@geeqdev/geeq-sdk'
+ *
+ * const keypair = await generateKeypair()
+ * const address = keypair.getAddress({ chainNumber: 1 })
+ * ```
+ */
+// Engine lifecycle
+export { initGeeq, isGeeqReady } from './runtime/init';
+// Keypairs
+export { generateKeypair, generateKeypairSync, importKeypair, importKeypairSync, keypairFromSecretKey, keypairFromSecretKeySync, keypairFromMnemonic, keypairFromMnemonicSync, verifySignature, } from './crypto/keypair';
+export { accountIdFromPublicKey, ACCOUNT_ID_BYTES, PUBLIC_KEY_BYTES } from './crypto/account-id';
+// Recovery phrases
+export { generateMnemonic, validateMnemonic, normalizeMnemonic, MNEMONIC_WORD_COUNTS, } from './crypto/mnemonic';
+// Wallet addresses
+export { createWalletAddress, createWalletAddressSync, decodeWalletAddress, decodeWalletAddressSync, isValidWalletAddress, } from './address/wallet-address';
+export { GEEQ_RECORD_TYPES, DEFAULT_RECORD_TYPE } from './address/record-type';
+// Chains and nodes
+export { GeeqChain, attest, initChain, transfer } from './chain/geeq-chain';
+export { GeeqNode } from './chain/geeq-node';
+export { GEEQ_NODE_PORT, selectNode } from './chain/select';
+export { discover, listChains, listNodes } from './net/discovery';
+export { defaultTransport } from './net/transport';
+export { attestationSubmitBody, coinTransferSubmitBody, ledgerRoute, socketRoute, submitRoute, } from './net/routes';
+// Block explorer — look a transaction up after a block has decided it
+export { getExplorerTransaction } from './net/explorer';
+// Sockets — what happened to the transactions you sent, and anything else a node pushes
+export { GeeqSocket } from './socket/geeq-socket';
+export { GeeqTrackedTx } from './socket/tracked-tx';
+export { transactionIdOf } from './socket/tx-status';
+export { defaultWebSocketFactory } from './net/websocket';
+// Content, encoding and metadata — everything an application would otherwise
+// hand-roll around a transaction
+export { ATTEST_HASH_BYTES, assertAttestHash, attestHashOf, attestHashOfSync, readContent, } from './tx/content';
+export { inspectMetadata } from './tx/metadata';
+export { fromBase64, toBase64 } from './encoding/base64';
+export { fromHex, toHex } from './encoding/hex';
+// Ledgers
+export { decodeValidationLedger } from './ledger/decode';
+export { GeeqLedger } from './ledger/geeq-ledger';
+// Transactions
+export { createAttestationTx, createAttestationTxSync } from './tx/attestation';
+export { createCoinTransferTx, createCoinTransferTxSync } from './tx/transfer';
+export { createNftMintProxyTx, createNftMintProxyTxSync } from './tx/proxy';
+export { createNftMintTx, createNftMintTxSync } from './tx/nft';
+// Amounts — the protocol counts pennies; how many make a Geeq is the app's to say
+export { formatGeeq, toPennies } from './amount';
+// Errors
+export { GeeqError } from './errors';
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,mBAAmB;AACnB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAEtD,WAAW;AACX,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,oBAAoB,EACpB,wBAAwB,EACxB,mBAAmB,EACnB,uBAAuB,EACvB,eAAe,GAChB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAGhG,mBAAmB;AACnB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,mBAAmB,CAAA;AAG1B,mBAAmB;AACnB,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,0BAA0B,CAAA;AAEjC,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAE9E,mBAAmB;AACnB,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAC3E,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAC3D,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAClD,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,WAAW,EACX,WAAW,EACX,WAAW,GACZ,MAAM,cAAc,CAAA;AAuBrB,sEAAsE;AACtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAA;AAGvD,wFAAwF;AACxF,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAA;AA2BzD,6EAA6E;AAC7E,iCAAiC;AACjC,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,WAAW,GACZ,MAAM,cAAc,CAAA;AAErB,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAE/C,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AACxD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAE/C,UAAU;AACV,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAMjD,eAAe;AACf,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAA;AAC/E,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAA;AAC9E,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAA;AAC3E,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA;AAE/D,kFAAkF;AAClF,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAGhD,SAAS;AACT,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA"}