@obbyx/obyte 0.0.0-stage → 0.1.1

package/dist/unit/exact-unit.js

@@ -0,0 +1,387 @@
+// Ambient types for obyte.js internals; a reference (not tsconfig "include") so that
+// workspace packages compiling these sources via the @obbyx/source condition see them.
+// eslint-disable-next-line @typescript-eslint/triple-slash-reference
+/// <reference path="../types/obyte-internal.d.ts" />
+import obyte from 'obyte';
+import { getBase64Hash, getHeadersSize, getTotalPayloadSize, getUnitHash, getUnitHashToSign, } from 'obyte/lib/internal.js';
+import { isAddress, isAssetId } from '../channel/definition.js';
+import { accept, hasOnlyKeys, isPlainObject, reject } from '../core/result.js';
+import { isSigDefinition, verifySignature } from '../signing/signed-message.js';
+/**
+ * Local (ledger-independent) validation of a client-signed unit for the x402
+ * `exact` scheme — the supported profile of ADR-0002.
+ *
+ * Checks done here need no hub: structure, network, unit hash, payload hashes,
+ * author definition and signature, commissions, message set, outputs and the
+ * signed binding. Ledger checks (inputs unspent, last ball recency, author
+ * definition when not embedded) are performed by the facilitator with a
+ * LedgerPort using {@link ExactUnitFacts}.
+ *
+ * Anything outside the profile is rejected; the profile is deliberately narrow.
+ */
+export const EXACT_REASONS = {
+    unsupported: 'invalid_exact_obyte_unsupported_unit',
+    tooLarge: 'invalid_exact_obyte_unit_too_large',
+    network: 'invalid_exact_obyte_network',
+    unitHash: 'invalid_exact_obyte_unit_hash',
+    payloadHash: 'invalid_exact_obyte_payload_hash',
+    definition: 'invalid_exact_obyte_definition',
+    definitionRequired: 'invalid_exact_obyte_definition_required',
+    signature: 'invalid_exact_obyte_signature',
+    commissions: 'invalid_exact_obyte_commissions',
+    recipient: 'invalid_exact_obyte_recipient_mismatch',
+    amount: 'invalid_exact_obyte_amount_mismatch',
+    asset: 'invalid_exact_obyte_asset_mismatch',
+    binding: 'invalid_exact_obyte_binding_mismatch',
+    payer: 'invalid_exact_obyte_payer',
+};
+/** Only current unit versions are accepted. */
+export const EXACT_UNIT_VERSIONS = { livenet: '4.0', testnet: '4.0t' };
+const ALT = { livenet: '1', testnet: '2' };
+export const DEFAULT_MAX_UNIT_BYTES = 16 * 1024;
+const UNIT_KEYS = new Set([
+    'version',
+    'alt',
+    'messages',
+    'authors',
+    'parent_units',
+    'last_ball',
+    'last_ball_unit',
+    'timestamp',
+    'headers_commission',
+    'payload_commission',
+    'tps_fee',
+    'burn_fee',
+    'max_aa_responses',
+    'unit',
+]);
+const AUTHOR_KEYS = new Set(['address', 'authentifiers', 'definition']);
+const MESSAGE_KEYS = new Set(['app', 'payload_location', 'payload_hash', 'payload']);
+const PAYMENT_KEYS = new Set(['asset', 'inputs', 'outputs']);
+const INPUT_KEYS = new Set(['unit', 'message_index', 'output_index']);
+const OUTPUT_KEYS = new Set(['address', 'amount']);
+const HASH_RE = /^[A-Za-z0-9+/]{43}=$/;
+const isHash = (v) => typeof v === 'string' && HASH_RE.test(v);
+const isIndex = (v) => Number.isSafeInteger(v) && v >= 0;
+const isPositiveAmount = (v) => Number.isSafeInteger(v) && v > 0;
+export function validateExactUnit(unit, expect, options = {}) {
+    // The order of the checks is part of the contract: the first failing one
+    // decides the reason code.
+    const shaped = checkShape(unit, expect);
+    if (!shaped.ok)
+        return shaped;
+    const u = shaped.value;
+    const hashed = checkUnitHash(u);
+    if (!hashed.ok)
+        return hashed;
+    const { unitHash, messages, authors } = hashed.value;
+    const author = checkAuthor(u, authors, options.authorDefinition);
+    if (!author.ok)
+        return author;
+    const { payer, definitionFromLedger } = author.value;
+    const roles = checkPayer(payer, expect);
+    if (!roles.ok)
+        return roles;
+    const payments = checkMessages(messages, expect);
+    if (!payments.ok)
+        return payments;
+    const transfers = checkTransfers(payments.value, payer, expect);
+    if (!transfers.ok)
+        return transfers;
+    const commissions = expectedCommissions(u);
+    if (commissions.headers !== u['headers_commission'] ||
+        commissions.payload !== u['payload_commission']) {
+        return reject(EXACT_REASONS.commissions, 'Commissions do not match the unit size');
+    }
+    return accept({
+        unitHash,
+        payer,
+        inputs: transfers.value.inputs,
+        lastBallUnit: u['last_ball_unit'],
+        parentUnits: u['parent_units'],
+        timestamp: u['timestamp'],
+        outputTotals: transfers.value.outputTotals,
+        commissions,
+        definitionFromLedger,
+    });
+}
+const unsupported = (why) => reject(EXACT_REASONS.unsupported, why);
+/** Structure, size, network and header fields. */
+function checkShape(unit, expect) {
+    if (!isPlainObject(unit))
+        return unsupported('Unit must be an object');
+    let serialized;
+    try {
+        serialized = JSON.stringify(unit);
+    }
+    catch {
+        return unsupported('Unit is not serializable');
+    }
+    if (serialized.length > (expect.maxUnitBytes ?? DEFAULT_MAX_UNIT_BYTES)) {
+        return reject(EXACT_REASONS.tooLarge, 'Unit exceeds the size limit');
+    }
+    if (!hasOnlyKeys(unit, UNIT_KEYS))
+        return unsupported('Unit has fields outside the profile');
+    const net = expect.network.name;
+    if (unit['version'] !== EXACT_UNIT_VERSIONS[net] || unit['alt'] !== ALT[net]) {
+        return reject(EXACT_REASONS.network, `Unit version/alt do not match ${expect.network.caip2}`);
+    }
+    const parents = unit['parent_units'];
+    if (!Array.isArray(parents) || parents.length === 0 || !parents.every(isHash)) {
+        return unsupported('Invalid parent_units');
+    }
+    if (!isHash(unit['last_ball']) || !isHash(unit['last_ball_unit'])) {
+        return unsupported('Invalid last ball');
+    }
+    if (!Number.isSafeInteger(unit['timestamp']))
+        return unsupported('Invalid timestamp');
+    for (const fee of ['headers_commission', 'payload_commission']) {
+        if (!Number.isSafeInteger(unit[fee]) || unit[fee] <= 0) {
+            return unsupported(`Invalid ${fee}`);
+        }
+    }
+    for (const fee of ['tps_fee', 'burn_fee', 'max_aa_responses']) {
+        if (fee in unit && !isIndex(unit[fee]))
+            return unsupported(`Invalid ${fee}`);
+    }
+    return accept(unit);
+}
+/** The unit hash is present and matches the content. */
+function checkUnitHash(unit) {
+    if (!isHash(unit['unit']))
+        return reject(EXACT_REASONS.unitHash, 'Missing unit hash');
+    const messages = unit['messages'];
+    const authors = unit['authors'];
+    if (!Array.isArray(messages) || !Array.isArray(authors))
+        return unsupported('Malformed unit');
+    let unitHash;
+    try {
+        unitHash = getUnitHash(unit);
+    }
+    catch {
+        return reject(EXACT_REASONS.unitHash, 'Unit cannot be hashed');
+    }
+    if (unitHash !== unit['unit']) {
+        return reject(EXACT_REASONS.unitHash, 'Unit hash does not match content');
+    }
+    return accept({ unitHash, messages, authors });
+}
+/** One author with a single-sig definition (embedded or from the ledger) and a valid signature. */
+function checkAuthor(unit, authors, ledgerDefinition) {
+    const R = EXACT_REASONS;
+    if (authors.length !== 1)
+        return unsupported('Exactly one author is supported');
+    const author = authors[0];
+    if (!isPlainObject(author) || !hasOnlyKeys(author, AUTHOR_KEYS)) {
+        return unsupported('Malformed author');
+    }
+    const payer = author['address'];
+    if (!isAddress(payer))
+        return unsupported('Invalid author address');
+    const embedded = 'definition' in author;
+    const definition = embedded ? author['definition'] : ledgerDefinition;
+    if (definition === undefined) {
+        return reject(R.definitionRequired, 'Author definition is not embedded; fetch it from the ledger');
+    }
+    if (!isSigDefinition(definition)) {
+        return reject(R.definition, "Only ['sig', {pubkey}] author definitions are supported");
+    }
+    if (obyte.utils.getChash160([...definition]) !== payer) {
+        return reject(R.definition, 'Definition does not match the author address');
+    }
+    const authentifiers = author['authentifiers'];
+    if (!isPlainObject(authentifiers) || !hasOnlyKeys(authentifiers, new Set(['r']))) {
+        return reject(R.signature, 'Expected a single authentifier "r"');
+    }
+    if (!verifySignature(getUnitHashToSign(unit), authentifiers['r'], definition[1].pubkey)) {
+        return reject(R.signature, 'Signature is invalid');
+    }
+    return accept({ payer, definitionFromLedger: !embedded });
+}
+/** The payer is neither the recipient nor the facilitator. */
+function checkPayer(payer, expect) {
+    if (payer === expect.payTo)
+        return reject(EXACT_REASONS.payer, 'Payer and payTo must differ');
+    if (expect.facilitatorAddresses?.includes(payer)) {
+        return reject(EXACT_REASONS.payer, 'A facilitator address must never be the payer');
+    }
+    return accept(null);
+}
+/**
+ * Inline messages with matching hashes: exactly one data message carrying the
+ * binding, one payment per asset, bytes always and only the expected asset besides.
+ */
+function checkMessages(messages, expect) {
+    const R = EXACT_REASONS;
+    let dataCount = 0;
+    const payments = new Map();
+    for (const message of messages) {
+        if (!isPlainObject(message) || !hasOnlyKeys(message, MESSAGE_KEYS)) {
+            return unsupported('Malformed message');
+        }
+        if (message['payload_location'] !== 'inline' || !('payload' in message)) {
+            return unsupported('Only inline payloads are supported');
+        }
+        if (getBase64Hash(message['payload'], true) !== message['payload_hash']) {
+            return reject(R.payloadHash, 'payload_hash does not match payload');
+        }
+        const payload = message['payload'];
+        if (message['app'] === 'data') {
+            dataCount += 1;
+            const binding = checkBinding(payload, expect);
+            if (binding !== undefined)
+                return binding;
+        }
+        else if (message['app'] === 'payment') {
+            const asset = paymentAsset(payload);
+            if (!asset.ok)
+                return asset;
+            if (payments.has(asset.value))
+                return unsupported('One payment message per asset');
+            payments.set(asset.value, payload);
+        }
+        else {
+            return unsupported('Only payment and data messages are supported');
+        }
+    }
+    if (dataCount !== 1) {
+        return reject(R.binding, 'Exactly one data message with the binding is required');
+    }
+    if (!payments.has('base'))
+        return unsupported('A bytes payment message is required');
+    for (const asset of payments.keys()) {
+        if (asset !== 'base' && asset !== expect.asset) {
+            return reject(R.asset, 'Payment in an unexpected asset');
+        }
+    }
+    if (!payments.has(expect.asset))
+        return reject(R.asset, 'No payment in the required asset');
+    return accept(payments);
+}
+/** The asset of a payment message ('base' when omitted). */
+function paymentAsset(payload) {
+    if (!isPlainObject(payload) || !hasOnlyKeys(payload, PAYMENT_KEYS)) {
+        return unsupported('Malformed payment');
+    }
+    const asset = 'asset' in payload ? payload['asset'] : 'base';
+    if (asset === 'base' && 'asset' in payload)
+        return unsupported('Bytes payment must omit asset');
+    if (!isAssetId(asset))
+        return unsupported('Invalid payment asset');
+    return accept(asset);
+}
+/**
+ * Transfer inputs only (no duplicates); sorted outputs that go to payTo
+ * (exactly once, the exact amount, the expected asset) or back to the payer.
+ */
+function checkTransfers(payments, payer, expect) {
+    const R = EXACT_REASONS;
+    const inputs = [];
+    const seenInputs = new Set();
+    const outputTotals = {};
+    let paidToPayTo = 0n;
+    let outputsToPayTo = 0;
+    for (const [asset, payment] of payments) {
+        const ins = payment['inputs'];
+        const outs = payment['outputs'];
+        if (!Array.isArray(ins) || ins.length === 0 || !Array.isArray(outs) || outs.length === 0) {
+            return unsupported('Payment needs inputs and outputs');
+        }
+        for (const input of ins) {
+            const ref = transferInput(input, asset);
+            if (ref === undefined)
+                return unsupported('Only transfer inputs are supported');
+            const key = `${ref.unit}:${ref.messageIndex}:${ref.outputIndex}`;
+            if (seenInputs.has(key))
+                return unsupported('Duplicate input');
+            seenInputs.add(key);
+            inputs.push(ref);
+        }
+        let total = 0n;
+        let previous;
+        for (const output of outs) {
+            if (!isPlainObject(output) ||
+                !hasOnlyKeys(output, OUTPUT_KEYS) ||
+                !isAddress(output['address']) ||
+                !isPositiveAmount(output['amount'])) {
+                return unsupported('Malformed output');
+            }
+            // ocore requires outputs sorted by address, then amount; duplicates are
+            // outside our profile.
+            const current = { address: output['address'], amount: output['amount'] };
+            if (previous !== undefined && compareOutputs(previous, current) >= 0) {
+                return unsupported('Outputs must be sorted by address and amount without duplicates');
+            }
+            previous = current;
+            total += BigInt(current.amount);
+            if (current.address === expect.payTo) {
+                if (asset !== expect.asset)
+                    return reject(R.recipient, 'payTo receives an unexpected asset');
+                outputsToPayTo += 1;
+                paidToPayTo += BigInt(current.amount);
+            }
+            else if (current.address !== payer) {
+                return reject(R.recipient, 'Outputs may only go to payTo or back to the payer');
+            }
+        }
+        outputTotals[asset] = total;
+    }
+    if (outputsToPayTo !== 1)
+        return reject(R.recipient, 'Exactly one output to payTo is required');
+    if (paidToPayTo !== expect.amount)
+        return reject(R.amount, 'Amount paid to payTo does not match');
+    return accept({ inputs, outputTotals });
+}
+/** A transfer input (unit, message_index, output_index), or undefined for anything else. */
+function transferInput(input, asset) {
+    if (!isPlainObject(input) ||
+        !hasOnlyKeys(input, INPUT_KEYS) ||
+        !isHash(input['unit']) ||
+        !isIndex(input['message_index']) ||
+        !isIndex(input['output_index'])) {
+        return undefined;
+    }
+    return {
+        asset,
+        unit: input['unit'],
+        messageIndex: input['message_index'],
+        outputIndex: input['output_index'],
+    };
+}
+/** Length of one base64 secp256k1 signature, as counted by obyte.js. */
+const SIGNATURE_SIZE = 88;
+/**
+ * Commissions ocore expects for an already SIGNED single-author unit (v4,
+ * sizes counted with keys). obyte.js `getHeadersSize` is meant for the
+ * unsigned unit during compose (authentifiers hold a path placeholder) and
+ * adds SIGNATURE_SIZE itself; on a signed unit the real signature is already
+ * counted, so it is subtracted. Verified against testnet unit DxPSVW8p…
+ * (headers 452, payload 432).
+ */
+export function expectedCommissions(unit) {
+    return {
+        headers: getHeadersSize(unit, true) - SIGNATURE_SIZE,
+        payload: getTotalPayloadSize(unit, true),
+    };
+}
+export function compareOutputs(a, b) {
+    if (a.address !== b.address)
+        return a.address < b.address ? -1 : 1;
+    return a.amount - b.amount;
+}
+/** The data message is exactly `{x402: {binding, quoteId}}` of this operation (undefined when it is). */
+function checkBinding(payload, expect) {
+    const R = EXACT_REASONS;
+    if (!isPlainObject(payload) || !hasOnlyKeys(payload, new Set(['x402']))) {
+        return reject(R.binding, 'Data message must be exactly {x402: {binding, quoteId}}');
+    }
+    const x402 = payload['x402'];
+    if (!isPlainObject(x402) || !hasOnlyKeys(x402, new Set(['binding', 'quoteId']))) {
+        return reject(R.binding, 'Data message must be exactly {x402: {binding, quoteId}}');
+    }
+    if (x402['binding'] !== expect.binding || x402['quoteId'] !== expect.quoteId) {
+        return reject(R.binding, 'Signed binding does not match this operation');
+    }
+    return undefined;
+}
+//# sourceMappingURL=exact-unit.js.map

package/dist/unit/exact-unit.js.map

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

package/dist/wallet/index.d.ts

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+import type { ObyteNetwork } from '../core/networks.js';
+/**
+ * Local single-address wallet shared by the CLI, the seller watcher and the
+ * demo playground: one private key per network in
+ * `$OBBYX_HOME/wallet-<network>.json` (default ~/.obbyx), file mode 0600.
+ * Loading verifies the file (schema), its permissions, its network and that
+ * the key derives the stored address. The key never leaves this machine.
+ */
+export declare const walletFileSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    network: z.ZodString;
+    address: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
+    wif: z.ZodString;
+    createdAt: z.ZodString;
+}, z.core.$strict>;
+export type WalletFile = z.infer<typeof walletFileSchema>;
+export declare function obbyxHome(env?: NodeJS.ProcessEnv): string;
+export declare function walletPath(network: ObyteNetwork, env?: NodeJS.ProcessEnv): string;
+export declare function createWallet(network: ObyteNetwork, opts?: {
+    force?: boolean;
+    env?: NodeJS.ProcessEnv;
+}): WalletFile;
+export declare function loadWallet(network: ObyteNetwork, env?: NodeJS.ProcessEnv): WalletFile & {
+    privateKey: Uint8Array;
+};
+/** Address of a single-sig key, via obyte.js public API (signMessage reports its author). */
+export declare function addressOfKey(privateKey: Uint8Array, network: ObyteNetwork): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/wallet/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/wallet/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB;;;;;;kBAQlB,CAAC;AAEZ,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,wBAAgB,SAAS,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAEtE;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAE9F;AAED,wBAAgB,YAAY,CAC1B,OAAO,EAAE,YAAY,EACrB,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAO,GACtD,UAAU,CA8BZ;AAED,wBAAgB,UAAU,CACxB,OAAO,EAAE,YAAY,EACrB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,UAAU,GAAG;IAAE,UAAU,EAAE,UAAU,CAAA;CAAE,CAyCzC;AAED,6FAA6F;AAC7F,wBAAgB,YAAY,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM,CAUlF"}

