@quantulabs/8004-mcp 0.1.0

package/dist/core/interfaces/index.js

@@ -0,0 +1,7 @@
+// Core interfaces exports
+export * from './agent.js';
+export * from './feedback.js';
+export * from './reputation.js';
+export * from './chain-provider.js';
+export * from './x402.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/interfaces/index.ts"],"names":[],"mappings":"AAAA,0BAA0B;AAE1B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,WAAW,CAAC"}

package/dist/core/interfaces/reputation.d.ts

@@ -0,0 +1,47 @@
+export declare enum TrustTier {
+    Unrated = 0,
+    Bronze = 1,
+    Silver = 2,
+    Gold = 3,
+    Platinum = 4
+}
+export interface IReputationSummary {
+    agentId: string;
+    chainType: 'solana' | 'evm';
+    trustTier: TrustTier;
+    trustTierName: string;
+    qualityScore: number;
+    totalFeedbacks: number;
+    averageScore: number;
+    recentTrend?: 'up' | 'down' | 'stable';
+    lastFeedbackAt?: number;
+}
+export interface ILeaderboardEntry {
+    rank: number;
+    agentId: string;
+    globalId: string;
+    name: string;
+    chainType: 'solana' | 'evm';
+    trustTier: TrustTier;
+    qualityScore: number;
+    totalFeedbacks: number;
+}
+export interface ILeaderboardOptions {
+    chainType?: 'solana' | 'evm';
+    chainPrefix?: string;
+    collection?: string;
+    minFeedbacks?: number;
+    limit?: number;
+    offset?: number;
+}
+export interface ILeaderboardResult {
+    entries: ILeaderboardEntry[];
+    total: number;
+    hasMore: boolean;
+}
+export declare function getTrustTierName(tier: TrustTier): string;
+export declare function getTrustTierThreshold(tier: TrustTier): {
+    minScore: number;
+    minFeedbacks: number;
+};
+//# sourceMappingURL=reputation.d.ts.map

package/dist/core/interfaces/reputation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reputation.d.ts","sourceRoot":"","sources":["../../../src/core/interfaces/reputation.ts"],"names":[],"mappings":"AAEA,oBAAY,SAAS;IACnB,OAAO,IAAI;IACX,MAAM,IAAI;IACV,MAAM,IAAI;IACV,IAAI,IAAI;IACR,QAAQ,IAAI;CACb;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,QAAQ,GAAG,KAAK,CAAC;IAC5B,SAAS,EAAE,SAAS,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,QAAQ,CAAC;IACvC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,QAAQ,GAAG,KAAK,CAAC;IAC5B,SAAS,EAAE,SAAS,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CASxD;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CASjG"}

package/dist/core/interfaces/reputation.js

@@ -0,0 +1,30 @@
+// Reputation interfaces for multi-chain support
+export var TrustTier;
+(function (TrustTier) {
+    TrustTier[TrustTier["Unrated"] = 0] = "Unrated";
+    TrustTier[TrustTier["Bronze"] = 1] = "Bronze";
+    TrustTier[TrustTier["Silver"] = 2] = "Silver";
+    TrustTier[TrustTier["Gold"] = 3] = "Gold";
+    TrustTier[TrustTier["Platinum"] = 4] = "Platinum";
+})(TrustTier || (TrustTier = {}));
+export function getTrustTierName(tier) {
+    const names = {
+        [TrustTier.Unrated]: 'Unrated',
+        [TrustTier.Bronze]: 'Bronze',
+        [TrustTier.Silver]: 'Silver',
+        [TrustTier.Gold]: 'Gold',
+        [TrustTier.Platinum]: 'Platinum',
+    };
+    return names[tier] ?? 'Unknown';
+}
+export function getTrustTierThreshold(tier) {
+    const thresholds = {
+        [TrustTier.Unrated]: { minScore: 0, minFeedbacks: 0 },
+        [TrustTier.Bronze]: { minScore: 50, minFeedbacks: 5 },
+        [TrustTier.Silver]: { minScore: 65, minFeedbacks: 20 },
+        [TrustTier.Gold]: { minScore: 80, minFeedbacks: 50 },
+        [TrustTier.Platinum]: { minScore: 90, minFeedbacks: 100 },
+    };
+    return thresholds[tier] ?? { minScore: 0, minFeedbacks: 0 };
+}
+//# sourceMappingURL=reputation.js.map

