@4mica/sdk 1.2.17 → 1.3.1

package/dist/src/errors.js

@@ -1,81 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AuthMissingConfigError = exports.AuthConfigError = exports.AuthApiError = exports.AuthDecodeError = exports.AuthTransportError = exports.AuthUrlError = exports.AuthError = exports.X402Error = exports.VerificationError = exports.ContractError = exports.SigningError = exports.ClientInitializationError = exports.RpcError = exports.ConfigError = exports.FourMicaError = void 0;
-/** Base class for all 4Mica SDK errors. Sets `error.name` to the subclass name. */
-class FourMicaError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = this.constructor.name;
-    }
-}
-exports.FourMicaError = FourMicaError;
-/** Thrown when the SDK configuration is invalid (e.g. missing required fields or bad URL). */
-class ConfigError extends FourMicaError {
-}
-exports.ConfigError = ConfigError;
-/** Thrown when a 4Mica core RPC call fails. Includes the HTTP status and raw response body. */
-class RpcError extends FourMicaError {
-    status;
-    body;
-    constructor(message, options) {
-        super(message);
-        this.status = options?.status;
-        this.body = options?.body;
-    }
-}
-exports.RpcError = RpcError;
-/** Thrown when the SDK client fails to initialise (e.g. chain ID mismatch). */
-class ClientInitializationError extends FourMicaError {
-}
-exports.ClientInitializationError = ClientInitializationError;
-/** Thrown when signing a payment claim fails (e.g. unsupported scheme, address mismatch). */
-class SigningError extends FourMicaError {
-}
-exports.SigningError = SigningError;
-/** Thrown when an on-chain contract call fails or returns an unexpected result. */
-class ContractError extends FourMicaError {
-}
-exports.ContractError = ContractError;
-/** Thrown when BLS certificate verification fails (e.g. domain mismatch, invalid encoding). */
-class VerificationError extends FourMicaError {
-}
-exports.VerificationError = VerificationError;
-/** Thrown when an x402 HTTP payment flow encounters an error. */
-class X402Error extends FourMicaError {
-}
-exports.X402Error = X402Error;
-/** Base class for authentication-related errors. */
-class AuthError extends FourMicaError {
-}
-exports.AuthError = AuthError;
-/** Thrown when the auth URL is invalid or unreachable. */
-class AuthUrlError extends AuthError {
-}
-exports.AuthUrlError = AuthUrlError;
-/** Thrown when a network-level error occurs during authentication. */
-class AuthTransportError extends AuthError {
-}
-exports.AuthTransportError = AuthTransportError;
-/** Thrown when the auth server response cannot be decoded. */
-class AuthDecodeError extends AuthError {
-}
-exports.AuthDecodeError = AuthDecodeError;
-/** Thrown when the auth server returns an error response. Includes HTTP status and body. */
-class AuthApiError extends AuthError {
-    status;
-    body;
-    constructor(message, options) {
-        super(message);
-        this.status = options?.status;
-        this.body = options?.body;
-    }
-}
-exports.AuthApiError = AuthApiError;
-/** Thrown when auth configuration is invalid. */
-class AuthConfigError extends AuthError {
-}
-exports.AuthConfigError = AuthConfigError;
-/** Thrown when an authenticated operation is attempted without auth being configured. */
-class AuthMissingConfigError extends AuthConfigError {
-}
-exports.AuthMissingConfigError = AuthMissingConfigError;

package/dist/src/guarantee.d.ts

@@ -1,25 +0,0 @@
-import { PaymentGuaranteeClaims } from './models';
-/**
- * ABI-encode a {@link PaymentGuaranteeClaims} object into a hex string.
- *
- * Produces the outer `(uint64 version, bytes innerClaims)` envelope format expected
- * by the Core4Mica contract. Supports V1 (10 fields) and V2 (19 fields with validation policy).
- *
- * @param claims - Decoded claims to encode. Must have `version` set to `1` or `2`.
- * @returns `0x`-prefixed hex string of the ABI-encoded envelope.
- * @throws {@link VerificationError} if `version` is not `1` or `2`, the domain is not 32 bytes,
- *   or V2 claims are missing `validationPolicy`.
- */
-export declare function encodeGuaranteeClaims(claims: PaymentGuaranteeClaims): string;
-/**
- * Decode ABI-encoded guarantee claims into a {@link PaymentGuaranteeClaims} object.
- *
- * Accepts either the modern `(uint64 version, bytes innerClaims)` envelope or the legacy
- * unwrapped V1 format (raw 320-byte ABI encoding without an outer envelope).
- *
- * @param data - Hex string or raw bytes of the ABI-encoded claims.
- * @returns Decoded {@link PaymentGuaranteeClaims} with `version` set to `1` or `2`.
- * @throws {@link VerificationError} if the data is too short, the inner length is wrong,
- *   or the encoded version number is unsupported.
- */
-export declare function decodeGuaranteeClaims(data: string | Uint8Array): PaymentGuaranteeClaims;

