TypeScript SDK: Standard + Advanced
Package: @agirails/sdk@4.0.0 · Symbols in this view: 255 · Total TS surface: 283 · Manifest generated: 2026-05-29 17:33:29 UTC
Every entry below is auto-extracted from the SDK source itself via the truth-ledger pipeline. The cross-SDK status column tells you whether the symbol has a Python counterpart, is TS-only, or has signature drift the parity sprint is tracking.
For detailed per-symbol docs (parameters, return types, examples) consult the source JSDoc in agirails/sdk-js. Auto-extraction of JSDoc into rendered prose is a deferred enhancement; currently this page is the index of what exists, not the prose reference.
Standard tier (242 symbols)
Production-stable surface for non-trivial integrations: adapters, builders, message-signing utilities, escrow + state-machine helpers, error classes, type definitions. If your code touches the kernel directly (rather than going through Agent), it lives here.
| Symbol | Kind | Summary | Cross-SDK status |
|---|---|---|---|
ACTP_FEEDBACK_TAGS | re-export | ACTP feedback tags for ERC-8004 Reputation. | 🟢 TS-only (Python parity pending) |
ACTPClientInfo | re-export | Result of creating an ACTPClient. | ✅ in-sync |
ACTPClientMode | re-export | Supported modes for ACTPClient. | ✅ in-sync |
ACTPError | re-export | Base ACTP Error. | ✅ in-sync |
ACTPFeedbackTag | re-export | Type for ACTP feedback tags. | 🟢 TS-only (Python parity pending) |
ACTPKernel | re-export | ACTPKernel - Smart contract wrapper Reference: Yellow Paper §3 (ACTP Kernel Specification) | ✅ in-sync |
AdapterSelectionResult | re-export | Result of adapter selection with potential ERC-8004 resolution. | 🟢 TS-only (Python parity pending) |
AdapterTransactionState | re-export | Valid transaction states across all adapters. | 🟢 TS-only (Python parity pending) |
Address | re-export | Address utilities | ✅ in-sync |
AgentBalance | re-export | Agent balance information | ✅ in-sync |
AgentLifecycleError | re-export | Agent lifecycle error. | ✅ in-sync |
AgentRegistry | re-export | AgentRegistry - Agent Identity & Reputation SDK Module (AIP-7) | ✅ in-sync |
AgentStats | re-export | Agent statistics | ✅ in-sync |
AgentStatus | re-export | Agent lifecycle states | ✅ in-sync |
ARCHIVE_BUNDLE_TYPE | re-export | Archive bundle type identifier | ✅ in-sync |
ArchiveAttestation | re-export | EAS attestation reference | ✅ in-sync |
ArchiveBundle | re-export | Archive Bundle (AIP-7 §4.4 - Minimal Hash-First) | ✅ in-sync |
ArchiveBundleBuilder | re-export | ArchiveBundleBuilder - Fluent builder for archive bundles | ✅ in-sync |
ArchiveChainId | re-export | Supported chain IDs for archive bundles | ✅ in-sync |
ArchiveFinalState | re-export | Final transaction states that can be archived | ✅ in-sync |
ArchiveHashes | re-export | Cryptographic hashes for verification | ✅ in-sync |
ArchiveParticipants | re-export | Transaction participants (addresses only, not full profiles) | ✅ in-sync |
ArchiveReferences | re-export | IPFS CID references to full content | ✅ in-sync |
ArchiveSettlement | re-export | Settlement information | ✅ in-sync |
ArchiveSignatures | re-export | Cryptographic signatures for self-verification | ✅ in-sync |
ArchiveTags | re-export | Arweave/Irys tags for archive bundles | ✅ in-sync |
ArweaveConfig | re-export | Configuration for Arweave client via Irys | ✅ in-sync |
ArweaveDownloadError | re-export | (no summary) | 🟢 TS-only (Python parity pending) |
ArweaveTimeoutError | re-export | (no summary) | 🟢 TS-only (Python parity pending) |
ArweaveUploadError | re-export | (no summary) | 🟢 TS-only (Python parity pending) |
ArweaveUploadResult | re-export | Result of uploading to Arweave | ✅ in-sync |
AutoWalletConfig | re-export | (no summary) | 🟢 TS-only (Python parity pending) |
AutoWalletProvider | re-export | (no summary) | ✅ in-sync |
BaseAdapter | re-export | Abstract base adapter with shared parsing utilities. | ✅ in-sync |
BatchedPayParams | re-export | Parameters for batched ACTP payment. | 🟢 TS-only (Python parity pending) |
BatchedPayResult | re-export | Result of a batched ACTP payment via AA wallet. | 🟢 TS-only (Python parity pending) |
BelowCostBehavior | re-export | Pricing behavior when job budget is below cost (would lose money) | 🟢 TS-only (Python parity pending) |
BelowPriceBehavior | re-export | Pricing behavior when job budget is below calculated price | 🟢 TS-only (Python parity pending) |
BlockchainRuntimeConfig | re-export | Configuration for BlockchainRuntime | 🟢 TS-only (Python parity pending) |
buildChannelPath | re-export | Path pattern builders use / handlers expect. | 🟢 TS-only (Python parity pending) |
BuyerNegotiationContext | re-export | AIP-2.1 negotiation context: wires the orchestrator into the NegotiationChannel transport. All fields optional: without them the orchestrator runs the legacy fixed-price flow only (no counters). | 🟢 TS-only (Python parity pending) |
BuyerPolicy | re-export | (no summary) | ✅ in-sync |
Bytes32 | re-export | Bytes32 utilities | ✅ in-sync |
calculatePrice | re-export | Calculate price for a job based on pricing strategy | ✅ in-sync |
CandidateStats | re-export | (no summary) | ✅ in-sync |
ChannelPayload | re-export | Wire payload posted by the client and parsed by the handler. Discriminated by type so the same endpoint serves both directions. | 🟢 TS-only (Python parity pending) |
computeContentHash | re-export | Compute keccak256 hash of canonical JSON | ✅ in-sync |
ContentNotFoundError | re-export | (no summary) | ✅ in-sync |
ContractPausedError | re-export | Error thrown when the contract is paused. | ✅ in-sync |
CounterAcceptBuilder | re-export | (no summary) | ✅ in-sync |
CounterAcceptMessage | re-export | Provider-signed acceptance of a buyer's counter-offer. | ✅ in-sync |
CounterAcceptParams | re-export | (no summary) | ✅ in-sync |
CounterDecision | re-export | (no summary) | 🟢 TS-only (Python parity pending) |
CounterOfferBuilder | re-export | (no summary) | ✅ in-sync |
CounterOfferMessage | re-export | Counter-offer message: the buyer's reply to a provider quote. | ✅ in-sync |
CounterOfferParams | re-export | Parameters to build a counter-offer. counteredAt, nonce, and signature are filled by the builder. | ✅ in-sync |
CreateTransactionParams | re-export | Parameters for creating a new transaction. | ✅ in-sync |
createUsedAttestationTracker | re-export | Factory to create attestation tracker | ✅ in-sync |
Deadline | re-export | Deadline utilities | ✅ in-sync |
DeadlineExpiredError | re-export | (no summary) | ⚠️ diverged (cross-SDK signature mismatch) |
DeadlinePassedError | re-export | Error thrown when the deadline has passed. | ⚠️ diverged (cross-SDK signature mismatch) |
DedupStore | re-export | (no summary) | 🟢 TS-only (Python parity pending) |
DEFAULT_DEADLINE_SECONDS | re-export | Default deadline offset in seconds (24 hours). Used when no deadline is specified in transaction parameters. | ✅ in-sync |
DEFAULT_DISPUTE_WINDOW_SECONDS | re-export | Default dispute window in seconds (2 days). Used when no dispute window is specified in transaction parameters. | ✅ in-sync |
DEFAULT_PRICING_STRATEGY | re-export | Default pricing strategy | 🟢 TS-only (Python parity pending) |
DeliveredMessage | re-export | Per-message metadata the channel attaches when delivering. | 🟢 TS-only (Python parity pending) |
DeliveryFailedError | re-export | Provider failed to deliver result. | ✅ in-sync |
DeliveryProofBuilder | re-export | DeliveryProofBuilder - Main Builder Class | ✅ in-sync |
DIDManager | re-export | DIDManager - Manage DID attributes and delegates (AIP-7 §2.2) | ✅ in-sync |
DIDResolver | re-export | DIDResolver - Resolve DIDs to DID Documents (AIP-7 §2.2) | ✅ in-sync |
DisputeRaisedError | re-export | Dispute raised on transaction. | ✅ in-sync |
DisputeResolution | re-export | Dispute resolution split | 🟢 TS-only (Python parity pending) |
DisputeWindow | re-export | Dispute window utilities | ✅ in-sync |
DisputeWindowActiveError | re-export | Error thrown when dispute window is still active. | ✅ in-sync |
DownloadResult | re-export | Result of downloading content | ✅ in-sync |
DownloadTimeoutError | re-export | (no summary) | ✅ in-sync |
EASConfig | re-export | (no summary) | 🟢 TS-only (Python parity pending) |
EconomicParams | re-export | Economic parameters (fee structure) | 🟢 TS-only (Python parity pending) |
envelopeChainId | re-export | Extract the chainId carried inside the envelope's signed message. | 🟢 TS-only (Python parity pending) |
envelopeTxId | re-export | Extract the txId carried inside the envelope's signed message. Useful for impls that need to dispatch by txId without parsing. | 🟢 TS-only (Python parity pending) |
EOAWalletProvider | re-export | (no summary) | ✅ in-sync |
ERC8004_DEFAULT_RPC | re-export | Default RPC URLs for each network. Used when no custom RPC is provided. | 🟢 TS-only (Python parity pending) |
ERC8004_IDENTITY_REGISTRY | re-export | ERC-8004 Identity Registry addresses per network. | 🟢 TS-only (Python parity pending) |
ERC8004_REPUTATION_REGISTRY | re-export | ERC-8004 Reputation Registry addresses per network. | 🟢 TS-only (Python parity pending) |
ERC8004Agent | re-export | Agent identity resolved from ERC-8004 Identity Registry. | 🟢 TS-only (Python parity pending) |
ERC8004AgentMetadata | re-export | Agent metadata schema from ERC-8004 agentURI. | 🟢 TS-only (Python parity pending) |
ERC8004Bridge | re-export | Bridge for reading from ERC-8004 Identity Registry. | ✅ in-sync |
ERC8004BridgeConfig | re-export | Configuration for ERC8004Bridge. | 🟢 TS-only (Python parity pending) |
ERC8004Error | re-export | Custom error for ERC-8004 operations. | 🟢 TS-only (Python parity pending) |
ERC8004ErrorCode | re-export | ERC-8004 error codes. | 🟢 TS-only (Python parity pending) |
ERC8004Network | re-export | Networks with ERC-8004 registry deployments. | 🟢 TS-only (Python parity pending) |
EscrowNotFoundError | re-export | Error thrown when an escrow is not found. | ✅ in-sync |
EscrowRelease | re-export | Escrow release details | ✅ in-sync |
EscrowVault | re-export | EscrowVault - Escrow contract wrapper | ✅ in-sync |
EventMonitor | re-export | EventMonitor - Listen to blockchain events | ✅ in-sync |
FilebaseConfig | re-export | Configuration for Filebase S3-compatible IPFS client | ✅ in-sync |
FileBasedUsedAttestationTracker | re-export | File-based Used Attestation Tracker for persistence | ✅ in-sync |
FileSizeLimitExceededError | re-export | (no summary) | ✅ in-sync |
formatUSDC | re-export | Format USDC wei to human-readable string | ✅ in-sync |
generateSecureNonce | re-export | Generate a cryptographically secure random nonce (bytes32) | ✅ in-sync |
generateSecureNonces | re-export | Generate an array of secure nonces | ✅ in-sync |
getCachedAddress | re-export | Get cached address from last resolvePrivateKey() call. Works for env-var, base64, and keystore resolution paths. | 🟢 TS-only (Python parity pending) |
getNetwork | re-export | Get network configuration by name (returns deep clone to prevent mutation) | 🟢 TS-only (Python parity pending) |
HandlerContext | re-export | (no summary) | 🟢 TS-only (Python parity pending) |
HandlerResult | re-export | (no summary) | 🟢 TS-only (Python parity pending) |
hashServiceMetadata | re-export | Hash service description for on-chain storage | ✅ in-sync |
IACTPRuntime | re-export | Runtime interface for ACTP protocol operations. | ✅ in-sync |
IAdapter | re-export | Common interface for all payment adapters. | 🟢 TS-only (Python parity pending) |
IMockRuntime | re-export | Extended runtime interface for mock mode. | ✅ in-sync |
IncomingRequest | re-export | Incoming request surface: the minimum the orchestrator needs to decide whether + at what price to quote. Extracted from the on-chain transaction plus any off-chain context the caller has (service type, consumer DID). | 🟢 TS-only (Python parity pending) |
InMemoryNonceManager | re-export | In-Memory Nonce Manager Simple implementation using Map for per-message-type nonce tracking | 🟢 TS-only (Python parity pending) |
InMemoryReceivedNonceTracker | re-export | In-Memory Received Nonce Tracker | ✅ in-sync |
InMemoryUsedAttestationTracker | re-export | In-Memory Used Attestation Tracker | ✅ in-sync |
InsufficientBalanceError | re-export | Error thrown when there are insufficient funds for an operation. | ✅ in-sync |
InsufficientFundsError | re-export | (no summary) | 🟢 TS-only (Python parity pending) |
InvalidAddressError | re-export | (no summary) | ✅ in-sync |
InvalidAmountError | re-export | Error thrown when an invalid amount is provided. | ✅ in-sync |
InvalidArweaveTxIdError | re-export | (no summary) | 🟢 TS-only (Python parity pending) |
InvalidCIDError | re-export | (no summary) | ✅ in-sync |
InvalidStateTransitionError | re-export | Error thrown when an invalid state transition is attempted. | ✅ in-sync |
IPFSClient | re-export | IPFS Client Interface (from DeliveryProofBuilder) | 🟢 TS-only (Python parity pending) |
IPFSClientConfig | re-export | IPFS Client Configuration | 🟢 TS-only (Python parity pending) |
IPFSUploadResult | re-export | Result of uploading to IPFS | ✅ in-sync |
IReceivedNonceTracker | re-export | Interface for tracking received nonces | ✅ in-sync |
IrysCurrency | re-export | Supported Irys payment tokens | ✅ in-sync |
IrysNetwork | re-export | Irys network | ✅ in-sync |
isAdapter | re-export | Type guard to check if an object implements IAdapter. | 🟢 TS-only (Python parity pending) |
isCounterAcceptEnvelope | re-export | (no summary) | 🟢 TS-only (Python parity pending) |
isCounterOfferEnvelope | re-export | (no summary) | 🟢 TS-only (Python parity pending) |
isQuoteEnvelope | re-export | (no summary) | 🟢 TS-only (Python parity pending) |
isValidNonce | re-export | Validate nonce format (must be bytes32) | ✅ in-sync |
IUsedAttestationTracker | re-export | Interface for tracking used attestations | ✅ in-sync |
IWalletProvider | re-export | Wallet provider interface. | ✅ in-sync |
MAX_DEADLINE_DAYS | re-export | Maximum deadline in days (10 years). Prevents integer overflow in deadline calculations. | ✅ in-sync |
MAX_DEADLINE_HOURS | re-export | Maximum deadline in hours (10 years). Prevents integer overflow in deadline calculations. | ✅ in-sync |
MIN_AMOUNT_WEI | re-export | Minimum transaction amount in USDC wei (6 decimals). $0.05 minimum per AGIRAILS protocol specification. | ✅ in-sync |
MockAccount | re-export | Mock account representing a user's wallet state. | ✅ in-sync |
MockBlockchain | re-export | Mock blockchain state simulating chain parameters. | ✅ in-sync |
MockChannelConfig | re-export | (no summary) | 🟢 TS-only (Python parity pending) |
MockEscrow | re-export | Mock escrow representing funds locked for a transaction. | ✅ in-sync |
MockEvent | re-export | Mock blockchain event recorded during transaction lifecycle. | ✅ in-sync |
MockState | re-export | Complete mock state persisted to .actp/mock-state.json. | ✅ in-sync |
MockTransaction | re-export | Mock transaction representing an ACTP transaction in the mock blockchain. | ✅ in-sync |
NegotiationChannel | re-export | Transport-agnostic AIP-2.1 message bus. | 🟢 TS-only (Python parity pending) |
NegotiationMessage | re-export | Discriminated union of every signed message type that can flow over a NegotiationChannel. The channel's post accepts any of these; the channel's verify-on-receive ensures only well-formed signed messages reach the sub… | 🟢 TS-only (Python parity pending) |
NegotiationResult | re-export | (no summary) | ✅ in-sync |
NetworkConfig | re-export | Network configuration | 🟢 TS-only (Python parity pending) |
NetworkError | re-export | (no summary) | ✅ in-sync |
NetworkOption | re-export | Network options | 🟢 TS-only (Python parity pending) |
NonceManager | re-export | Nonce Manager Interface (from DeliveryProofBuilder) | ✅ in-sync |
NoProviderFoundError | re-export | No provider found for the requested service. | ✅ in-sync |
OrchestratorConfig | re-export | (no summary) | ✅ in-sync |
parseUSDC | re-export | Parse USDC amount string to wei (6 decimals) | ✅ in-sync |
PolicyResult | re-export | (no summary) | ✅ in-sync |
PolicyViolation | re-export | (no summary) | ✅ in-sync |
PriceCalculation | re-export | Price calculation result | ✅ in-sync |
PricingStrategy | re-export | Pricing strategy configuration | ✅ in-sync |
ProgressEvent | re-export | (no summary) | 🟢 TS-only (Python parity pending) |
ProtocolCreateParams | re-export | (no summary) | 🟢 TS-only (Python parity pending) |
Provider | re-export | Provider interface | ✅ in-sync |
ProviderBalance | re-export | Provider balance | 🟢 TS-only (Python parity pending) |
ProviderOrchestratorConfig | re-export | (no summary) | 🟢 TS-only (Python parity pending) |
ProviderPolicy | re-export | What this agent provides + at what terms. | 🟢 TS-only (Python parity pending) |
ProviderPolicyEngine | re-export | (no summary) | 🟢 TS-only (Python parity pending) |
ProviderPolicyResult | re-export | (no summary) | 🟢 TS-only (Python parity pending) |
ProviderPolicyViolation | re-export | (no summary) | 🟢 TS-only (Python parity pending) |
ProviderRejectedError | re-export | Provider rejected the job. | ✅ in-sync |
ProviderStats | re-export | Provider statistics | 🟢 TS-only (Python parity pending) |
ProviderStatus | re-export | Provider status | ✅ in-sync |
QueryCapExceededError | re-export | Registry Query Cap Exceeded Error (L-4) | ✅ in-sync |
QuoteBuilder | re-export | QuoteBuilder - Main Builder Class Reference: AIP-2 §6.1 | ✅ in-sync |
QuoteChannelClientConfig | re-export | (no summary) | 🟢 TS-only (Python parity pending) |
QuoteChannelHandlerConfig | re-export | (no summary) | 🟢 TS-only (Python parity pending) |
QuoteDecision | re-export | (no summary) | 🟢 TS-only (Python parity pending) |
QuoteEvaluation | re-export | Decision for a single incoming provider quote. | 🟢 TS-only (Python parity pending) |
QuoteForEvaluation | re-export | Minimal quote shape evaluateQuote operates on. Keeps DecisionEngine decoupled from the full QuoteMessage type + signature verification (that's BuyerOrchestrator's job). | 🟢 TS-only (Python parity pending) |
QuoteOffer | re-export | (no summary) | ✅ in-sync |
QuoteResult | re-export | (no summary) | 🟢 TS-only (Python parity pending) |
RateLimiter | re-export | Simple sliding window rate limiter | ✅ in-sync |
RelayChannel | re-export | (no summary) | 🟢 TS-only (Python parity pending) |
RelayChannelConfig | re-export | (no summary) | 🟢 TS-only (Python parity pending) |
ReportDisputeParams | re-export | Parameters for reporting a dispute resolution. | 🟢 TS-only (Python parity pending) |
ReportResult | re-export | Result of a reputation report. | 🟢 TS-only (Python parity pending) |
ReportSettlementParams | re-export | Parameters for reporting a successful settlement. | 🟢 TS-only (Python parity pending) |
ReputationFeedback | re-export | Feedback entry for ERC-8004 Reputation Registry. | 🟢 TS-only (Python parity pending) |
ReputationReporter | re-export | Reporter for submitting ACTP settlement outcomes to ERC-8004 Reputation. | ✅ in-sync |
ReputationReporterConfig | re-export | Configuration for ReputationReporter. | 🟢 TS-only (Python parity pending) |
ReputationSummary | re-export | Aggregated reputation summary for an agent. | 🟢 TS-only (Python parity pending) |
RequestResult | re-export | Result of request() function | ✅ in-sync |
RequestStatus | re-export | Request status updates | 🟢 TS-only (Python parity pending) |
resolvePrivateKey | re-export | Auto-resolve private key: env var → base64 keystore → file keystore → undefined. Never logs or prints the key itself. | 🟢 TS-only (Python parity pending) |
RoundResult | re-export | (no summary) | ✅ in-sync |
ScoredCandidate | re-export | (no summary) | ✅ in-sync |
ScoringWeights | re-export | (no summary) | ✅ in-sync |
Semaphore | re-export | Simple semaphore for limiting concurrent operations | ✅ in-sync |
ServiceConfigError | re-export | Service configuration error. | ✅ in-sync |
ServiceCost | re-export | Cost configuration for a service | 🟢 TS-only (Python parity pending) |
ServiceHash | re-export | Service metadata utilities for ACTP transactions | ✅ in-sync |
ServiceMetadata | re-export | Service metadata structure | ✅ in-sync |
SessionMapping | re-export | (no summary) | ✅ in-sync |
shortenAddress | re-export | Shorten Ethereum address for display | ✅ in-sync |
SignatureVerificationError | re-export | (no summary) | ✅ in-sync |
StandardTransactionParams | re-export | Parameters for creating a transaction (standard level). | ✅ in-sync |
StateHelpers | re-export | (no summary) | 🟢 TS-only (Python parity pending) |
StorageAuthenticationError | re-export | (no summary) | ✅ in-sync |
StorageError | re-export | (no summary) | ✅ in-sync |
StorageInsufficientBalanceError | re-export | (no summary) | 🟢 TS-only (Python parity pending) |
StorageRateLimitError | re-export | (no summary) | ✅ in-sync |
Subscription | re-export | Unsubscribe handle. unsubscribe() MUST be idempotent; callers should call it exactly once but the impl tolerates double-unsubscribe to keep cleanup paths simple. | 🟢 TS-only (Python parity pending) |
SwapExecutionError | re-export | (no summary) | 🟢 TS-only (Python parity pending) |
TimeoutError | re-export | Request timeout error. | 🟢 TS-only (Python parity pending) |
Transaction | re-export | ACTP Transaction Reference: Yellow Paper §3.1 | ✅ in-sync |
TransactionNotFoundError | re-export | Error thrown when a transaction is not found. | ✅ in-sync |
TransactionRevertedError | re-export | (no summary) | ✅ in-sync |
TransactionState | re-export | ACTP Transaction State enum matching the smart contract states. | ✅ in-sync |
TransactionStateValue | re-export | Numeric state values matching the smart contract enum. | ✅ in-sync |
TransactionStatus | re-export | Transaction status returned by getStatus(). | 🟢 TS-only (Python parity pending) |
UploadTimeoutError | re-export | (no summary) | ✅ in-sync |
URLValidationConfig | re-export | Security: URL validation configuration for SSRF prevention | 🟢 TS-only (Python parity pending) |
USDC | re-export | USDC amount utilities (6 decimal places) | ✅ in-sync |
validateArchiveBundle | re-export | Validate archive bundle structure | ✅ in-sync |
ValidationError | re-export | Adapter-layer ValidationError: extends ACTPError-based ValidationError so that instanceof checks work against the public SDK export. Accepts a single message string for convenience in adapter code. | ✅ in-sync |
VerifyOnChainResult | re-export | (no summary) | 🟢 TS-only (Python parity pending) |
verifyQuoteHashOnChain | re-export | Cross-reference an off-chain QuoteMessage against the hash stored on chain in tx.metadata (or equivalent: MockTransaction.quoteHash). | 🟢 TS-only (Python parity pending) |
VerifySource | re-export | (no summary) | 🟢 TS-only (Python parity pending) |
WalletInfo | re-export | Information about the wallet provider. | ✅ in-sync |
WalletOption | re-export | Wallet configuration options | 🟢 TS-only (Python parity pending) |
WalletTier | re-export | Wallet tier: determines gas behavior. | ✅ in-sync |
WalletTransactionReceipt | re-export | (no summary) | 🟢 TS-only (Python parity pending) |
WalletTransactionRequest | re-export | (no summary) | 🟢 TS-only (Python parity pending) |
X402Adapter | re-export | (no summary) | ✅ in-sync |
X402AdapterConfig | re-export | Configuration for X402Adapter. | 🟢 TS-only (Python parity pending) |
X402AmountExceededError | re-export | Thrown when the server's required payment amount exceeds the client's maxAmountPerTx safety cap. Default cap is $1 USDC. | 🟢 TS-only (Python parity pending) |
X402ApprovalFailedError | re-export | Thrown when the one-time Permit2 approve transaction fails for any reason other than paymaster gate (which throws X402PublishRequiredError instead). | 🟢 TS-only (Python parity pending) |
X402ConfigError | re-export | Thrown when X402Adapter constructor receives invalid config. | 🟢 TS-only (Python parity pending) |
X402Error | re-export | Base class for all x402-related errors. Catch this to handle any x402 failure in one clause. | 🟢 TS-only (Python parity pending) |
X402NetworkNotAllowedError | re-export | Thrown when the server's payment-required response offers no network that the client's allowedNetworks configuration accepts. | 🟢 TS-only (Python parity pending) |
X402PaymentFailedError | re-export | Thrown when the payment attempt returns a non-2xx HTTP status after signing and submitting the payment payload. | 🟢 TS-only (Python parity pending) |
X402PublishRequiredError | re-export | Thrown when paymaster rejects sponsored tx because agent isn't published in AgentRegistry. The one-time Permit2 approve needed to enable Smart Wallet x402 payments requires the agent to pass the paymaster policy gate. | 🟢 TS-only (Python parity pending) |
X402SettlementProofMissingError | re-export | Thrown when HTTP payment completes (200 OK) but the server did not return a payment-response header confirming on-chain settlement. | 🟢 TS-only (Python parity pending) |
X402SignatureFailedError | re-export | Thrown when walletProvider.signTypedData() fails to produce a signature. | 🟢 TS-only (Python parity pending) |
X402UnsupportedWalletError | re-export | Thrown when a Smart Wallet tries to pay a server that only offers the EIP-3009 transferWithAuthorization scheme. | 🟢 TS-only (Python parity pending) |
Advanced tier (13 symbols)
Lower-level building blocks rarely needed in application code: orchestrators, dedup stores, policy engines, raw runtime interfaces. Stable APIs but the contract is "you know what you're doing." Reach here only when the standard tier is genuinely insufficient.
| Symbol | Kind | Summary | Cross-SDK status |
|---|---|---|---|
ArweaveClient | re-export | ArweaveClient - Permanent storage on Arweave via Irys | ✅ in-sync |
BlockchainRuntime | re-export | BlockchainRuntime - Production blockchain implementation | 🟢 TS-only (Python parity pending) |
BuyerOrchestrator | re-export | (no summary) | ✅ in-sync |
DecisionEngine | re-export | (no summary) | ✅ in-sync |
EASHelper | re-export | EASHelper - utility wrapper for Ethereum Attestation Service interactions | ✅ in-sync |
FilebaseClient | re-export | FilebaseClient - IPFS storage via Filebase S3 API | ✅ in-sync |
MessageSigner | re-export | MessageSigner - Cryptographic signing for ACTP messages with EIP-712 Reference: Yellow Paper §11.4.2 | ✅ in-sync |
PolicyEngine | re-export | (no summary) | ✅ in-sync |
ProofGenerator | re-export | ProofGenerator - Content hashing and delivery proofs Reference: Yellow Paper §11.4.1 | ✅ in-sync |
ProviderOrchestrator | re-export | (no summary) | 🟢 TS-only (Python parity pending) |
QuoteChannelClient | re-export | (no summary) | 🟢 TS-only (Python parity pending) |
QuoteChannelHandler | re-export | (no summary) | 🟢 TS-only (Python parity pending) |
SessionStore | re-export | (no summary) | ✅ in-sync |
See also
- Python SDK reference
- TypeScript Simple
- Errors reference: exception class catalog
- Truth-ledger manifest (raw JSON)
- Source:
@agirails/sdk@4.0.0