package/dist/core/interfaces/reputation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reputation.js","sourceRoot":"","sources":["../../../src/core/interfaces/reputation.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAEhD,MAAM,CAAN,IAAY,SAMX;AAND,WAAY,SAAS;IACnB,+CAAW,CAAA;IACX,6CAAU,CAAA;IACV,6CAAU,CAAA;IACV,yCAAQ,CAAA;IACR,iDAAY,CAAA;AACd,CAAC,EANW,SAAS,KAAT,SAAS,QAMpB;AAwCD,MAAM,UAAU,gBAAgB,CAAC,IAAe;IAC9C,MAAM,KAAK,GAA8B;QACvC,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,SAAS;QAC9B,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,QAAQ;QAC5B,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,QAAQ;QAC5B,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM;QACxB,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,UAAU;KACjC,CAAC;IACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAe;IACnD,MAAM,UAAU,GAAkE;QAChF,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE;QACrD,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,YAAY,EAAE,CAAC,EAAE;QACrD,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE;QACtD,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE;QACpD,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,YAAY,EAAE,GAAG,EAAE;KAC1D,CAAC;IACF,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;AAC9D,CAAC"}

package/dist/core/interfaces/x402.d.ts

@@ -0,0 +1,226 @@
+import type { ChainType } from './agent.js';
+export declare const SOLANA_GENESIS_HASHES: {
+    readonly mainnet: "5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp";
+    readonly devnet: "EtWTRABZaYq6iMfeYKouRu166VU2xqa1";
+    readonly testnet: "4uhcVJyU9pJkvQyS88uRDiswHXSCkY3z";
+};
+/**
+ * Agent identity for x402 PaymentRequired responses
+ * Format follows CAIP-2 for registry addresses
+ */
+export interface X402AgentIdentity {
+    /**
+     * Registry address in CAIP-2 format
+     * EVM: "eip155:<chainId>:<address>" (e.g., "eip155:8453:0x1234...")
+     * Solana: "solana:<genesisHash>:<programId>" (e.g., "solana:EtWTRA...:HHCVWc...")
+     */
+    agentRegistry: string;
+    /**
+     * Agent identifier
+     * EVM: Token ID (e.g., "123")
+     * Solana: Asset public key (base58)
+     */
+    agentId: string;
+}
+/**
+ * Proof of payment from x402 settlement
+ * Used to link feedback to actual payment transactions
+ */
+export interface X402ProofOfPayment {
+    /**
+     * Payer address
+     * EVM: Hex address (0x...)
+     * Solana: Base58 public key
+     */
+    fromAddress: string;
+    /**
+     * Payee address
+     * EVM: Hex address (0x...)
+     * Solana: Base58 public key
+     */
+    toAddress: string;
+    /**
+     * Chain identifier
+     * EVM: Chain ID string (e.g., "8453" for Base)
+     * Solana: Genesis hash (e.g., "EtWTRABZaYq6iMfeYKouRu166VU2xqa1")
+     */
+    chainId: string;
+    /**
+     * Transaction hash/signature
+     * EVM: Hex transaction hash (0x...)
+     * Solana: Base58 transaction signature
+     */
+    txHash: string;
+}
+/**
+ * Settlement result from x402 payment flow
+ * Enriched information about the completed payment
+ */
+export interface X402Settlement {
+    /** Whether the settlement succeeded */
+    success: boolean;
+    /** Transaction hash/signature (same as ProofOfPayment.txHash) */
+    transaction: string;
+    /** Network in CAIP-2 format (e.g., "eip155:8453" or "solana:EtWTRA...") */
+    network: string;
+    /** Settlement timestamp in ISO 8601 format */
+    settledAt: string;
+}
+/**
+ * x402 tag conventions for feedback categorization
+ */
+export declare const X402_TAGS: {
+    readonly CLIENT_TAGS: {
+        readonly RESOURCE_DELIVERED: "x402-resource-delivered";
+        readonly DELIVERY_FAILED: "x402-delivery-failed";
+        readonly DELIVERY_TIMEOUT: "x402-delivery-timeout";
+        readonly QUALITY_ISSUE: "x402-quality-issue";
+    };
+    readonly SERVER_TAGS: {
+        readonly GOOD_PAYER: "x402-good-payer";
+        readonly PAYMENT_FAILED: "x402-payment-failed";
+        readonly INSUFFICIENT_FUNDS: "x402-insufficient-funds";
+    };
+    readonly NETWORK_TAGS: {
+        readonly EVM: "exact-evm";
+        readonly SVM: "exact-svm";
+    };
+};
+/**
+ * Feedback file structure for IPFS storage
+ * Conforms to x402 8004-reputation spec
+ */
+export interface X402FeedbackFile {
+    /** Registry in CAIP-2 format */
+    agentRegistry: string;
+    /** Agent ID (token ID or pubkey) */
+    agentId: string;
+    /** Client address in CAIP-2 format (e.g., "solana:EtWTRA...:ClientPubkey...") */
+    clientAddress: string;
+    /** Feedback creation timestamp (ISO 8601) */
+    createdAt: string;
+    /** Raw metric value (serialized as string for JSON compatibility) */
+    value: string;
+    /** Decimal precision (0-6), default 0 */
+    valueDecimals?: number;
+    /** Feedback score (0-100), optional */
+    score?: number;
+    /** Primary tag - delivery/payment status */
+    tag1: string;
+    /** Secondary tag - network type */
+    tag2: string;
+    /** Agent endpoint that was called */
+    endpoint?: string;
+    /** Proof of payment linking feedback to transaction */
+    proofOfPayment: X402ProofOfPayment;
+    /** Optional enriched settlement information */
+    x402Settlement?: X402Settlement;
+    /** Optional comment */
+    comment?: string;
+}
+/**
+ * Input for x402_feedback_submit tool
+ */
+export interface X402FeedbackSubmitInput {
+    /** Agent ID (global format like sol:xxx or chain:chainId:tokenId) */
+    agentId: string;
+    /** Raw metric value (required) */
+    value: bigint | number;
+    /** Decimal precision (0-6), default 0 */
+    valueDecimals?: number;
+    /** Feedback score (0-100), optional */
+    score?: number;
+    /** Primary tag (delivery/payment status) */
+    tag1: string;
+    /** Secondary tag (network type) */
+    tag2: string;
+    /** Agent endpoint that was called */
+    endpoint?: string;
+    /** Proof of payment */
+    proofOfPayment: X402ProofOfPayment;
+    /** Optional settlement info */
+    x402Settlement?: X402Settlement;
+    /** Optional comment */
+    comment?: string;
+    /** Validate proof on-chain (default: false) */
+    validateProof?: boolean;
+    /** Store feedback on IPFS (default: true) */
+    storeOnIpfs?: boolean;
+    /** Return unsigned transaction (default: false) */
+    skipSend?: boolean;
+    /** Signer public key if skipSend=true */
+    signer?: string;
+    /** Chain override (optional if using global ID) */
+    chain?: string;
+}
+/**
+ * Result from x402_feedback_submit when transaction is signed and sent
+ */
+export interface X402FeedbackSubmitSignedResult {
+    unsigned: false;
+    signature: string;
+    feedbackHash: string;
+    feedbackUri?: string;
+    agentId: string;
+    value: string;
+    valueDecimals: number;
+    score?: number;
+    tag1: string;
+    tag2: string;
+}
+/**
+ * Result from x402_feedback_submit when skipSend=true (unsigned)
+ */
+export interface X402FeedbackSubmitUnsignedResult {
+    unsigned: true;
+    /** Base64 serialized transaction (Solana) or transaction object (EVM) */
+    unsignedTx: string | X402EvmUnsignedTx;
+    feedbackHash: string;
+    feedbackUri?: string;
+    feedbackFile: X402FeedbackFile;
+    message: string;
+    hint: string;
+}
+/**
+ * EVM unsigned transaction object for external wallet signing
+ */
+export interface X402EvmUnsignedTx {
+    to: string;
+    data: string;
+    chainId: number;
+    value: string;
+}
+export type X402FeedbackSubmitResult = X402FeedbackSubmitSignedResult | X402FeedbackSubmitUnsignedResult;
+/**
+ * Helper to build CAIP-2 network identifier
+ */
+export declare function buildCaip2Network(chainType: ChainType, chainId: string | number): string;
+/**
+ * Helper to build agent registry CAIP-2 identifier
+ * @throws Error if registryAddress is undefined/empty (chain not deployed)
+ */
+export declare function buildRegistryIdentifier(chainType: ChainType, chainId: string | number, registryAddress: string | undefined): string;
+/**
+ * Helper to build client address CAIP-2 identifier
+ */
+export declare function buildClientAddress(chainType: ChainType, chainIdOrCluster: string | number, address: string): string;
+/**
+ * Convert X402FeedbackFile to a plain JSON-serializable object
+ */
+export declare function feedbackFileToRecord(file: X402FeedbackFile): Record<string, unknown>;
+/**
+ * Parse CAIP-2 network identifier
+ */
+export declare function parseCaip2Network(network: string): {
+    namespace: 'eip155' | 'solana';
+    reference: string;
+} | null;
+/**
+ * Get chain type from network tag
+ */
+export declare function getChainTypeFromNetworkTag(tag: string): ChainType | undefined;
+/**
+ * Get network tag for chain type
+ */
+export declare function getNetworkTagForChainType(chainType: ChainType): string;
+//# sourceMappingURL=x402.d.ts.map

