@agirails/sdk 2.0.0-beta

package/dist/abi/ERC20.json

@@ -0,0 +1,38 @@
+[
+    {
+        "inputs": [
+            { "name": "spender", "type": "address" },
+            { "name": "amount", "type": "uint256" }
+        ],
+        "name": "approve",
+        "outputs": [{ "name": "", "type": "bool" }],
+        "stateMutability": "nonpayable",
+        "type": "function"
+    },
+    {
+        "inputs": [
+            { "name": "account", "type": "address" }
+        ],
+        "name": "balanceOf",
+        "outputs": [{ "name": "", "type": "uint256" }],
+        "stateMutability": "view",
+        "type": "function"
+    },
+    {
+        "inputs": [
+            { "name": "owner", "type": "address" },
+            { "name": "spender", "type": "address" }
+        ],
+        "name": "allowance",
+        "outputs": [{ "name": "", "type": "uint256" }],
+        "stateMutability": "view",
+        "type": "function"
+    },
+    {
+        "inputs": [],
+        "name": "decimals",
+        "outputs": [{ "name": "", "type": "uint8" }],
+        "stateMutability": "view",
+        "type": "function"
+    }
+]

package/dist/abi/EscrowVault.json

@@ -0,0 +1,64 @@
+[
+    {
+        "inputs": [
+            { "name": "kernel", "type": "address" },
+            { "name": "txId", "type": "bytes32" },
+            { "name": "token", "type": "address" },
+            { "name": "amount", "type": "uint256" },
+            { "name": "beneficiary", "type": "address" }
+        ],
+        "name": "createEscrow",
+        "outputs": [{ "name": "escrowId", "type": "bytes32" }],
+        "stateMutability": "nonpayable",
+        "type": "function"
+    },
+    {
+        "inputs": [
+            { "name": "escrowId", "type": "bytes32" },
+            { "name": "recipients", "type": "address[]" },
+            { "name": "amounts", "type": "uint256[]" }
+        ],
+        "name": "disburse",
+        "outputs": [],
+        "stateMutability": "nonpayable",
+        "type": "function"
+    },
+    {
+        "inputs": [
+            { "name": "escrowId", "type": "bytes32" }
+        ],
+        "name": "escrows",
+        "outputs": [
+            { "name": "kernel", "type": "address" },
+            { "name": "txId", "type": "bytes32" },
+            { "name": "token", "type": "address" },
+            { "name": "amount", "type": "uint256" },
+            { "name": "beneficiary", "type": "address" },
+            { "name": "released", "type": "bool" }
+        ],
+        "stateMutability": "view",
+        "type": "function"
+    },
+    {
+        "anonymous": false,
+        "inputs": [
+            { "indexed": true, "name": "escrowId", "type": "bytes32" },
+            { "indexed": true, "name": "kernel", "type": "address" },
+            { "indexed": true, "name": "txId", "type": "bytes32" },
+            { "indexed": false, "name": "token", "type": "address" },
+            { "indexed": false, "name": "amount", "type": "uint256" }
+        ],
+        "name": "EscrowCreated",
+        "type": "event"
+    },
+    {
+        "anonymous": false,
+        "inputs": [
+            { "indexed": true, "name": "escrowId", "type": "bytes32" },
+            { "indexed": false, "name": "recipients", "type": "address[]" },
+            { "indexed": false, "name": "amounts", "type": "uint256[]" }
+        ],
+        "name": "EscrowReleased",
+        "type": "event"
+    }
+]

package/dist/builders/DeliveryProofBuilder.d.ts

@@ -0,0 +1,37 @@
+import { Signer } from 'ethers';
+import { EAS } from '@ethereum-attestation-service/eas-sdk';
+import { IPFSClient } from '../utils/IPFSClient';
+import { NonceManager } from '../utils/NonceManager';
+import { DeliveryProofMessage } from '../types/message';
+export declare const AGIRAILS_DELIVERY_SCHEMA_UID = "0x0000000000000000000000000000000000000000000000000000000000000000";
+export interface DeliveryProofParams {
+    txId: string;
+    provider: string;
+    consumer: string;
+    resultData: any;
+    metadata?: {
+        executionTime?: number;
+        outputFormat?: string;
+        outputSize?: number;
+        notes?: string;
+    };
+    chainId: number;
+    kernelAddress: string;
+}
+export declare class DeliveryProofBuilder {
+    private ipfs;
+    private signer;
+    private nonceManager;
+    private eas;
+    constructor(ipfs: IPFSClient, signer: Signer, nonceManager: NonceManager, eas: EAS);
+    build(params: DeliveryProofParams): Promise<{
+        deliveryProof: DeliveryProofMessage;
+        deliveryProofCID: string;
+        attestationUID: string;
+    }>;
+    verify(deliveryProof: DeliveryProofMessage, resultData: any, kernelAddress: string): Promise<boolean>;
+    private signDeliveryProof;
+    private recoverDeliveryProofSigner;
+    private extractAddressFromDID;
+}
+//# sourceMappingURL=DeliveryProofBuilder.d.ts.map

package/dist/builders/DeliveryProofBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeliveryProofBuilder.d.ts","sourceRoot":"","sources":["../../src/builders/DeliveryProofBuilder.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,MAAM,EAAmB,MAAM,QAAQ,CAAC;AACjD,OAAO,EAAE,GAAG,EAAiB,MAAM,uCAAuC,CAAC;AAE3E,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAOxD,eAAO,MAAM,4BAA4B,uEAAuE,CAAC;AAKjH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,GAAG,CAAC;IAChB,QAAQ,CAAC,EAAE;QACT,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;CACvB;AAOD,qBAAa,oBAAoB;IAE7B,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,GAAG;gBAHH,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,YAAY,EAC1B,GAAG,EAAE,GAAG;IAUZ,KAAK,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC;QAChD,aAAa,EAAE,oBAAoB,CAAC;QACpC,gBAAgB,EAAE,MAAM,CAAC;QACzB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IAmFI,MAAM,CACV,aAAa,EAAE,oBAAoB,EACnC,UAAU,EAAE,GAAG,EACf,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,OAAO,CAAC;YAqEL,iBAAiB;YA6CjB,0BAA0B;IA+CxC,OAAO,CAAC,qBAAqB;CAU9B"}

package/dist/builders/DeliveryProofBuilder.js

@@ -0,0 +1,165 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeliveryProofBuilder = exports.AGIRAILS_DELIVERY_SCHEMA_UID = void 0;
+const ethers_1 = require("ethers");
+const eas_sdk_1 = require("@ethereum-attestation-service/eas-sdk");
+const canonicalJson_1 = require("../utils/canonicalJson");
+const eip712_1 = require("../types/eip712");
+exports.AGIRAILS_DELIVERY_SCHEMA_UID = '0x0000000000000000000000000000000000000000000000000000000000000000';
+class DeliveryProofBuilder {
+    constructor(ipfs, signer, nonceManager, eas) {
+        this.ipfs = ipfs;
+        this.signer = signer;
+        this.nonceManager = nonceManager;
+        this.eas = eas;
+    }
+    async build(params) {
+        const resultCID = await this.ipfs.add(JSON.stringify(params.resultData));
+        await this.ipfs.pin(resultCID);
+        const resultHash = (0, canonicalJson_1.computeResultHash)(params.resultData);
+        const deliveredAt = Math.floor(Date.now() / 1000);
+        const schemaEncoder = new eas_sdk_1.SchemaEncoder('bytes32 txId,string resultCID,bytes32 resultHash,uint256 deliveredAt');
+        const consumerAddress = this.extractAddressFromDID(params.consumer);
+        const encodedData = schemaEncoder.encodeData([
+            { name: 'txId', value: params.txId, type: 'bytes32' },
+            { name: 'resultCID', value: resultCID, type: 'string' },
+            { name: 'resultHash', value: resultHash, type: 'bytes32' },
+            { name: 'deliveredAt', value: deliveredAt, type: 'uint256' }
+        ]);
+        const tx = await this.eas.attest({
+            schema: exports.AGIRAILS_DELIVERY_SCHEMA_UID,
+            data: {
+                recipient: consumerAddress,
+                expirationTime: 0n,
+                revocable: false,
+                data: encodedData
+            }
+        });
+        const receipt = await tx.wait();
+        const attestationUID = receipt.newAttestationUID || receipt;
+        const deliveryProof = {
+            type: 'agirails.delivery.v1',
+            version: '1.0.0',
+            txId: params.txId,
+            provider: params.provider,
+            consumer: params.consumer,
+            resultCID,
+            resultHash,
+            metadata: params.metadata || {},
+            easAttestationUID: attestationUID,
+            deliveredAt,
+            chainId: params.chainId,
+            nonce: this.nonceManager.getNextNonce('agirails.delivery.v1'),
+            signature: ''
+        };
+        const signature = await this.signDeliveryProof(deliveryProof, params.kernelAddress);
+        deliveryProof.signature = signature;
+        const deliveryProofCID = await this.ipfs.add(JSON.stringify(deliveryProof));
+        await this.ipfs.pin(deliveryProofCID);
+        this.nonceManager.recordNonce('agirails.delivery.v1', deliveryProof.nonce);
+        return {
+            deliveryProof,
+            deliveryProofCID,
+            attestationUID
+        };
+    }
+    async verify(deliveryProof, resultData, kernelAddress) {
+        const recoveredAddress = await this.recoverDeliveryProofSigner(deliveryProof, kernelAddress);
+        const expectedAddress = this.extractAddressFromDID(deliveryProof.provider);
+        if (recoveredAddress.toLowerCase() !== expectedAddress.toLowerCase()) {
+            throw new Error('Invalid signature: recovered address does not match provider');
+        }
+        const computedHash = (0, canonicalJson_1.computeResultHash)(resultData);
+        if (computedHash !== deliveryProof.resultHash) {
+            throw new Error('Result hash mismatch - data may be tampered');
+        }
+        const attestation = await this.eas.getAttestation(deliveryProof.easAttestationUID);
+        if (!attestation) {
+            throw new Error('Attestation not found on EAS');
+        }
+        if (attestation.schema !== exports.AGIRAILS_DELIVERY_SCHEMA_UID) {
+            throw new Error(`Invalid attestation schema: expected ${exports.AGIRAILS_DELIVERY_SCHEMA_UID}, got ${attestation.schema}`);
+        }
+        if ('revoked' in attestation && attestation.revoked) {
+            throw new Error('Attestation was revoked');
+        }
+        if ('revocationTime' in attestation && attestation.revocationTime > 0) {
+            throw new Error('Attestation was revoked');
+        }
+        const schemaEncoder = new eas_sdk_1.SchemaEncoder('bytes32 txId,string resultCID,bytes32 resultHash,uint256 deliveredAt');
+        const decodedData = schemaEncoder.decodeData(attestation.data);
+        const attestationTxId = decodedData.find((d) => d.name === 'txId')?.value.value;
+        const attestationResultCID = decodedData.find((d) => d.name === 'resultCID')?.value.value;
+        const attestationResultHash = decodedData.find((d) => d.name === 'resultHash')?.value.value;
+        if (attestationTxId !== deliveryProof.txId) {
+            throw new Error('Attestation txId mismatch');
+        }
+        if (attestationResultCID !== deliveryProof.resultCID) {
+            throw new Error('Attestation resultCID mismatch');
+        }
+        if (attestationResultHash !== deliveryProof.resultHash) {
+            throw new Error('Attestation resultHash mismatch');
+        }
+        return true;
+    }
+    async signDeliveryProof(deliveryProof, kernelAddress) {
+        const domain = {
+            name: 'AGIRAILS',
+            version: '1',
+            chainId: deliveryProof.chainId,
+            verifyingContract: kernelAddress
+        };
+        const message = {
+            txId: deliveryProof.txId,
+            provider: deliveryProof.provider,
+            consumer: deliveryProof.consumer,
+            resultCID: deliveryProof.resultCID,
+            resultHash: deliveryProof.resultHash,
+            easAttestationUID: deliveryProof.easAttestationUID,
+            deliveredAt: deliveryProof.deliveredAt,
+            chainId: deliveryProof.chainId,
+            nonce: deliveryProof.nonce
+        };
+        if ('signTypedData' in this.signer && typeof this.signer.signTypedData === 'function') {
+            const signature = await this.signer.signTypedData(domain, eip712_1.AIP4DeliveryProofTypes, message);
+            return signature;
+        }
+        throw new Error('Signer does not support EIP-712 typed data signing (ethers v6+)');
+    }
+    async recoverDeliveryProofSigner(deliveryProof, kernelAddress) {
+        const domain = {
+            name: 'AGIRAILS',
+            version: '1',
+            chainId: deliveryProof.chainId,
+            verifyingContract: kernelAddress
+        };
+        const message = {
+            txId: deliveryProof.txId,
+            provider: deliveryProof.provider,
+            consumer: deliveryProof.consumer,
+            resultCID: deliveryProof.resultCID,
+            resultHash: deliveryProof.resultHash,
+            easAttestationUID: deliveryProof.easAttestationUID,
+            deliveredAt: deliveryProof.deliveredAt,
+            chainId: deliveryProof.chainId,
+            nonce: deliveryProof.nonce
+        };
+        try {
+            const recoveredAddress = (0, ethers_1.verifyTypedData)(domain, eip712_1.AIP4DeliveryProofTypes, message, deliveryProof.signature);
+            return recoveredAddress;
+        }
+        catch (error) {
+            throw new Error(`Invalid signature: ${error.message || 'signature verification failed'}`);
+        }
+    }
+    extractAddressFromDID(did) {
+        const parts = did.replace('did:ethr:', '').split(':');
+        const address = parts.length === 2 ? parts[1] : parts[0];
+        if (!address.startsWith('0x') || address.length !== 42) {
+            throw new Error(`Invalid DID format: ${did}`);
+        }
+        return address;
+    }
+}
+exports.DeliveryProofBuilder = DeliveryProofBuilder;
+//# sourceMappingURL=DeliveryProofBuilder.js.map

package/dist/builders/DeliveryProofBuilder.js.map

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

package/dist/builders/QuoteBuilder.d.ts

@@ -0,0 +1,68 @@
+import { Signer } from 'ethers';
+import { IPFSClient } from '../utils/IPFSClient';
+import { NonceManager } from '../utils/NonceManager';
+export interface QuoteMessage {
+    type: 'agirails.quote.v1';
+    version: '1.0.0';
+    txId: string;
+    provider: string;
+    consumer: string;
+    quotedAmount: string;
+    originalAmount: string;
+    maxPrice: string;
+    currency: string;
+    decimals: number;
+    quotedAt: number;
+    expiresAt: number;
+    justification?: {
+        reason?: string;
+        estimatedTime?: number;
+        computeCost?: number;
+        breakdown?: Record<string, any>;
+    };
+    chainId: number;
+    nonce: number;
+    signature: string;
+}
+export interface QuoteParams {
+    txId: string;
+    provider: string;
+    consumer: string;
+    quotedAmount: string;
+    originalAmount: string;
+    maxPrice: string;
+    currency?: string;
+    decimals?: number;
+    expiresAt?: number;
+    justification?: {
+        reason?: string;
+        estimatedTime?: number;
+        computeCost?: number;
+        breakdown?: Record<string, any>;
+    };
+    chainId: number;
+    kernelAddress: string;
+}
+export declare const AIP2QuoteTypes: {
+    PriceQuote: {
+        name: string;
+        type: string;
+    }[];
+};
+export declare class QuoteBuilder {
+    private signer;
+    private nonceManager;
+    private ipfs?;
+    constructor(signer: Signer, nonceManager: NonceManager, ipfs?: IPFSClient | undefined);
+    build(params: QuoteParams): Promise<QuoteMessage>;
+    verify(quote: QuoteMessage, kernelAddress: string): Promise<boolean>;
+    uploadToIPFS(quote: QuoteMessage): Promise<string>;
+    computeHash(quote: QuoteMessage): string;
+    private signQuote;
+    private recoverQuoteSigner;
+    private computeJustificationHash;
+    private validateParams;
+    private validateQuoteSchema;
+    private extractAddressFromDID;
+}
+//# sourceMappingURL=QuoteBuilder.d.ts.map

package/dist/builders/QuoteBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QuoteBuilder.d.ts","sourceRoot":"","sources":["../../src/builders/QuoteBuilder.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,MAAM,EAA2C,MAAM,QAAQ,CAAC;AAEzE,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAQrD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KACjC,CAAC;IACF,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KACjC,CAAC;IACF,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;CACvB;AAMD,eAAO,MAAM,cAAc;;;;;CAgB1B,CAAC;AAMF,qBAAa,YAAY;IAErB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,IAAI,CAAC;gBAFL,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,YAAY,EAC1B,IAAI,CAAC,EAAE,UAAU,YAAA;IAUrB,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAsDjD,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAmDpE,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAkBxD,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM;YAc1B,SAAS;IA4CvB,OAAO,CAAC,kBAAkB;IA+C1B,OAAO,CAAC,wBAAwB;IAehC,OAAO,CAAC,cAAc;IA6DtB,OAAO,CAAC,mBAAmB;IA0D3B,OAAO,CAAC,qBAAqB;CAU9B"}

package/dist/builders/QuoteBuilder.js

@@ -0,0 +1,255 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QuoteBuilder = exports.AIP2QuoteTypes = void 0;
+const ethers_1 = require("ethers");
+const canonicalJson_1 = require("../utils/canonicalJson");
+const errors_1 = require("../errors");
+exports.AIP2QuoteTypes = {
+    PriceQuote: [
+        { name: 'txId', type: 'bytes32' },
+        { name: 'provider', type: 'string' },
+        { name: 'consumer', type: 'string' },
+        { name: 'quotedAmount', type: 'string' },
+        { name: 'originalAmount', type: 'string' },
+        { name: 'maxPrice', type: 'string' },
+        { name: 'currency', type: 'string' },
+        { name: 'decimals', type: 'uint8' },
+        { name: 'quotedAt', type: 'uint256' },
+        { name: 'expiresAt', type: 'uint256' },
+        { name: 'justificationHash', type: 'bytes32' },
+        { name: 'chainId', type: 'uint256' },
+        { name: 'nonce', type: 'uint256' }
+    ]
+};
+class QuoteBuilder {
+    constructor(signer, nonceManager, ipfs) {
+        this.signer = signer;
+        this.nonceManager = nonceManager;
+        this.ipfs = ipfs;
+    }
+    async build(params) {
+        this.validateParams(params);
+        const quotedAt = Math.floor(Date.now() / 1000);
+        const expiresAt = params.expiresAt || (quotedAt + 3600);
+        if (expiresAt <= quotedAt) {
+            throw new Error('expiresAt must be after quotedAt');
+        }
+        if (expiresAt > quotedAt + 86400) {
+            throw new Error('expiresAt cannot exceed 24 hours from quotedAt');
+        }
+        const quote = {
+            type: 'agirails.quote.v1',
+            version: '1.0.0',
+            txId: params.txId,
+            provider: params.provider,
+            consumer: params.consumer,
+            quotedAmount: params.quotedAmount,
+            originalAmount: params.originalAmount,
+            maxPrice: params.maxPrice,
+            currency: params.currency || 'USDC',
+            decimals: params.decimals !== undefined ? params.decimals : 6,
+            quotedAt,
+            expiresAt,
+            justification: params.justification,
+            chainId: params.chainId,
+            nonce: this.nonceManager.getNextNonce('agirails.quote.v1'),
+            signature: ''
+        };
+        const signature = await this.signQuote(quote, params.kernelAddress);
+        quote.signature = signature;
+        this.nonceManager.recordNonce('agirails.quote.v1', quote.nonce);
+        return quote;
+    }
+    async verify(quote, kernelAddress) {
+        this.validateQuoteSchema(quote);
+        const recoveredAddress = this.recoverQuoteSigner(quote, kernelAddress);
+        const expectedAddress = this.extractAddressFromDID(quote.provider);
+        if (recoveredAddress.toLowerCase() !== expectedAddress.toLowerCase()) {
+            throw new Error('Invalid signature: recovered address does not match provider');
+        }
+        const quotedAmount = BigInt(quote.quotedAmount);
+        const originalAmount = BigInt(quote.originalAmount);
+        const maxPrice = BigInt(quote.maxPrice);
+        if (quotedAmount < originalAmount) {
+            throw new Error('Quoted amount below original amount');
+        }
+        if (quotedAmount > maxPrice) {
+            throw new Error('Quoted amount exceeds maxPrice');
+        }
+        if (quotedAmount < 50000n) {
+            throw new Error('Quoted amount below platform minimum ($0.05)');
+        }
+        const now = Math.floor(Date.now() / 1000);
+        if (quote.expiresAt < now) {
+            throw new Error('Quote expired');
+        }
+        if (Math.abs(now - quote.quotedAt) > 300) {
+            throw new Error('Quote timestamp outside 5-minute tolerance');
+        }
+        return true;
+    }
+    async uploadToIPFS(quote) {
+        if (!this.ipfs) {
+            throw new Error('IPFS client not configured');
+        }
+        const cid = await this.ipfs.add(JSON.stringify(quote));
+        await this.ipfs.pin(cid);
+        return cid;
+    }
+    computeHash(quote) {
+        const { signature, ...quoteWithoutSig } = quote;
+        return (0, ethers_1.keccak256)((0, ethers_1.toUtf8Bytes)((0, canonicalJson_1.canonicalJsonStringify)(quoteWithoutSig)));
+    }
+    async signQuote(quote, kernelAddress) {
+        const domain = {
+            name: 'AGIRAILS',
+            version: '1',
+            chainId: quote.chainId,
+            verifyingContract: kernelAddress
+        };
+        const justificationHash = this.computeJustificationHash(quote.justification);
+        const message = {
+            txId: quote.txId,
+            provider: quote.provider,
+            consumer: quote.consumer,
+            quotedAmount: quote.quotedAmount,
+            originalAmount: quote.originalAmount,
+            maxPrice: quote.maxPrice,
+            currency: quote.currency,
+            decimals: quote.decimals,
+            quotedAt: quote.quotedAt,
+            expiresAt: quote.expiresAt,
+            justificationHash,
+            chainId: quote.chainId,
+            nonce: quote.nonce
+        };
+        if ('signTypedData' in this.signer && typeof this.signer.signTypedData === 'function') {
+            const signature = await this.signer.signTypedData(domain, exports.AIP2QuoteTypes, message);
+            return signature;
+        }
+        throw new Error('Signer does not support EIP-712 typed data signing');
+    }
+    recoverQuoteSigner(quote, kernelAddress) {
+        const domain = {
+            name: 'AGIRAILS',
+            version: '1',
+            chainId: quote.chainId,
+            verifyingContract: kernelAddress
+        };
+        const justificationHash = this.computeJustificationHash(quote.justification);
+        const message = {
+            txId: quote.txId,
+            provider: quote.provider,
+            consumer: quote.consumer,
+            quotedAmount: quote.quotedAmount,
+            originalAmount: quote.originalAmount,
+            maxPrice: quote.maxPrice,
+            currency: quote.currency,
+            decimals: quote.decimals,
+            quotedAt: quote.quotedAt,
+            expiresAt: quote.expiresAt,
+            justificationHash,
+            chainId: quote.chainId,
+            nonce: quote.nonce
+        };
+        try {
+            const recoveredAddress = (0, ethers_1.verifyTypedData)(domain, exports.AIP2QuoteTypes, message, quote.signature);
+            return recoveredAddress;
+        }
+        catch (error) {
+            throw new errors_1.SignatureVerificationError(quote.provider, 'unknown');
+        }
+    }
+    computeJustificationHash(justification) {
+        if (!justification || Object.keys(justification).length === 0) {
+            return '0x0000000000000000000000000000000000000000000000000000000000000000';
+        }
+        return (0, ethers_1.keccak256)((0, ethers_1.toUtf8Bytes)((0, canonicalJson_1.canonicalJsonStringify)(justification)));
+    }
+    validateParams(params) {
+        const quotedAmount = BigInt(params.quotedAmount);
+        const originalAmount = BigInt(params.originalAmount);
+        const maxPrice = BigInt(params.maxPrice);
+        if (quotedAmount < originalAmount) {
+            throw new Error('quotedAmount must be >= originalAmount');
+        }
+        if (quotedAmount > maxPrice) {
+            throw new Error('quotedAmount must be <= maxPrice');
+        }
+        if (quotedAmount < 50000n) {
+            throw new Error('quotedAmount must be >= $0.05 (50000 base units)');
+        }
+        if (params.expiresAt) {
+            const now = Math.floor(Date.now() / 1000);
+            if (params.expiresAt <= now) {
+                throw new Error('expiresAt must be in the future');
+            }
+            if (params.expiresAt > now + 86400) {
+                throw new Error('expiresAt cannot be more than 24 hours in future');
+            }
+        }
+        if (!params.provider.startsWith('did:ethr:')) {
+            throw new Error('provider must be valid did:ethr format');
+        }
+        if (!params.consumer.startsWith('did:ethr:')) {
+            throw new Error('consumer must be valid did:ethr format');
+        }
+        if (!/^0x[a-fA-F0-9]{64}$/.test(params.txId)) {
+            throw new Error('txId must be valid bytes32 hex string');
+        }
+        if (!/^0x[a-fA-F0-9]{40}$/.test(params.kernelAddress)) {
+            throw new Error('kernelAddress must be valid Ethereum address');
+        }
+        if (params.chainId !== 84532 && params.chainId !== 8453) {
+            throw new Error('chainId must be 84532 (Base Sepolia) or 8453 (Base Mainnet)');
+        }
+    }
+    validateQuoteSchema(quote) {
+        if (quote.type !== 'agirails.quote.v1') {
+            throw new Error('Invalid message type');
+        }
+        if (!/^\d+\.\d+\.\d+$/.test(quote.version)) {
+            throw new Error('Invalid version format');
+        }
+        if (!/^0x[a-fA-F0-9]{64}$/.test(quote.txId)) {
+            throw new Error('Invalid txId format');
+        }
+        if (!quote.provider.startsWith('did:ethr:')) {
+            throw new Error('Invalid provider DID format');
+        }
+        if (!quote.consumer.startsWith('did:ethr:')) {
+            throw new Error('Invalid consumer DID format');
+        }
+        if (!/^\d+$/.test(quote.quotedAmount)) {
+            throw new Error('Invalid quotedAmount format (must be numeric string)');
+        }
+        if (!/^\d+$/.test(quote.originalAmount)) {
+            throw new Error('Invalid originalAmount format (must be numeric string)');
+        }
+        if (!/^\d+$/.test(quote.maxPrice)) {
+            throw new Error('Invalid maxPrice format (must be numeric string)');
+        }
+        if (quote.currency !== 'USDC') {
+            throw new Error('Only USDC currency is supported');
+        }
+        if (quote.decimals !== 6) {
+            throw new Error('USDC must use 6 decimals');
+        }
+        if (quote.chainId !== 84532 && quote.chainId !== 8453) {
+            throw new Error('Invalid chainId');
+        }
+        if (!/^0x[a-fA-F0-9]{130}$/.test(quote.signature)) {
+            throw new Error('Invalid signature format');
+        }
+    }
+    extractAddressFromDID(did) {
+        const parts = did.replace('did:ethr:', '').split(':');
+        const address = parts.length === 2 ? parts[1] : parts[0];
+        if (!address.startsWith('0x') || address.length !== 42) {
+            throw new Error(`Invalid DID format: ${did}`);
+        }
+        return address;
+    }
+}
+exports.QuoteBuilder = QuoteBuilder;
+//# sourceMappingURL=QuoteBuilder.js.map