Retire
What “Retire” does
Retire removes a PoV-backed token from circulation permanently and issues a receipt you can file. It’s how buyers make ESG claims (e.g., retire 1 tCO₂e or 1 MWh), and how programs enforce end-of-life on units. Retirement does not exist for Trade milestones—only for Tokens (Energy/Carbon/Attributes).
Always true: Retirement is irreversible, fee-bearing (Tokens 4%), and burns 50% of that fee in EDM at the moment of retirement. Proof is published; the unit cannot be transferred again.
Preconditions
The token carries a PoV badge: Evidence bound to a dossier.
One-Claim for that unit is free or already bound: The claim must not be double-used.
If the token is a wrapper/mirror: The required registry attestation is present.
If the listing is frozen: Retirement is refused until corrected.
What the chain checks
Admissibility: PoV checklist satisfied; token not frozen.
Uniqueness: One-Claim finalizes for this unit (serial/key).
Accounting: Charge 4% protocol fee (default split 2% buyer + 2% seller, configurable per program).
Burn: 50% of the fee burns in EDM now (burn tx hash is recorded).
Finality: Token status flips to RETIRED; a retirement receipt is written.
No business logic can bypass these steps; a retirement either completes atomically or reverts.
What you record at retirement
Who: Who retires and (optionally) the beneficiary name/entity.
What: What unit (method/region/vintage for Carbon; device/time window for Energy; or hourly attribute).
How much: Quantity; for ERC-1155 it can be partial.
Why: Purpose/tag, e.g., “shipping lane Brazil→DE Q1”.
Proof: PoV hash, attestor roles, One-Claim ref.
Economics: Fee line, treasury half, EDM burn hash.
If mirrored: The external registry serial and confirmation link.
The token’s Explorer page flips to Retired with the same details.
Business flow
You select the token(s), add beneficiary and purpose, and press Retire. The platform checks PoV and One-Claim, posts the 4% fee, burns 50% of it in EDM, and issues the receipt and proof page. There is nothing else to reconcile—finance sees the fee/burn line, ESG gets a one-click packet, and the unit disappears from inventory.
API / Webhooks
POST /v1/tokens/retire: Body: { token_id|batch[], quantity?, beneficiary?, purpose? } Returns: { retirement_id, receipt_uri, burn_hash }
Webhooks: tokens.retirement.proofpack.ready (receipt & proof) · tokens.settlement.posted (fee line) · fee.burn.posted (amount, burn hash)
Idempotency: Repeat calls with the same retirement_id are no-ops.
Edge cases (handled without surprises)
Batch/partial retire: ERC-1155 supports quantities; conservation is enforced; receipts list per-id totals.
Wrapper/mirror revoked: The listing freezes; you cannot retire until the mirror is corrected or replaced; the proof page records the corrective action.
Revocation after retirement (rare): We don’t “unretire.” Program rules apply: issue a compensating retirement or replacement unit and link it on the proof page; your original receipt stays, with an addendum.
Double-count protection: One-Claim blocks resale or second retirement anywhere on EDMA; post-retire transfers are impossible.
What retire does not do
No Trade cash movement: It does not move Trade cash (no EDSD flips).
No delay or discount to burn: It does not discount or delay the 50% burn—the burn happens at retirement.
No raw file exposure: It does not expose raw files; the receipt points to the PoV hash and expiring evidence links for authorized roles.
Operator checklist
Confirm token isn’t frozen: If it is, fix the dossier first.
Add beneficiary and purpose: So ESG reporting doesn’t chase context later.
For wrappers: Ensure the mirror serial is present (the API will refuse without it).
File the receipt: File the receipt with finance; auditors can replay the chain from the burn hash and proof page.
One-glance matrix
Tx type
Moves cash?
Protocol fee
EDM burn
Reversible?
Mint (Token)
No
No
No
N/A
Settle (Buy)
No (ownership change)
4%
50% at settlement
No
Retire
No (unit removed)
4%
50% at retirement
Irreversible
Revoke
N/A (gatekeeping)
No
No
Append-only correction
Plain recap
Last updated