@quantulabs/8004-mcp 0.1.0

package/dist/core/services/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/services/index.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAE3C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/core/services/ipfs-service.d.ts

@@ -0,0 +1,59 @@
+import { IPFSClient } from '8004-solana';
+import type { IPFSClientConfig, RegistrationFile } from '8004-solana';
+export interface IIPFSService {
+    isConfigured(): boolean;
+    configure(config: IPFSClientConfig): void;
+    clearConfig(): void;
+    getConfig(): IPFSClientConfig | undefined;
+    addJson(data: Record<string, unknown>, name?: string): Promise<string>;
+    getJson<T = Record<string, unknown>>(cid: string): Promise<T>;
+    addRegistrationFile(registrationFile: RegistrationFile, chainId?: number, identityRegistryAddress?: string): Promise<string>;
+    getRegistrationFile(cid: string): Promise<RegistrationFile>;
+}
+/**
+ * Global IPFS service that can be used by all chain providers.
+ * This decouples IPFS storage from any specific chain implementation.
+ */
+export declare class IPFSService implements IIPFSService {
+    private _client?;
+    private _config?;
+    /**
+     * Check if IPFS is configured with valid credentials
+     */
+    isConfigured(): boolean;
+    /**
+     * Configure the IPFS service with provider settings
+     */
+    configure(config: IPFSClientConfig): void;
+    /**
+     * Clear IPFS configuration
+     */
+    clearConfig(): void;
+    /**
+     * Get current configuration (for debugging/status)
+     */
+    getConfig(): IPFSClientConfig | undefined;
+    /**
+     * Add JSON data to IPFS and return CID
+     */
+    addJson(data: Record<string, unknown>, _name?: string): Promise<string>;
+    /**
+     * Get JSON data from IPFS by CID
+     */
+    getJson<T = Record<string, unknown>>(cid: string): Promise<T>;
+    /**
+     * Add registration file to IPFS
+     */
+    addRegistrationFile(registrationFile: RegistrationFile, chainId?: number, identityRegistryAddress?: string): Promise<string>;
+    /**
+     * Get registration file from IPFS by CID
+     */
+    getRegistrationFile(cid: string): Promise<RegistrationFile>;
+    /**
+     * Get the underlying IPFSClient (for advanced usage)
+     * @throws Error if not configured
+     */
+    getClient(): IPFSClient;
+}
+export type { IPFSClientConfig, RegistrationFile };
+//# sourceMappingURL=ipfs-service.d.ts.map

package/dist/core/services/ipfs-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipfs-service.d.ts","sourceRoot":"","sources":["../../../src/core/services/ipfs-service.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEtE,MAAM,WAAW,YAAY;IAC3B,YAAY,IAAI,OAAO,CAAC;IACxB,SAAS,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC1C,WAAW,IAAI,IAAI,CAAC;IACpB,SAAS,IAAI,gBAAgB,GAAG,SAAS,CAAC;IAC1C,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACvE,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC9D,mBAAmB,CACjB,gBAAgB,EAAE,gBAAgB,EAClC,OAAO,CAAC,EAAE,MAAM,EAChB,uBAAuB,CAAC,EAAE,MAAM,GAC/B,OAAO,CAAC,MAAM,CAAC,CAAC;IACnB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC7D;AAED;;;GAGG;AACH,qBAAa,WAAY,YAAW,YAAY;IAC9C,OAAO,CAAC,OAAO,CAAC,CAAa;IAC7B,OAAO,CAAC,OAAO,CAAC,CAAmB;IAEnC;;OAEG;IACH,YAAY,IAAI,OAAO;IASvB;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAMzC;;OAEG;IACH,WAAW,IAAI,IAAI;IAKnB;;OAEG;IACH,SAAS,IAAI,gBAAgB,GAAG,SAAS;IAIzC;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK7E;;OAEG;IACG,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAKnE;;OAEG;IACG,mBAAmB,CACvB,gBAAgB,EAAE,gBAAgB,EAClC,OAAO,CAAC,EAAE,MAAM,EAChB,uBAAuB,CAAC,EAAE,MAAM,GAC/B,OAAO,CAAC,MAAM,CAAC;IAKlB;;OAEG;IACG,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAKjE;;;OAGG;IACH,SAAS,IAAI,UAAU;CASxB;AAGD,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/core/services/ipfs-service.js