package/dist/core/interfaces/x402.d.ts.map

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

package/dist/core/interfaces/x402.js

@@ -0,0 +1,120 @@
+// x402 Protocol Interfaces for 8004-reputation extension
+// Spec: https://github.com/coinbase/x402/issues/931
+// CAIP-2 Network Identifiers
+// EVM: eip155:<chainId> (e.g., eip155:8453 for Base)
+// Solana Mainnet: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp
+// Solana Devnet:  solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1
+export const SOLANA_GENESIS_HASHES = {
+    mainnet: '5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp',
+    devnet: 'EtWTRABZaYq6iMfeYKouRu166VU2xqa1',
+    testnet: '4uhcVJyU9pJkvQyS88uRDiswHXSCkY3z',
+};
+/**
+ * x402 tag conventions for feedback categorization
+ */
+export const X402_TAGS = {
+    // Client → Server (tag1) - delivery status
+    CLIENT_TAGS: {
+        RESOURCE_DELIVERED: 'x402-resource-delivered',
+        DELIVERY_FAILED: 'x402-delivery-failed',
+        DELIVERY_TIMEOUT: 'x402-delivery-timeout',
+        QUALITY_ISSUE: 'x402-quality-issue',
+    },
+    // Server → Client (tag1) - payment status
+    SERVER_TAGS: {
+        GOOD_PAYER: 'x402-good-payer',
+        PAYMENT_FAILED: 'x402-payment-failed',
+        INSUFFICIENT_FUNDS: 'x402-insufficient-funds',
+    },
+    // Network types (tag2)
+    NETWORK_TAGS: {
+        EVM: 'exact-evm',
+        SVM: 'exact-svm',
+    },
+};
+/**
+ * Helper to build CAIP-2 network identifier
+ */
+export function buildCaip2Network(chainType, chainId) {
+    if (chainType === 'solana') {
+        // chainId is cluster name, map to genesis hash
+        const cluster = String(chainId).toLowerCase();
+        const genesisHash = SOLANA_GENESIS_HASHES[cluster] ??
+            SOLANA_GENESIS_HASHES.devnet;
+        return `solana:${genesisHash}`;
+    }
+    // EVM
+    return `eip155:${chainId}`;
+}
+/**
+ * Helper to build agent registry CAIP-2 identifier
+ * @throws Error if registryAddress is undefined/empty (chain not deployed)
+ */
+export function buildRegistryIdentifier(chainType, chainId, registryAddress) {
+    if (!registryAddress) {
+        throw new Error(`Registry not deployed for chain ${chainType}:${chainId}`);
+    }
+    const network = buildCaip2Network(chainType, chainId);
+    return `${network}:${registryAddress}`;
+}
+/**
+ * Helper to build client address CAIP-2 identifier
+ */
+export function buildClientAddress(chainType, chainIdOrCluster, address) {
+    const network = buildCaip2Network(chainType, chainIdOrCluster);
+    return `${network}:${address}`;
+}
+/**
+ * Convert X402FeedbackFile to a plain JSON-serializable object
+ */
+export function feedbackFileToRecord(file) {
+    return {
+        agentRegistry: file.agentRegistry,
+        agentId: file.agentId,
+        clientAddress: file.clientAddress,
+        createdAt: file.createdAt,
+        value: file.value,
+        valueDecimals: file.valueDecimals,
+        score: file.score,
+        tag1: file.tag1,
+        tag2: file.tag2,
+        endpoint: file.endpoint,
+        proofOfPayment: file.proofOfPayment,
+        x402Settlement: file.x402Settlement,
+        comment: file.comment,
+    };
+}
+/**
+ * Parse CAIP-2 network identifier
+ */
+export function parseCaip2Network(network) {
+    const parts = network.split(':');
+    if (parts.length !== 2)
+        return null;
+    const namespace = parts[0];
+    const reference = parts[1];
+    if (namespace !== 'eip155' && namespace !== 'solana')
+        return null;
+    if (!reference)
+        return null;
+    return { namespace: namespace, reference };
+}
+/**
+ * Get chain type from network tag
+ */
+export function getChainTypeFromNetworkTag(tag) {
+    if (tag === X402_TAGS.NETWORK_TAGS.SVM)
+        return 'solana';
+    if (tag === X402_TAGS.NETWORK_TAGS.EVM)
+        return 'evm';
+    return undefined;
+}
+/**
+ * Get network tag for chain type
+ */
+export function getNetworkTagForChainType(chainType) {
+    return chainType === 'solana'
+        ? X402_TAGS.NETWORK_TAGS.SVM
+        : X402_TAGS.NETWORK_TAGS.EVM;
+}
+//# sourceMappingURL=x402.js.map

package/dist/core/interfaces/x402.js.map

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

package/dist/core/parsers/common.d.ts

@@ -0,0 +1,31 @@
+export type JsonRecord = Record<string, unknown>;
+export declare function isRecord(value: unknown): value is JsonRecord;
+export declare function getArgs(args: unknown): JsonRecord;
+export declare function readString(obj: JsonRecord, key: string, required: true): string;
+export declare function readString(obj: JsonRecord, key: string, required?: false): string | undefined;
+export declare function readStringOptional(obj: JsonRecord, key: string): string | undefined;
+export declare function readNumber(obj: JsonRecord, key: string, required: true): number;
+export declare function readNumber(obj: JsonRecord, key: string, required?: false): number | undefined;
+export declare function readBoolean(obj: JsonRecord, key: string, required: true): boolean;
+export declare function readBoolean(obj: JsonRecord, key: string, required?: false): boolean | undefined;
+export declare function readRecord(obj: JsonRecord, key: string, required: true): JsonRecord;
+export declare function readRecord(obj: JsonRecord, key: string, required?: false): JsonRecord | undefined;
+export declare function readStringArray(obj: JsonRecord, key: string, required: true): string[];
+export declare function readStringArray(obj: JsonRecord, key: string, required?: false): string[] | undefined;
+export declare function readArray(obj: JsonRecord, key: string, required: true): unknown[];
+export declare function readArray(obj: JsonRecord, key: string, required?: false): unknown[] | undefined;
+export declare function parseBigIntInput(value: unknown, fieldName: string): bigint;
+export declare function parseBuffer(value: unknown, fieldName: string): Buffer;
+export declare function parseChainParam(obj: JsonRecord): {
+    chainType?: 'solana' | 'evm';
+    chainPrefix?: string;
+    chainId?: string;
+};
+export declare function parsePagination(obj: JsonRecord, defaults?: {
+    limit?: number;
+    offset?: number;
+}): {
+    limit: number;
+    offset: number;
+};
+//# sourceMappingURL=common.d.ts.map

package/dist/core/parsers/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../src/core/parsers/common.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEjD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAE5D;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,UAAU,CAKjD;AAGD,wBAAgB,UAAU,CACxB,GAAG,EAAE,UAAU,EACf,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,IAAI,GACb,MAAM,CAAC;AACV,wBAAgB,UAAU,CACxB,GAAG,EAAE,UAAU,EACf,GAAG,EAAE,MAAM,EACX,QAAQ,CAAC,EAAE,KAAK,GACf,MAAM,GAAG,SAAS,CAAC;AAoBtB,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEnF;AAED,wBAAgB,UAAU,CACxB,GAAG,EAAE,UAAU,EACf,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,IAAI,GACb,MAAM,CAAC;AACV,wBAAgB,UAAU,CACxB,GAAG,EAAE,UAAU,EACf,GAAG,EAAE,MAAM,EACX,QAAQ,CAAC,EAAE,KAAK,GACf,MAAM,GAAG,SAAS,CAAC;AAmBtB,wBAAgB,WAAW,CACzB,GAAG,EAAE,UAAU,EACf,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,IAAI,GACb,OAAO,CAAC;AACX,wBAAgB,WAAW,CACzB,GAAG,EAAE,UAAU,EACf,GAAG,EAAE,MAAM,EACX,QAAQ,CAAC,EAAE,KAAK,GACf,OAAO,GAAG,SAAS,CAAC;AAmBvB,wBAAgB,UAAU,CACxB,GAAG,EAAE,UAAU,EACf,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,IAAI,GACb,UAAU,CAAC;AACd,wBAAgB,UAAU,CACxB,GAAG,EAAE,UAAU,EACf,GAAG,EAAE,MAAM,EACX,QAAQ,CAAC,EAAE,KAAK,GACf,UAAU,GAAG,SAAS,CAAC;AAmB1B,wBAAgB,eAAe,CAC7B,GAAG,EAAE,UAAU,EACf,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,IAAI,GACb,MAAM,EAAE,CAAC;AACZ,wBAAgB,eAAe,CAC7B,GAAG,EAAE,UAAU,EACf,GAAG,EAAE,MAAM,EACX,QAAQ,CAAC,EAAE,KAAK,GACf,MAAM,EAAE,GAAG,SAAS,CAAC;AAwBxB,wBAAgB,SAAS,CACvB,GAAG,EAAE,UAAU,EACf,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,IAAI,GACb,OAAO,EAAE,CAAC;AACb,wBAAgB,SAAS,CACvB,GAAG,EAAE,UAAU,EACf,GAAG,EAAE,MAAM,EACX,QAAQ,CAAC,EAAE,KAAK,GACf,OAAO,EAAE,GAAG,SAAS,CAAC;AAoBzB,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,GAChB,MAAM,CAkBR;AAGD,wBAAgB,WAAW,CACzB,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,GAChB,MAAM,CA2BR;AAGD,wBAAgB,eAAe,CAC7B,GAAG,EAAE,UAAU,GACd;IAAE,SAAS,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CA4B1E;AAGD,wBAAgB,eAAe,CAC7B,GAAG,EAAE,UAAU,EACf,QAAQ,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAOnC"}