package/dist/src/guarantee.js

@@ -1,272 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.encodeGuaranteeClaims = encodeGuaranteeClaims;
-exports.decodeGuaranteeClaims = decodeGuaranteeClaims;
-const viem_1 = require("viem");
-const errors_1 = require("./errors");
-const utils_1 = require("./utils");
-const CLAIMS_ENCODED_BYTES = 32 * 10;
-// Minimum bytes for a valid outer envelope: uint64 + bytes offset + bytes length
-const MIN_ENVELOPE_BYTES = 32 * 2 + 32;
-const CLAIM_TYPES = [
-    { type: 'bytes32' },
-    { type: 'uint256' },
-    { type: 'uint256' },
-    { type: 'address' },
-    { type: 'address' },
-    { type: 'uint256' },
-    { type: 'uint256' },
-    { type: 'address' },
-    { type: 'uint64' },
-    { type: 'uint64' },
-];
-// V2 adds: validation_registry_address, validation_request_hash, validation_chain_id,
-//          validator_address, validator_agent_id, min_validation_score,
-//          validation_subject_hash, job_hash, required_validation_tag (dynamic string)
-const CLAIM_TYPES_V2 = [
-    { type: 'bytes32' }, // domain
-    { type: 'uint256' }, // tab_id
-    { type: 'uint256' }, // req_id
-    { type: 'address' }, // client (user)
-    { type: 'address' }, // recipient
-    { type: 'uint256' }, // amount
-    { type: 'uint256' }, // total_amount
-    { type: 'address' }, // asset
-    { type: 'uint64' }, // timestamp
-    { type: 'uint64' }, // version
-    { type: 'address' }, // validation_registry_address
-    { type: 'bytes32' }, // validation_request_hash
-    { type: 'uint64' }, // validation_chain_id
-    { type: 'address' }, // validator_address
-    { type: 'uint256' }, // validator_agent_id
-    { type: 'uint8' }, // min_validation_score
-    { type: 'bytes32' }, // validation_subject_hash
-    { type: 'bytes32' }, // job_hash
-    { type: 'string' }, // required_validation_tag (dynamic)
-];
-const CLAIM_TYPES_V2_TUPLE = [
-    {
-        type: 'tuple',
-        components: [
-            { name: 'domain', type: 'bytes32' },
-            { name: 'tabId', type: 'uint256' },
-            { name: 'reqId', type: 'uint256' },
-            { name: 'user', type: 'address' },
-            { name: 'recipient', type: 'address' },
-            { name: 'amount', type: 'uint256' },
-            { name: 'totalAmount', type: 'uint256' },
-            { name: 'asset', type: 'address' },
-            { name: 'timestamp', type: 'uint64' },
-            { name: 'claimsVersion', type: 'uint64' },
-            { name: 'validationRegistryAddress', type: 'address' },
-            { name: 'validationRequestHash', type: 'bytes32' },
-            { name: 'validationChainId', type: 'uint64' },
-            { name: 'validatorAddress', type: 'address' },
-            { name: 'validatorAgentId', type: 'uint256' },
-            { name: 'minValidationScore', type: 'uint8' },
-            { name: 'validationSubjectHash', type: 'bytes32' },
-            { name: 'jobHash', type: 'bytes32' },
-            { name: 'requiredValidationTag', type: 'string' },
-        ],
-    },
-];
-function ensureDomainBytes(domain) {
-    const bytes = typeof domain === 'string' ? (0, viem_1.toBytes)(domain) : domain;
-    if (bytes.length !== 32) {
-        throw new errors_1.VerificationError('domain separator must be 32 bytes');
-    }
-    return bytes;
-}
-function normalizeHexBytes(data) {
-    if (typeof data === 'string') {
-        return (0, utils_1.ensureHexPrefix)(data);
-    }
-    return (0, utils_1.hexFromBytes)(data);
-}
-/**
- * ABI-encode a {@link PaymentGuaranteeClaims} object into a hex string.
- *
- * Produces the outer `(uint64 version, bytes innerClaims)` envelope format expected
- * by the Core4Mica contract. Supports V1 (10 fields) and V2 (19 fields with validation policy).
- *
- * @param claims - Decoded claims to encode. Must have `version` set to `1` or `2`.
- * @returns `0x`-prefixed hex string of the ABI-encoded envelope.
- * @throws {@link VerificationError} if `version` is not `1` or `2`, the domain is not 32 bytes,
- *   or V2 claims are missing `validationPolicy`.
- */
-function encodeGuaranteeClaims(claims) {
-    if (claims.version === 1) {
-        const domain = ensureDomainBytes(claims.domain);
-        const encoded = (0, viem_1.encodeAbiParameters)(CLAIM_TYPES, [
-            (0, utils_1.hexFromBytes)(domain),
-            (0, utils_1.parseU256)(claims.tabId),
-            (0, utils_1.parseU256)(claims.reqId),
-            claims.userAddress,
-            claims.recipientAddress,
-            (0, utils_1.parseU256)(claims.amount),
-            (0, utils_1.parseU256)(claims.totalAmount),
-            claims.assetAddress,
-            BigInt(claims.timestamp),
-            BigInt(claims.version),
-        ]);
-        return (0, viem_1.encodeAbiParameters)([{ type: 'uint64' }, { type: 'bytes' }], [BigInt(claims.version), encoded]);
-    }
-    if (claims.version === 2) {
-        if (!claims.validationPolicy) {
-            throw new errors_1.VerificationError('V2 guarantee claims missing validationPolicy');
-        }
-        const p = claims.validationPolicy;
-        const domain = ensureDomainBytes(claims.domain);
-        const encoded = (0, viem_1.encodeAbiParameters)(CLAIM_TYPES_V2_TUPLE, [
-            {
-                domain: (0, utils_1.hexFromBytes)(domain),
-                tabId: (0, utils_1.parseU256)(claims.tabId),
-                reqId: (0, utils_1.parseU256)(claims.reqId),
-                user: claims.userAddress,
-                recipient: claims.recipientAddress,
-                amount: (0, utils_1.parseU256)(claims.amount),
-                totalAmount: (0, utils_1.parseU256)(claims.totalAmount),
-                asset: claims.assetAddress,
-                timestamp: BigInt(claims.timestamp),
-                claimsVersion: BigInt(claims.version),
-                validationRegistryAddress: p.validationRegistryAddress,
-                validationRequestHash: (0, utils_1.ensureHexPrefix)(p.validationRequestHash),
-                validationChainId: BigInt(p.validationChainId),
-                validatorAddress: p.validatorAddress,
-                validatorAgentId: p.validatorAgentId,
-                minValidationScore: p.minValidationScore,
-                validationSubjectHash: (0, utils_1.ensureHexPrefix)(p.validationSubjectHash),
-                jobHash: (0, utils_1.ensureHexPrefix)(p.jobHash),
-                requiredValidationTag: p.requiredValidationTag,
-            },
-        ]);
-        return (0, viem_1.encodeAbiParameters)([{ type: 'uint64' }, { type: 'bytes' }], [BigInt(claims.version), encoded]);
-    }
-    throw new errors_1.VerificationError(`unsupported guarantee claims version: ${claims.version}`);
-}
-/**
- * Decode ABI-encoded guarantee claims into a {@link PaymentGuaranteeClaims} object.
- *
- * Accepts either the modern `(uint64 version, bytes innerClaims)` envelope or the legacy
- * unwrapped V1 format (raw 320-byte ABI encoding without an outer envelope).
- *
- * @param data - Hex string or raw bytes of the ABI-encoded claims.
- * @returns Decoded {@link PaymentGuaranteeClaims} with `version` set to `1` or `2`.
- * @throws {@link VerificationError} if the data is too short, the inner length is wrong,
- *   or the encoded version number is unsupported.
- */
-function decodeGuaranteeClaims(data) {
-    const hex = normalizeHexBytes(data);
-    const byteLen = (hex.length - 2) / 2;
-    // Try to decode as unwrapped V1 (legacy)
-    if (byteLen === CLAIMS_ENCODED_BYTES) {
-        return decodeV1Claims(hex);
-    }
-    // Decode outer envelope to get version
-    if (byteLen < MIN_ENVELOPE_BYTES) {
-        throw new errors_1.VerificationError(`unexpected guarantee claims length: ${byteLen} bytes`);
-    }
-    const [version, wrapped] = (0, viem_1.decodeAbiParameters)([{ type: 'uint64' }, { type: 'bytes' }], hex);
-    if (version === 1n) {
-        const innerHex = wrapped;
-        const innerByteLen = (innerHex.length - 2) / 2;
-        if (innerByteLen !== CLAIMS_ENCODED_BYTES) {
-            throw new errors_1.VerificationError(`unexpected V1 claims inner length: ${innerByteLen} bytes`);
-        }
-        return decodeV1Claims(innerHex);
-    }
-    if (version === 2n) {
-        return decodeV2Claims(wrapped);
-    }
-    throw new errors_1.VerificationError(`unsupported guarantee claims version: ${version}`);
-}
-function decodeV1Claims(encoded) {
-    let decoded;
-    try {
-        decoded = (0, viem_1.decodeAbiParameters)(CLAIM_TYPES, encoded);
-    }
-    catch (err) {
-        throw new errors_1.VerificationError(`failed to decode V1 guarantee claims: ${String(err)}`);
-    }
-    const [domain, tabId, reqId, user, recipient, amount, totalAmount, asset, timestamp, claimsVersion,] = decoded;
-    if (claimsVersion !== 1n) {
-        throw new errors_1.VerificationError(`unsupported guarantee claims version: ${claimsVersion}`);
-    }
-    return {
-        domain: (0, viem_1.toBytes)(domain),
-        userAddress: user,
-        recipientAddress: recipient,
-        tabId: (0, utils_1.parseU256)(tabId),
-        reqId: (0, utils_1.parseU256)(reqId),
-        amount: (0, utils_1.parseU256)(amount),
-        totalAmount: (0, utils_1.parseU256)(totalAmount),
-        assetAddress: asset,
-        timestamp: Number(timestamp),
-        version: Number(claimsVersion),
-    };
-}
-function decodeV2Claims(encoded) {
-    try {
-        const [decoded] = (0, viem_1.decodeAbiParameters)(CLAIM_TYPES_V2_TUPLE, encoded);
-        return buildDecodedV2Claims(decoded);
-    }
-    catch (tupleErr) {
-        try {
-            const decoded = (0, viem_1.decodeAbiParameters)(CLAIM_TYPES_V2, encoded);
-            return buildDecodedV2Claims({
-                domain: decoded[0],
-                tabId: decoded[1],
-                reqId: decoded[2],
-                user: decoded[3],
-                recipient: decoded[4],
-                amount: decoded[5],
-                totalAmount: decoded[6],
-                asset: decoded[7],
-                timestamp: decoded[8],
-                claimsVersion: decoded[9],
-                validationRegistryAddress: decoded[10],
-                validationRequestHash: decoded[11],
-                validationChainId: decoded[12],
-                validatorAddress: decoded[13],
-                validatorAgentId: decoded[14],
-                minValidationScore: decoded[15],
-                validationSubjectHash: decoded[16],
-                jobHash: decoded[17],
-                requiredValidationTag: decoded[18],
-            });
-        }
-        catch (flatErr) {
-            throw new errors_1.VerificationError(`failed to decode V2 guarantee claims: ${String(tupleErr)}; fallback decode failed: ${String(flatErr)}`);
-        }
-    }
-}
-function buildDecodedV2Claims(decoded) {
-    const { domain, tabId, reqId, user, recipient, amount, totalAmount, asset, timestamp, claimsVersion, validationRegistryAddress, validationRequestHash, validationChainId, validatorAddress, validatorAgentId, minValidationScore, validationSubjectHash, jobHash, requiredValidationTag, } = decoded;
-    if (claimsVersion !== 2n) {
-        throw new errors_1.VerificationError(`expected V2 claims version, got: ${claimsVersion}`);
-    }
-    const validationPolicy = {
-        validationRegistryAddress: validationRegistryAddress,
-        validationRequestHash: validationRequestHash,
-        validationChainId: Number(validationChainId),
-        validatorAddress: validatorAddress,
-        validatorAgentId: (0, utils_1.parseU256)(validatorAgentId),
-        minValidationScore: Number(minValidationScore),
-        validationSubjectHash: validationSubjectHash,
-        jobHash: jobHash,
-        requiredValidationTag: requiredValidationTag,
-    };
-    return {
-        domain: (0, viem_1.toBytes)(domain),
-        userAddress: user,
-        recipientAddress: recipient,
-        tabId: (0, utils_1.parseU256)(tabId),
-        reqId: (0, utils_1.parseU256)(reqId),
-        amount: (0, utils_1.parseU256)(amount),
-        totalAmount: (0, utils_1.parseU256)(totalAmount),
-        assetAddress: asset,
-        timestamp: Number(timestamp),
-        version: Number(claimsVersion),
-        validationPolicy,
-    };
-}