@@ -0,0 +1,84 @@
+// Global IPFS Service - Chain-agnostic decentralized storage
+// Supports Pinata, Filecoin, and local IPFS nodes
+import { IPFSClient } from '8004-solana';
+/**
+ * Global IPFS service that can be used by all chain providers.
+ * This decouples IPFS storage from any specific chain implementation.
+ */
+export class IPFSService {
+    _client;
+    _config;
+    /**
+     * Check if IPFS is configured with valid credentials
+     */
+    isConfigured() {
+        if (!this._config)
+            return false;
+        return !!(this._config.pinataJwt ||
+            this._config.url ||
+            this._config.filecoinPinEnabled);
+    }
+    /**
+     * Configure the IPFS service with provider settings
+     */
+    configure(config) {
+        this._config = config;
+        // Reset client to force re-initialization with new config
+        this._client = undefined;
+    }
+    /**
+     * Clear IPFS configuration
+     */
+    clearConfig() {
+        this._config = undefined;
+        this._client = undefined;
+    }
+    /**
+     * Get current configuration (for debugging/status)
+     */
+    getConfig() {
+        return this._config ? { ...this._config } : undefined;
+    }
+    /**
+     * Add JSON data to IPFS and return CID
+     */
+    async addJson(data, _name) {
+        const client = this.getClient();
+        return client.addJson(data);
+    }
+    /**
+     * Get JSON data from IPFS by CID
+     */
+    async getJson(cid) {
+        const client = this.getClient();
+        return client.getJson(cid);
+    }
+    /**
+     * Add registration file to IPFS
+     */
+    async addRegistrationFile(registrationFile, chainId, identityRegistryAddress) {
+        const client = this.getClient();
+        return client.addRegistrationFile(registrationFile, chainId, identityRegistryAddress);
+    }
+    /**
+     * Get registration file from IPFS by CID
+     */
+    async getRegistrationFile(cid) {
+        const client = this.getClient();
+        return client.getRegistrationFile(cid);
+    }
+    /**
+     * Get the underlying IPFSClient (for advanced usage)
+     * @throws Error if not configured
+     */
+    getClient() {
+        if (!this._client) {
+            if (!this._config) {
+                throw new Error('IPFS not configured. Call ipfs_configure first.');
+            }
+            this._client = new IPFSClient(this._config);
+        }
+        return this._client;
+    }
+}
+//# sourceMappingURL=ipfs-service.js.map

package/dist/core/services/ipfs-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipfs-service.js","sourceRoot":"","sources":["../../../src/core/services/ipfs-service.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,kDAAkD;AAElD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAkBzC;;;GAGG;AACH,MAAM,OAAO,WAAW;IACd,OAAO,CAAc;IACrB,OAAO,CAAoB;IAEnC;;OAEG;IACH,YAAY;QACV,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;QAChC,OAAO,CAAC,CAAC,CACP,IAAI,CAAC,OAAO,CAAC,SAAS;YACtB,IAAI,CAAC,OAAO,CAAC,GAAG;YAChB,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAChC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,MAAwB;QAChC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,0DAA0D;QAC1D,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,WAAW;QACT,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACxD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,IAA6B,EAAE,KAAc;QACzD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAChC,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAA8B,GAAW;QACpD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAChC,OAAO,MAAM,CAAC,OAAO,CAAI,GAAG,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,mBAAmB,CACvB,gBAAkC,EAClC,OAAgB,EAChB,uBAAgC;QAEhC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAChC,OAAO,MAAM,CAAC,mBAAmB,CAAC,gBAAgB,EAAE,OAAO,EAAE,uBAAuB,CAAC,CAAC;IACxF,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,mBAAmB,CAAC,GAAW;QACnC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAChC,OAAO,MAAM,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC;IACzC,CAAC;IAED;;;OAGG;IACH,SAAS;QACP,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;gBAClB,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;YACrE,CAAC;YACD,IAAI,CAAC,OAAO,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;CACF"}