package/dist/wallet/index.js

@@ -0,0 +1,106 @@
+import { randomBytes } from 'node:crypto';
+import { chmodSync, existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import obyte from 'obyte';
+import { z } from 'zod';
+import { isAddress } from '../channel/definition.js';
+import { ObbyxError } from '../core/errors.js';
+/**
+ * Local single-address wallet shared by the CLI, the seller watcher and the
+ * demo playground: one private key per network in
+ * `$OBBYX_HOME/wallet-<network>.json` (default ~/.obbyx), file mode 0600.
+ * Loading verifies the file (schema), its permissions, its network and that
+ * the key derives the stored address. The key never leaves this machine.
+ */
+export const walletFileSchema = z
+    .object({
+    version: z.literal(1),
+    network: z.string(),
+    address: z.string().refine(isAddress, 'invalid Obyte address'),
+    wif: z.string().min(1),
+    createdAt: z.string(),
+})
+    .strict();
+export function obbyxHome(env = process.env) {
+    return env['OBBYX_HOME'] ?? join(homedir(), '.obbyx');
+}
+export function walletPath(network, env = process.env) {
+    return join(obbyxHome(env), `wallet-${network.name}.json`);
+}
+export function createWallet(network, opts = {}) {
+    const path = walletPath(network, opts.env);
+    if (existsSync(path) && opts.force !== true) {
+        throw new ObbyxError('wallet_exists', `A wallet already exists at ${path} (use --force to replace it)`);
+    }
+    let privateKey;
+    let address;
+    for (;;) {
+        privateKey = randomBytes(32);
+        try {
+            address = addressOfKey(privateKey, network); // rejects the (astronomically unlikely) invalid scalar
+            break;
+        }
+        catch {
+            continue;
+        }
+    }
+    const wallet = {
+        version: 1,
+        network: network.caip2,
+        address,
+        wif: obyte.utils.toWif(privateKey, network.testnet),
+        createdAt: new Date().toISOString(),
+    };
+    mkdirSync(obbyxHome(opts.env), { recursive: true, mode: 0o700 });
+    writeFileSync(path, `${JSON.stringify(wallet, null, 2)}\n`, { mode: 0o600 });
+    chmodSync(path, 0o600);
+    return wallet;
+}
+export function loadWallet(network, env = process.env) {
+    const path = walletPath(network, env);
+    if (!existsSync(path)) {
+        throw new ObbyxError('no_wallet', `No wallet for ${network.caip2}. Run: obbyx init --network ${network.name}`);
+    }
+    if ((statSync(path).mode & 0o077) !== 0) {
+        throw new ObbyxError('wallet_permissions', `${path} is readable by others; run: chmod 600 ${path}`);
+    }
+    let raw;
+    try {
+        raw = JSON.parse(readFileSync(path, 'utf8'));
+    }
+    catch {
+        throw new ObbyxError('wallet_corrupt', `${path} is not valid JSON`);
+    }
+    const parsed = walletFileSchema.safeParse(raw);
+    if (!parsed.success) {
+        throw new ObbyxError('wallet_corrupt', `${path}: ${parsed.error.issues[0]?.message ?? 'invalid wallet file'}`);
+    }
+    const wallet = parsed.data;
+    if (wallet.network !== network.caip2) {
+        throw new ObbyxError('wallet_network', `${path} belongs to ${wallet.network}`);
+    }
+    let privateKey;
+    try {
+        privateKey = obyte.utils.fromWif(wallet.wif, network.testnet).privateKey;
+    }
+    catch {
+        throw new ObbyxError('wallet_corrupt', `${path}: invalid key for ${network.caip2}`);
+    }
+    const address = addressOfKey(privateKey, network);
+    if (address !== wallet.address)
+        throw new ObbyxError('wallet_corrupt', `${path}: key does not match address`);
+    return { ...wallet, privateKey };
+}
+/** Address of a single-sig key, via obyte.js public API (signMessage reports its author). */
+export function addressOfKey(privateKey, network) {
+    const signed = obyte.utils.signMessage('obbyx', {
+        privateKey,
+        testnet: network.testnet,
+    });
+    const address = signed.authors[0]?.address;
+    if (address === undefined)
+        throw new ObbyxError('wallet_corrupt', 'Cannot derive address');
+    return address;
+}
+//# sourceMappingURL=index.js.map

package/dist/wallet/index.js.map

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

package/package.json

@@ -1,6 +1,67 @@
 {
   "name": "@obbyx/obyte",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.1",
+  "description": "Obyte primitives for x402: networks (CAIP-2), BigInt amounts, unit and signed-message validation, wallet, logging",
+  "keywords": [
+    "obyte",
+    "x402",
+    "payments",
+    "crypto",
+    "byteball"
+  ],
+  "license": "MIT",
+  "author": "Alexander Ponomarev",
+  "homepage": "https://github.com/Taump/obbyx/tree/master/packages/obyte#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Taump/obbyx.git",
+    "directory": "packages/obyte"
+  },
+  "bugs": {
+    "url": "https://github.com/Taump/obbyx/issues"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=24"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./logger": {
+      "types": "./dist/logger/index.d.ts",
+      "default": "./dist/logger/index.js"
+    },
+    "./config": {
+      "types": "./dist/config/index.d.ts",
+      "default": "./dist/config/index.js"
+    },
+    "./wallet": {
+      "types": "./dist/wallet/index.d.ts",
+      "default": "./dist/wallet/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "obyte": "0.2.1",
+    "pino": "^10.4.0",
+    "zod": "^4.6.7"
+  },
+  "devDependencies": {
+    "pino-pretty": "^13.2.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
 }