// Getters
getNetwork(): SupportedNetwork;
getChainId(): number;
getEscrowAddress(): Address;
getEIP712Domain(): EIP712Domain;
}
`

$3

`typescript
interface DeferredSchemeConfig {
network: SupportedNetwork;
escrowAddress: Address;
rpcUrl?: string;
domainName?: string; // default: "X402DeferredEscrow"
domainVersion?: string; // default: "1"
}
`

$3

`typescript
interface EIP712Domain {
name: string;
version: string;
chainId: number;
verifyingContract: Address;
}
`

$3

`typescript
interface SignatureParts {
v: number;
r: Hex;
s: Hex;
}
`

Utility Functions

$3

Generate a random bytes32 voucher ID.

`typescript
import { generateVoucherId } from '@perkos/scheme-deferred';

const voucherId = generateVoucherId();
// => '0x1234...abcd' (32 bytes hex)
`

$3

Create a voucher message object for EIP-712 signing.

`typescript
import { createVoucherMessage } from '@perkos/scheme-deferred';

const message = createVoucherMessage(
'0x...', // id
'0x...', // buyer
'0x...', // seller
'5000000', // valueAggregate
'0x...', // asset
1735689600, // timestamp
'1', // nonce
'0x...', // escrow
8453 // chainId
);
`

$3

Convert a Voucher object to a tuple format for contract calls.

`typescript
import { createVoucherTuple } from '@perkos/scheme-deferred';

const tuple = createVoucherTuple(voucher);
// Use with escrow contract claimVoucher function
`

$3

Create an EIP-712 domain for voucher signing.

`typescript
import { createEIP712Domain } from '@perkos/scheme-deferred';

const domain = createEIP712Domain(
8453, // chainId
'0x...', // escrowAddress
'CustomName', // optional domain name
'2' // optional version
);
`

$3

Parse a signature into v, r, s components.

`typescript
import { parseSignature } from '@perkos/scheme-deferred';

const { v, r, s } = parseSignature('0x...');
`

EIP-712 Type Definition

The voucher type definition used for EIP-712 signing:

`typescript
import { VOUCHER_TYPES, VOUCHER_TYPE_DEF } from '@perkos/scheme-deferred';

// VOUCHER_TYPE_DEF structure:
[
{ name: "id", type: "bytes32" },
{ name: "buyer", type: "address" },
{ name: "seller", type: "address" },
{ name: "valueAggregate", type: "uint256" },
{ name: "asset", type: "address" },
{ name: "timestamp", type: "uint64" },
{ name: "nonce", type: "uint256" },
{ name: "escrow", type: "address" },
{ name: "chainId", type: "uint256" }
]
`

Escrow Contract ABIs

The package exports ABIs for interacting with the deferred escrow contract:

`typescript
import {
DEFERRED_ESCROW_ABI,
DEFERRED_ESCROW_GET_BALANCE_ABI,
DEFERRED_ESCROW_VOUCHER_CLAIMED_ABI,
DEFERRED_ESCROW_CLAIM_VOUCHER_ABI,
ERC20_BALANCE_ABI
} from '@perkos/scheme-deferred';
`

$3

| ABI | Function | Description |
|-----|----------|-------------|
| DEFERRED_ESCROW_GET_BALANCE_ABI | getAvailableBalance(buyer, seller, asset) | Get escrow balance |
| DEFERRED_ESCROW_VOUCHER_CLAIMED_ABI | voucherClaimed(voucherId, nonce) | Check if claimed |
| DEFERRED_ESCROW_CLAIM_VOUCHER_ABI | claimVoucher(voucher, signature) | Claim voucher |

Verification Flow

The verify() method performs these checks in order:

1. Voucher Validation: Checks escrow address, chainId, seller, amount, and asset
2. Signature Recovery: Recovers signer using EIP-712 typed data
3. Signer Verification: Ensures signer matches voucher buyer
4. Claim Status: Checks if voucher already claimed on-chain
5. Balance Check: Verifies sufficient escrow balance

Re-exported Types

`typescript
import type {
DeferredPayload,
Voucher,
VerifyResponse,
PaymentRequirements,
Address,
Hex
} from '@perkos/scheme-deferred';

// V2 helper
import { getPaymentAmount } from '@perkos/scheme-deferred';
``

Related Packages

- @perkos/types-x402 - Core x402 types
- @perkos/util-chains - Chain utilities
- @perkos/scheme-exact - Exact payment scheme
- @perkos/contracts-escrow - Escrow contract ABI
- @perkos/service-x402 - x402 service orchestrator

License

MIT