package/dist/core/utils/tags.d.ts

@@ -0,0 +1,38 @@
+/**
+ * ERC-8004 standardized tags for feedback
+ */
+export declare const Tag: {
+    readonly starred: "starred";
+    readonly reachable: "reachable";
+    readonly ownerVerified: "ownerverified";
+    readonly uptime: "uptime";
+    readonly successRate: "successrate";
+    readonly responseTime: "responsetime";
+    readonly blocktimeFreshness: "blocktimefreshness";
+    readonly revenues: "revenues";
+    readonly tradingYield: "tradingyield";
+    readonly day: "day";
+    readonly week: "week";
+    readonly month: "month";
+    readonly year: "year";
+    readonly x402ResourceDelivered: "x402-resource-delivered";
+    readonly x402DeliveryFailed: "x402-delivery-failed";
+    readonly x402DeliveryTimeout: "x402-delivery-timeout";
+    readonly x402QualityIssue: "x402-quality-issue";
+    readonly x402GoodPayer: "x402-good-payer";
+    readonly x402PaymentFailed: "x402-payment-failed";
+    readonly x402InsufficientFunds: "x402-insufficient-funds";
+    readonly x402InvalidSignature: "x402-invalid-signature";
+    readonly x402Evm: "exact-evm";
+    readonly x402Svm: "exact-svm";
+};
+export type TagValue = typeof Tag[keyof typeof Tag];
+/**
+ * Check if a tag is a known standardized tag
+ */
+export declare function isKnownTag(tag: string): boolean;
+/**
+ * Get description for a tag
+ */
+export declare function getTagDescription(tag: string): string | null;
+//# sourceMappingURL=tags.d.ts.map

package/dist/core/utils/tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tags.d.ts","sourceRoot":"","sources":["../../../src/core/utils/tags.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,eAAO,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;CA6BN,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,CAAC,MAAM,OAAO,GAAG,CAAC,CAAC;AAqCpD;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG5D"}

package/dist/core/utils/tags.js

@@ -0,0 +1,77 @@
+/**
+ * ERC-8004 standardized tags for feedback
+ */
+// Tag values (case-insensitive storage)
+export const Tag = {
+    // Category tags (what metric)
+    starred: 'starred',
+    reachable: 'reachable',
+    ownerVerified: 'ownerverified',
+    uptime: 'uptime',
+    successRate: 'successrate',
+    responseTime: 'responsetime',
+    blocktimeFreshness: 'blocktimefreshness',
+    revenues: 'revenues',
+    tradingYield: 'tradingyield',
+    // Period tags (time window)
+    day: 'day',
+    week: 'week',
+    month: 'month',
+    year: 'year',
+    // x402 protocol tags
+    x402ResourceDelivered: 'x402-resource-delivered',
+    x402DeliveryFailed: 'x402-delivery-failed',
+    x402DeliveryTimeout: 'x402-delivery-timeout',
+    x402QualityIssue: 'x402-quality-issue',
+    x402GoodPayer: 'x402-good-payer',
+    x402PaymentFailed: 'x402-payment-failed',
+    x402InsufficientFunds: 'x402-insufficient-funds',
+    x402InvalidSignature: 'x402-invalid-signature',
+    x402Evm: 'exact-evm',
+    x402Svm: 'exact-svm',
+};
+// Tag descriptions
+const tagDescriptions = {
+    // Category tags
+    [Tag.starred]: 'User starred/favorited this agent',
+    [Tag.reachable]: 'Agent endpoint is reachable (binary: 0 or 100)',
+    [Tag.ownerVerified]: 'Owner identity verified (binary: 0 or 100)',
+    [Tag.uptime]: 'Uptime percentage over the period (0-100)',
+    [Tag.successRate]: 'Success rate percentage (0-100)',
+    [Tag.responseTime]: 'Response time in milliseconds (lower is better)',
+    [Tag.blocktimeFreshness]: 'Block time freshness in seconds (lower is better)',
+    [Tag.revenues]: 'Revenues generated in USD (scaled by decimals)',
+    [Tag.tradingYield]: 'Trading yield percentage (-100 to +100+)',
+    // Period tags
+    [Tag.day]: '24-hour period',
+    [Tag.week]: '7-day period',
+    [Tag.month]: '30-day period',
+    [Tag.year]: '365-day period',
+    // x402 tags
+    [Tag.x402ResourceDelivered]: 'x402: Resource successfully delivered after payment',
+    [Tag.x402DeliveryFailed]: 'x402: Delivery failed after payment',
+    [Tag.x402DeliveryTimeout]: 'x402: Delivery timed out after payment',
+    [Tag.x402QualityIssue]: 'x402: Quality issue with delivered resource',
+    [Tag.x402GoodPayer]: 'x402: Client paid successfully (agent perspective)',
+    [Tag.x402PaymentFailed]: 'x402: Client payment failed',
+    [Tag.x402InsufficientFunds]: 'x402: Client had insufficient funds',
+    [Tag.x402InvalidSignature]: 'x402: Invalid payment signature',
+    [Tag.x402Evm]: 'x402: Payment on EVM chain (Base, Ethereum, etc.)',
+    [Tag.x402Svm]: 'x402: Payment on Solana (SVM)',
+};
+// All known tag values for validation
+const allKnownTags = new Set(Object.values(Tag));
+/**
+ * Check if a tag is a known standardized tag
+ */
+export function isKnownTag(tag) {
+    return allKnownTags.has(tag.toLowerCase());
+}
+/**
+ * Get description for a tag
+ */
+export function getTagDescription(tag) {
+    const normalized = tag.toLowerCase();
+    return tagDescriptions[normalized] ?? null;
+}
+//# sourceMappingURL=tags.js.map

