Skip to content

feat(tempo): add ReceivePolicyReceipt module for TIP-1028 claim receipts#263

Merged
jxom merged 4 commits into
mainfrom
jxom/tempo-receive-policy-receipt
May 30, 2026
Merged

feat(tempo): add ReceivePolicyReceipt module for TIP-1028 claim receipts#263
jxom merged 4 commits into
mainfrom
jxom/tempo-receive-policy-receipt

Conversation

@jxom
Copy link
Copy Markdown
Member

@jxom jxom commented May 30, 2026

Adds an ox/tempo ReceivePolicyReceipt module for decoding TIP-1028 receive-policy claim receipts (ClaimReceiptV1 witnesses).

When an inbound transfer or mint violates the recipient's receive policy, the funds are redirected to the ReceivePolicyGuard and a ClaimReceiptV1 witness is emitted. That witness is required to later claim or burn the blocked funds.

API

  • ReceivePolicyReceipt.decode(receipt) — decode a raw ABI-encoded witness.
  • ReceivePolicyReceipt.from(value) — normalize from an encoded witness or an already-decoded receipt.
  • ReceivePolicyReceipt.fromTransactionReceipt(receipt) — extract every receipt from a transaction receipt's logs. Returns an array (one entry per TransferBlocked log, in log order) since a single transaction can block multiple inbound transfers; unrelated logs are skipped by topic filtering.

Enums are mapped to string literals for ergonomics (blockedReason: 'none' | 'tokenFilter' | 'receivePolicy', kind: 'transfer' | 'mint'); recoveryAuthority is exposed as a raw Address.

@vercel
Copy link
Copy Markdown

vercel Bot commented May 30, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
ox Ready Ready Preview, Comment May 30, 2026 12:53pm

Request Review

@pkg-pr-new
Copy link
Copy Markdown

pkg-pr-new Bot commented May 30, 2026

Open in StackBlitz

npm i https://pkg.pr.new/ox@263

commit: 3135f0f

@jxom jxom merged commit 451a442 into main May 30, 2026
11 of 12 checks passed
@jxom jxom deleted the jxom/tempo-receive-policy-receipt branch May 30, 2026 12:49
@github-actions github-actions Bot mentioned this pull request May 30, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant