@rpp402/protocol 0.1.3

package/dist/index.d.cts

@@ -0,0 +1,727 @@
+type ChainId = string;
+type WalletAddress = `0x${string}`;
+type DecimalString = string;
+type Timestamp = string;
+/** RPP402-001 §Protocol */
+type AssetRef = {
+    type: "stablecoin";
+    symbol: string;
+    chain_id: ChainId;
+    contract: WalletAddress;
+} | {
+    type: "tokenized_security";
+    symbol: string;
+    chain_id: ChainId;
+    contract: WalletAddress;
+    issuer: string;
+};
+/** RPP402-002 §Protocol */
+interface Money {
+    asset: AssetRef;
+    amount: DecimalString;
+}
+/** RPP402-001 -Discovery Document */
+interface Capability {
+    name: string;
+    description: string;
+    pricing_summary?: string;
+}
+interface DiscoveryDocument {
+    rpp402_version: "1.0";
+    service: {
+        id: string;
+        name: string;
+        description: string;
+    };
+    wallet: {
+        address: WalletAddress;
+        chain_id: ChainId;
+    };
+    capabilities: Capability[];
+    supported_assets: AssetRef[];
+    endpoints: {
+        quote: string;
+        session: string;
+        receipts: string;
+    };
+}
+/** RPP402-002 -Quote */
+interface QuoteRequest {
+    capability: string;
+    params?: Record<string, unknown>;
+    settlement_asset: AssetRef;
+    agent_wallet: WalletAddress;
+}
+interface Quote {
+    rpp402_version: "1.0";
+    id: `quote_${string}`;
+    service_id: `svc_${string}`;
+    capability: string;
+    price: Money;
+    expires_at: Timestamp;
+    created_at: Timestamp;
+}
+/** RPP402-003 -Commerce Session */
+type SessionStatus = "created" | "quoting" | "intent_authorized" | "settling" | "settled" | "receipt_issued" | "expired" | "cancelled" | "failed";
+interface SessionLeg {
+    quote_id: `quote_${string}`;
+    service_id: `svc_${string}`;
+    capability: string;
+    price: Money;
+}
+interface CommerceSession {
+    rpp402_version: "1.0";
+    id: `sess_${string}`;
+    agent_wallet: WalletAddress;
+    status: SessionStatus;
+    legs: SessionLeg[];
+    intent_id: `intent_${string}` | null;
+    settlement_id: `settle_${string}` | null;
+    receipt_id: `rcpt_${string}` | null;
+    created_at: Timestamp;
+    expires_at: Timestamp;
+}
+/** RPP402-004 -Payment Intent */
+type AmountMode = "fixed_quantity" | "notional_usd";
+type IntentAuthorization = {
+    type: "eip712_signature";
+    signer: WalletAddress;
+    signature: `0x${string}`;
+    nonce: string;
+} | {
+    type: "agentic_account_delegation";
+    account_id: `aa_${string}`;
+    delegation_ref: `del_${string}`;
+    risk_check?: string;
+};
+type IntentStatus = "pending" | "authorized" | "revoked" | "expired";
+interface PaymentIntent {
+    rpp402_version: "1.0";
+    id: `intent_${string}`;
+    session_id: `sess_${string}`;
+    payer_wallet: WalletAddress;
+    asset: AssetRef;
+    amount_mode: AmountMode | null;
+    amount: DecimalString;
+    status: IntentStatus;
+    authorization: IntentAuthorization;
+    created_at: Timestamp;
+    expires_at: Timestamp;
+}
+/** RPP402-005 -Settlement */
+type SettlementStatus = "pending" | "submitted" | "confirmed" | "failed";
+interface Transfer {
+    from: WalletAddress;
+    to: WalletAddress;
+    asset: AssetRef;
+    amount: DecimalString;
+}
+interface ReferencePrice {
+    oracle: string;
+    symbol: string;
+    price_usd: DecimalString;
+    sourced_at: Timestamp;
+}
+interface Settlement {
+    rpp402_version: "1.0";
+    id: `settle_${string}`;
+    intent_id: `intent_${string}`;
+    session_id: `sess_${string}`;
+    chain_id: ChainId;
+    tx_hash: `0x${string}` | null;
+    block_number: number | null;
+    status: SettlementStatus;
+    transfers: Transfer[];
+    reference_price: ReferencePrice | null;
+    created_at: Timestamp;
+    confirmed_at: Timestamp | null;
+}
+/** RPP402-006 -Receipt */
+interface LineItem {
+    service_id: `svc_${string}`;
+    capability: string;
+    quote_id: `quote_${string}`;
+    amount: Money;
+}
+interface SettlementRef {
+    chain_id: ChainId;
+    tx_hash: `0x${string}`;
+    block_number: number;
+}
+interface ReceiptSignature {
+    algorithm: "eip712";
+    signer: WalletAddress;
+    signature: `0x${string}`;
+}
+interface Receipt {
+    rpp402_version: "1.0";
+    id: `rcpt_${string}`;
+    session_id: `sess_${string}`;
+    settlement_id: `settle_${string}`;
+    payer_wallet: WalletAddress;
+    line_items: LineItem[];
+    total: Money;
+    settlement_ref: SettlementRef;
+    signature: ReceiptSignature;
+    issued_at: Timestamp;
+}
+
+declare const schemas: {
+    readonly assetRef: {
+        $schema: string;
+        $id: string;
+        title: string;
+        type: string;
+        required: string[];
+        properties: {
+            type: {
+                type: string;
+                enum: string[];
+            };
+            symbol: {
+                type: string;
+            };
+            chain_id: {
+                type: string;
+            };
+            contract: {
+                type: string;
+                pattern: string;
+            };
+            issuer: {
+                type: string;
+            };
+        };
+        if: {
+            properties: {
+                type: {
+                    const: string;
+                };
+            };
+        };
+        then: {
+            required: string[];
+        };
+    };
+    readonly discovery: {
+        $schema: string;
+        $id: string;
+        title: string;
+        type: string;
+        required: string[];
+        properties: {
+            rpp402_version: {
+                type: string;
+                const: string;
+            };
+            service: {
+                type: string;
+                required: string[];
+                properties: {
+                    id: {
+                        type: string;
+                        pattern: string;
+                    };
+                    name: {
+                        type: string;
+                        minLength: number;
+                    };
+                    description: {
+                        type: string;
+                        minLength: number;
+                    };
+                };
+            };
+            wallet: {
+                type: string;
+                required: string[];
+                properties: {
+                    address: {
+                        type: string;
+                        pattern: string;
+                    };
+                    chain_id: {
+                        type: string;
+                    };
+                };
+            };
+            capabilities: {
+                type: string;
+                minItems: number;
+                items: {
+                    type: string;
+                    required: string[];
+                    properties: {
+                        name: {
+                            type: string;
+                            pattern: string;
+                        };
+                        description: {
+                            type: string;
+                        };
+                        pricing_summary: {
+                            type: string;
+                        };
+                    };
+                };
+            };
+            supported_assets: {
+                type: string;
+                minItems: number;
+                items: {
+                    $ref: string;
+                };
+            };
+            endpoints: {
+                type: string;
+                required: string[];
+                properties: {
+                    quote: {
+                        type: string;
+                        format: string;
+                    };
+                    session: {
+                        type: string;
+                        format: string;
+                    };
+                    receipts: {
+                        type: string;
+                        format: string;
+                    };
+                };
+            };
+        };
+    };
+    readonly quote: {
+        $schema: string;
+        $id: string;
+        title: string;
+        type: string;
+        required: string[];
+        properties: {
+            rpp402_version: {
+                type: string;
+                const: string;
+            };
+            id: {
+                type: string;
+                pattern: string;
+            };
+            service_id: {
+                type: string;
+                pattern: string;
+            };
+            capability: {
+                type: string;
+                pattern: string;
+            };
+            price: {
+                type: string;
+                required: string[];
+                properties: {
+                    asset: {
+                        $ref: string;
+                    };
+                    amount: {
+                        type: string;
+                        pattern: string;
+                    };
+                };
+            };
+            expires_at: {
+                type: string;
+                format: string;
+            };
+            created_at: {
+                type: string;
+                format: string;
+            };
+        };
+    };
+    readonly commerceSession: {
+        $schema: string;
+        $id: string;
+        title: string;
+        type: string;
+        required: string[];
+        properties: {
+            rpp402_version: {
+                type: string;
+                const: string;
+            };
+            id: {
+                type: string;
+                pattern: string;
+            };
+            agent_wallet: {
+                type: string;
+                pattern: string;
+            };
+            status: {
+                type: string;
+                enum: string[];
+            };
+            legs: {
+                type: string;
+                items: {
+                    type: string;
+                    required: string[];
+                    properties: {
+                        quote_id: {
+                            type: string;
+                            pattern: string;
+                        };
+                        service_id: {
+                            type: string;
+                            pattern: string;
+                        };
+                        capability: {
+                            type: string;
+                        };
+                        price: {
+                            type: string;
+                            required: string[];
+                            properties: {
+                                asset: {
+                                    $ref: string;
+                                };
+                                amount: {
+                                    type: string;
+                                    pattern: string;
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+            intent_id: {
+                type: string[];
+            };
+            settlement_id: {
+                type: string[];
+            };
+            receipt_id: {
+                type: string[];
+            };
+            created_at: {
+                type: string;
+                format: string;
+            };
+            expires_at: {
+                type: string;
+                format: string;
+            };
+        };
+    };
+    readonly paymentIntent: {
+        $schema: string;
+        $id: string;
+        title: string;
+        type: string;
+        required: string[];
+        properties: {
+            rpp402_version: {
+                type: string;
+                const: string;
+            };
+            id: {
+                type: string;
+                pattern: string;
+            };
+            session_id: {
+                type: string;
+                pattern: string;
+            };
+            payer_wallet: {
+                type: string;
+                pattern: string;
+            };
+            asset: {
+                $ref: string;
+            };
+            amount_mode: {
+                type: string[];
+                enum: (string | null)[];
+            };
+            amount: {
+                type: string;
+                pattern: string;
+            };
+            status: {
+                type: string;
+                enum: string[];
+            };
+            authorization: {
+                oneOf: ({
+                    type: string;
+                    required: string[];
+                    properties: {
+                        type: {
+                            const: string;
+                        };
+                        signer: {
+                            type: string;
+                            pattern: string;
+                        };
+                        signature: {
+                            type: string;
+                            pattern: string;
+                        };
+                        nonce: {
+                            type: string;
+                        };
+                        account_id?: never;
+                        delegation_ref?: never;
+                        risk_check?: never;
+                    };
+                } | {
+                    type: string;
+                    required: string[];
+                    properties: {
+                        type: {
+                            const: string;
+                        };
+                        account_id: {
+                            type: string;
+                            pattern: string;
+                        };
+                        delegation_ref: {
+                            type: string;
+                            pattern: string;
+                        };
+                        risk_check: {
+                            type: string;
+                        };
+                        signer?: never;
+                        signature?: never;
+                        nonce?: never;
+                    };
+                })[];
+            };
+            created_at: {
+                type: string;
+                format: string;
+            };
+            expires_at: {
+                type: string;
+                format: string;
+            };
+        };
+        if: {
+            properties: {
+                asset: {
+                    properties: {
+                        type: {
+                            const: string;
+                        };
+                    };
+                };
+            };
+        };
+        then: {
+            required: string[];
+        };
+    };
+    readonly settlement: {
+        $schema: string;
+        $id: string;
+        title: string;
+        type: string;
+        required: string[];
+        properties: {
+            rpp402_version: {
+                type: string;
+                const: string;
+            };
+            id: {
+                type: string;
+                pattern: string;
+            };
+            intent_id: {
+                type: string;
+                pattern: string;
+            };
+            session_id: {
+                type: string;
+                pattern: string;
+            };
+            chain_id: {
+                type: string;
+            };
+            tx_hash: {
+                type: string[];
+                pattern: string;
+            };
+            block_number: {
+                type: string[];
+            };
+            status: {
+                type: string;
+                enum: string[];
+            };
+            transfers: {
+                type: string;
+                minItems: number;
+                items: {
+                    type: string;
+                    required: string[];
+                    properties: {
+                        from: {
+                            type: string;
+                            pattern: string;
+                        };
+                        to: {
+                            type: string;
+                            pattern: string;
+                        };
+                        asset: {
+                            $ref: string;
+                        };
+                        amount: {
+                            type: string;
+                            pattern: string;
+                        };
+                    };
+                };
+            };
+            reference_price: {
+                type: string[];
+                properties: {
+                    oracle: {
+                        type: string;
+                    };
+                    symbol: {
+                        type: string;
+                    };
+                    price_usd: {
+                        type: string;
+                    };
+                    sourced_at: {
+                        type: string;
+                        format: string;
+                    };
+                };
+            };
+            created_at: {
+                type: string;
+                format: string;
+            };
+            confirmed_at: {
+                type: string[];
+                format: string;
+            };
+        };
+    };
+    readonly receipt: {
+        $schema: string;
+        $id: string;
+        title: string;
+        type: string;
+        required: string[];
+        properties: {
+            rpp402_version: {
+                type: string;
+                const: string;
+            };
+            id: {
+                type: string;
+                pattern: string;
+            };
+            session_id: {
+                type: string;
+                pattern: string;
+            };
+            settlement_id: {
+                type: string;
+                pattern: string;
+            };
+            payer_wallet: {
+                type: string;
+                pattern: string;
+            };
+            line_items: {
+                type: string;
+                minItems: number;
+                items: {
+                    type: string;
+                    required: string[];
+                    properties: {
+                        service_id: {
+                            type: string;
+                        };
+                        capability: {
+                            type: string;
+                        };
+                        quote_id: {
+                            type: string;
+                        };
+                        amount: {
+                            type: string;
+                            required: string[];
+                            properties: {
+                                asset: {
+                                    $ref: string;
+                                };
+                                amount: {
+                                    type: string;
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+            total: {
+                type: string;
+                required: string[];
+                properties: {
+                    asset: {
+                        $ref: string;
+                    };
+                    amount: {
+                        type: string;
+                    };
+                };
+            };
+            settlement_ref: {
+                type: string;
+                required: string[];
+                properties: {
+                    chain_id: {
+                        type: string;
+                    };
+                    tx_hash: {
+                        type: string;
+                        pattern: string;
+                    };
+                    block_number: {
+                        type: string;
+                    };
+                };
+            };
+            signature: {
+                type: string;
+                required: string[];
+                properties: {
+                    algorithm: {
+                        const: string;
+                    };
+                    signer: {
+                        type: string;
+                        pattern: string;
+                    };
+                    signature: {
+                        type: string;
+                        pattern: string;
+                    };
+                };
+            };
+            issued_at: {
+                type: string;
+                format: string;
+            };
+        };
+    };
+};
+declare const RPP_VERSION: "1.0";
+
+export { type AmountMode, type AssetRef, type Capability, type ChainId, type CommerceSession, type DecimalString, type DiscoveryDocument, type IntentAuthorization, type IntentStatus, type LineItem, type Money, type PaymentIntent, type Quote, type QuoteRequest, RPP_VERSION, type Receipt, type ReceiptSignature, type ReferencePrice, type SessionLeg, type SessionStatus, type Settlement, type SettlementRef, type SettlementStatus, type Timestamp, type Transfer, type WalletAddress, schemas };