package/dist/core/utils/tags.js.map

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

package/dist/core/utils/value-encoding.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Encode a decimal value (number|string) to (value: bigint, valueDecimals: number)
+ *
+ * Examples:
+ *   "99.77" → { value: 9977n, valueDecimals: 2 }
+ *   99.77   → { value: 9977n, valueDecimals: 2 }
+ *   9977    → { value: 9977n, valueDecimals: 0 }
+ *   "-5.5"  → { value: -55n, valueDecimals: 1 }
+ *
+ * - Supports negatives (for yields, PnL, etc.)
+ * - Max 6 decimals (Solana program limit)
+ * - Clamps to i64 range
+ */
+export interface EncodedValue {
+    value: bigint;
+    valueDecimals: number;
+    /** Original normalized decimal string */
+    normalized: string;
+}
+/**
+ * Encode a decimal value to (value, valueDecimals) for on-chain storage
+ *
+ * @param input - Decimal string ("99.77"), number (99.77), or bigint (9977n)
+ * @param explicitDecimals - If provided, use this instead of auto-detecting (for bigint/int inputs)
+ * @returns Encoded value with bigint and decimal precision
+ */
+export declare function encodeReputationValue(input: string | number | bigint, explicitDecimals?: number): EncodedValue;
+/**
+ * Decode (value, valueDecimals) back to a decimal string
+ *
+ * @param value - Raw bigint value
+ * @param valueDecimals - Decimal precision
+ * @returns Decimal string (e.g., "99.77")
+ */
+export declare function decodeToDecimalString(value: bigint, valueDecimals: number): string;
+//# sourceMappingURL=value-encoding.d.ts.map

package/dist/core/utils/value-encoding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-encoding.d.ts","sourceRoot":"","sources":["../../../src/core/utils/value-encoding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;CACpB;AAyED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAC/B,gBAAgB,CAAC,EAAE,MAAM,GACxB,YAAY,CAgFd;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAiBlF"}

package/dist/core/utils/value-encoding.js