package/dist/src/http.d.ts

@@ -1,11 +0,0 @@
-export type FetchFn = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
-type DecodeErrorFactory = (message: string, response: Response) => Error;
-type HttpErrorFactory = (message: string, response: Response, body: unknown) => Error;
-export declare function normalizeBaseUrl(endpoint: string): string;
-export declare function extractErrorMessage(payload: unknown): string;
-export declare function requestJson<T>(fetchFn: FetchFn, url: string, init: RequestInit, options: {
-    decodeError: DecodeErrorFactory;
-    httpError: HttpErrorFactory;
-    allowEmptyOk?: boolean;
-}): Promise<T>;
-export {};

package/dist/src/http.js

@@ -1,57 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.normalizeBaseUrl = normalizeBaseUrl;
-exports.extractErrorMessage = extractErrorMessage;
-exports.requestJson = requestJson;
-function normalizeBaseUrl(endpoint) {
-    return endpoint.endsWith('/') ? endpoint.slice(0, -1) : endpoint;
-}
-function extractErrorMessage(payload) {
-    if (payload && typeof payload === 'object') {
-        const record = payload;
-        const error = record.error;
-        const msg = record.message;
-        return ((typeof error === 'string' && error) ||
-            (typeof msg === 'string' && msg) ||
-            JSON.stringify(record, (_k, v) => v));
-    }
-    if (typeof payload === 'string' && payload.trim()) {
-        return payload.trim();
-    }
-    return 'unknown error';
-}
-async function requestJson(fetchFn, url, init, options) {
-    const response = await fetchFn(url, init);
-    let text = '';
-    try {
-        text = await response.text();
-    }
-    catch (err) {
-        throw options.decodeError(`invalid response from ${response.url}: ${String(err)}`, response);
-    }
-    let payload = null;
-    let parsed = false;
-    let parseError;
-    if (text) {
-        try {
-            payload = JSON.parse(text);
-            parsed = true;
-        }
-        catch (err) {
-            payload = text;
-            parseError = err;
-        }
-    }
-    if (!response.ok) {
-        const message = `${response.status}: ${extractErrorMessage(payload)}`;
-        throw options.httpError(message, response, payload);
-    }
-    if (!text && !options.allowEmptyOk) {
-        throw options.decodeError(`invalid JSON response from ${response.url}: empty response body`, response);
-    }
-    if (text && !parsed) {
-        const detail = parseError instanceof Error ? parseError.message : String(parseError);
-        throw options.decodeError(`invalid JSON response from ${response.url}: ${detail}`, response);
-    }
-    return payload;
-}

package/dist/src/index.d.ts

@@ -1,17 +0,0 @@
-export * from './errors';
-export * from './constants';
-export * from './networks';
-export * from './config';
-export * from './utils';
-export * from './models';
-export * from './payment';
-export * from './validation';
-export * from './signing';
-export * from './rpc';
-export * from './auth';
-export * from './contract';
-export * from './guarantee';
-export * from './bls';
-export * from './x402/index';
-export * from './client';
-export * from './wallet';

package/dist/src/index.js

@@ -1,33 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./errors"), exports);
-__exportStar(require("./constants"), exports);
-__exportStar(require("./networks"), exports);
-__exportStar(require("./config"), exports);
-__exportStar(require("./utils"), exports);
-__exportStar(require("./models"), exports);
-__exportStar(require("./payment"), exports);
-__exportStar(require("./validation"), exports);
-__exportStar(require("./signing"), exports);
-__exportStar(require("./rpc"), exports);
-__exportStar(require("./auth"), exports);
-__exportStar(require("./contract"), exports);
-__exportStar(require("./guarantee"), exports);
-__exportStar(require("./bls"), exports);
-__exportStar(require("./x402/index"), exports);
-__exportStar(require("./client"), exports);
-__exportStar(require("./wallet"), exports);