@@ -0,0 +1,196 @@
+/**
+ * Encode a decimal value (number|string) to (value: bigint, valueDecimals: number)
+ *
+ * Examples:
+ *   "99.77" → { value: 9977n, valueDecimals: 2 }
+ *   99.77   → { value: 9977n, valueDecimals: 2 }
+ *   9977    → { value: 9977n, valueDecimals: 0 }
+ *   "-5.5"  → { value: -55n, valueDecimals: 1 }
+ *
+ * - Supports negatives (for yields, PnL, etc.)
+ * - Max 6 decimals (Solana program limit)
+ * - Clamps to i64 range
+ */
+const MAX_VALUE_DECIMALS = 6;
+const I64_MAX = 9223372036854775807n;
+const I64_MIN = -9223372036854775808n;
+/**
+ * Strip leading zeros from a string, keeping at least one digit
+ */
+function stripLeadingZeros(s) {
+    let i = 0;
+    while (i < s.length - 1 && s[i] === '0')
+        i++;
+    return s.slice(i);
+}
+/**
+ * Normalize a decimal string (handle exponential notation, trim zeros)
+ */
+function normalizeDecimalString(input) {
+    const s = input.trim();
+    if (s.length === 0)
+        throw new Error('Empty value');
+    const lower = s.toLowerCase();
+    if (lower === 'nan' || lower === '+nan' || lower === '-nan') {
+        throw new Error('NaN not supported');
+    }
+    if (lower === 'infinity' || lower === '+infinity' || lower === '-infinity') {
+        throw new Error('Infinity not supported');
+    }
+    // Handle exponential notation (e.g., 1.23e-4)
+    if (/[eE]/.test(s)) {
+        const match = s.match(/^([+-]?)(\d+(?:\.\d+)?)[eE]([+-]?\d+)$/);
+        if (!match)
+            throw new Error(`Invalid numeric string: ${input}`);
+        const sign = match[1] === '-' ? '-' : '';
+        const mantissa = match[2];
+        const exp = parseInt(match[3], 10);
+        if (!Number.isFinite(exp))
+            throw new Error(`Invalid exponent: ${input}`);
+        const [intPartRaw, fracPartRaw = ''] = mantissa.split('.');
+        const digits = stripLeadingZeros((intPartRaw || '0') + fracPartRaw);
+        const fracLen = fracPartRaw.length;
+        const shift = exp - fracLen;
+        if (digits === '0')
+            return '0';
+        if (shift >= 0) {
+            return sign + digits + '0'.repeat(shift);
+        }
+        const pos = digits.length + shift;
+        if (pos > 0) {
+            return sign + digits.slice(0, pos) + '.' + digits.slice(pos);
+        }
+        return sign + '0.' + '0'.repeat(-pos) + digits;
+    }
+    // Plain decimal
+    if (!/^([+-])?(\d+)(\.\d+)?$/.test(s)) {
+        throw new Error(`Invalid numeric string: ${input}`);
+    }
+    let sign = '';
+    let body = s;
+    if (body[0] === '+')
+        body = body.slice(1);
+    if (body[0] === '-') {
+        sign = '-';
+        body = body.slice(1);
+    }
+    let [intPart, fracPart = ''] = body.split('.');
+    intPart = stripLeadingZeros(intPart || '0');
+    fracPart = fracPart.replace(/0+$/, '');
+    if (intPart === '0' && fracPart.length === 0)
+        return '0';
+    return sign + intPart + (fracPart.length ? '.' + fracPart : '');
+}
+/**
+ * Encode a decimal value to (value, valueDecimals) for on-chain storage
+ *
+ * @param input - Decimal string ("99.77"), number (99.77), or bigint (9977n)
+ * @param explicitDecimals - If provided, use this instead of auto-detecting (for bigint/int inputs)
+ * @returns Encoded value with bigint and decimal precision
+ */
+export function encodeReputationValue(input, explicitDecimals) {
+    // If bigint with explicit decimals, use directly
+    if (typeof input === 'bigint') {
+        const decimals = explicitDecimals ?? 0;
+        if (!Number.isInteger(decimals) || decimals < 0 || decimals > MAX_VALUE_DECIMALS) {
+            throw new Error(`valueDecimals must be integer 0-${MAX_VALUE_DECIMALS}`);
+        }
+        let value = input;
+        if (value > I64_MAX)
+            value = I64_MAX;
+        if (value < I64_MIN)
+            value = I64_MIN;
+        return {
+            value,
+            valueDecimals: decimals,
+            normalized: decodeToDecimalString(value, decimals),
+        };
+    }
+    // If number is an integer with explicit decimals, use directly
+    if (typeof input === 'number' && Number.isInteger(input) && explicitDecimals !== undefined) {
+        const decimals = explicitDecimals;
+        if (!Number.isInteger(decimals) || decimals < 0 || decimals > MAX_VALUE_DECIMALS) {
+            throw new Error(`valueDecimals must be integer 0-${MAX_VALUE_DECIMALS}`);
+        }
+        // Reject unsafe integers to prevent silent precision loss
+        if (!Number.isSafeInteger(input)) {
+            throw new Error(`Integer ${input} exceeds safe integer range. Use bigint for large values.`);
+        }
+        let value = BigInt(input);
+        if (value > I64_MAX)
+            value = I64_MAX;
+        if (value < I64_MIN)
+            value = I64_MIN;
+        return {
+            value,
+            valueDecimals: decimals,
+            normalized: decodeToDecimalString(value, decimals),
+        };
+    }
+    // Otherwise, parse as decimal string
+    let normalized;
+    if (typeof input === 'number') {
+        if (!Number.isFinite(input))
+            throw new Error('Non-finite number not supported');
+        // Reject unsafe integers to prevent silent precision loss via toString()
+        if (Number.isInteger(input) && !Number.isSafeInteger(input)) {
+            throw new Error(`Integer ${input} exceeds safe integer range. Use bigint or string for large values.`);
+        }
+        normalized = normalizeDecimalString(input.toString());
+    }
+    else {
+        normalized = normalizeDecimalString(input);
+    }
+    if (normalized === '0') {
+        return { value: 0n, valueDecimals: 0, normalized };
+    }
+    const negative = normalized.startsWith('-');
+    const unsigned = negative ? normalized.slice(1) : normalized;
+    const [intPart, fracPart = ''] = unsigned.split('.');
+    // Limit decimals to max (truncate with rounding)
+    const decimals = Math.min(fracPart.length, MAX_VALUE_DECIMALS);
+    const kept = fracPart.slice(0, decimals);
+    const nextDigit = fracPart.length > decimals ? parseInt(fracPart[decimals], 10) : 0;
+    // Build scaled integer
+    const scaledStr = stripLeadingZeros((intPart || '0') + kept.padEnd(decimals, '0')) || '0';
+    let raw = BigInt(scaledStr);
+    // Round half-up
+    if (nextDigit >= 5)
+        raw = raw + 1n;
+    if (negative)
+        raw = -raw;
+    // Clamp to i64 range
+    if (raw > I64_MAX)
+        raw = I64_MAX;
+    if (raw < I64_MIN)
+        raw = I64_MIN;
+    return {
+        value: raw,
+        valueDecimals: decimals,
+        normalized,
+    };
+}
+/**
+ * Decode (value, valueDecimals) back to a decimal string
+ *
+ * @param value - Raw bigint value
+ * @param valueDecimals - Decimal precision
+ * @returns Decimal string (e.g., "99.77")
+ */
+export function decodeToDecimalString(value, valueDecimals) {
+    if (valueDecimals === 0)
+        return value.toString();
+    const str = value.toString();
+    const isNegative = str.startsWith('-');
+    const absStr = isNegative ? str.slice(1) : str;
+    if (absStr.length <= valueDecimals) {
+        const padded = absStr.padStart(valueDecimals, '0');
+        const result = '0.' + padded;
+        return isNegative ? '-' + result : result;
+    }
+    const intPart = absStr.slice(0, -valueDecimals);
+    const fracPart = absStr.slice(-valueDecimals).replace(/0+$/, '');
+    const result = fracPart ? intPart + '.' + fracPart : intPart;
+    return isNegative ? '-' + result : result;
+}
+//# sourceMappingURL=value-encoding.js.map

package/dist/core/utils/value-encoding.js.map

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

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

@@ -0,0 +1,2 @@
+export { WalletManager, getWalletManager, setWalletManager, type WalletChainType, type WalletInfo, type WalletListResult, type WalletCreateResult, type WalletUnlockResult, type UnlockedWallet, } from './wallet-manager.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/wallet/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,cAAc,GACpB,MAAM,qBAAqB,CAAC"}

package/dist/core/wallet/index.js

@@ -0,0 +1,3 @@
+// Wallet management exports
+export { WalletManager, getWalletManager, setWalletManager, } from './wallet-manager.js';
+//# sourceMappingURL=index.js.map

package/dist/core/wallet/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/wallet/index.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAE5B,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,gBAAgB,GAOjB,MAAM,qBAAqB,CAAC"}

package/dist/core/wallet/wallet-manager.d.ts

@@ -0,0 +1,86 @@
+import { Keypair } from '@solana/web3.js';
+import { type PrivateKeyAccount } from 'viem/accounts';
+export type WalletChainType = 'solana' | 'evm';
+export interface WalletInfo {
+    name: string;
+    chainType: WalletChainType;
+    address: string;
+    publicKey: string;
+    createdAt: string;
+    isUnlocked: boolean;
+}
+export interface WalletListResult {
+    wallets: WalletInfo[];
+    unlockedCount: number;
+}
+export interface WalletCreateResult {
+    name: string;
+    chainType: WalletChainType;
+    address: string;
+    publicKey: string;
+    filePath: string;
+    message: string;
+}
+export interface WalletUnlockResult {
+    name: string;
+    chainType: WalletChainType;
+    address: string;
+    message: string;
+}
+export interface UnlockedWallet {
+    name: string;
+    chainType: WalletChainType;
+    address: string;
+    publicKey: string;
+    solanaKeypair?: Keypair;
+    evmAccount?: PrivateKeyAccount;
+    evmPrivateKey?: `0x${string}`;
+}
+export declare class WalletManager {
+    private readonly walletDir;
+    private readonly walletsPath;
+    private unlockedWallets;
+    private walletSessions;
+    private autoLockMs;
+    constructor(walletDir?: string);
+    setAutoLockTimeout(ms: number): void;
+    getAutoLockTimeout(): number;
+    private refreshAutoLock;
+    private autoLockWallet;
+    private secureWipe;
+    touchWallet(name: string): boolean;
+    private deriveKey;
+    private encrypt;
+    private decrypt;
+    private ensureDir;
+    private getWalletPath;
+    exists(name: string): Promise<boolean>;
+    private readWalletFile;
+    list(): Promise<WalletListResult>;
+    getInfo(name: string): Promise<WalletInfo | null>;
+    create(name: string, chainType: WalletChainType, password: string): Promise<WalletCreateResult>;
+    import(name: string, chainType: WalletChainType, privateKey: string, password: string): Promise<WalletCreateResult>;
+    private parseSolanaPrivateKey;
+    private parseEvmPrivateKey;
+    unlock(name: string, password: string): Promise<WalletUnlockResult>;
+    lock(name: string): boolean;
+    lockAll(): number;
+    isUnlocked(name: string): boolean;
+    getSessionInfo(): Array<{
+        name: string;
+        lastActivity: number;
+        chainType: WalletChainType;
+    }>;
+    getUnlockedWallet(name: string): UnlockedWallet;
+    getSolanaKeypair(name: string): Keypair;
+    getEvmAccount(name: string): PrivateKeyAccount;
+    getAnyUnlockedSolanaKeypair(): Keypair | null;
+    getAnyUnlockedEvmAccount(): PrivateKeyAccount | null;
+    getAnyUnlockedEvmPrivateKey(): `0x${string}` | null;
+    export(name: string, currentPassword: string, exportPassword?: string): Promise<string>;
+    delete(name: string, password: string): Promise<void>;
+    changePassword(name: string, currentPassword: string, newPassword: string): Promise<void>;
+}
+export declare function getWalletManager(): WalletManager;
+export declare function setWalletManager(manager: WalletManager): void;
+//# sourceMappingURL=wallet-manager.d.ts.map

package/dist/core/wallet/wallet-manager.d.ts.map

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