{"uid":"cap_2nXcO2_49zipokMZ5PQ05","slug":"vealth-carbon-credit-retirement-retire-attach-0d264a1d","name":"Vealth Carbon Credit Retirement (retire-attach)","description":"Find useful work. Build a life from it. Every job shows the place, the task, the proof, and the pay before you begin. Start today and grow toward mastery.","url":"https://vealth.net/.well-known/vealth/retire-attach","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"amount_tonnes":{"type":"number"},"beneficiary_address":{"type":"string"}}},"responseSchema":{"type":"json","example":{"ok":true,"version":"retire-attach-v1","cost_usdc":0.15,"retire_tx":"0x…","basescan_url":"https://basescan.org/tx/0x…","amount_tonnes":0.005,"beneficiary_address":"0xYourAddress","carbonmark_retirements_url":"https://www.carbonmark.com/retirements/…"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.25","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_1EIaO2Aw6SmncY4nMWId5","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retires a specified number of tonnes of carbon credits on-chain via Carbonmark and attaches the retirement proof to a beneficiary wallet address.","exampleAgentPrompt":"Retire 0.005 tonnes of carbon credits on-chain and attach the proof to my wallet address 0xYourAddress — I want a Basescan link and my Carbonmark retirement record.","exampleUseCases":[{"title":"Individual carbon footprint offset","prompt":"I want to offset 0.01 tonnes of CO2 for my wallet 0xABC123 — retire the carbon credits on-chain and give me a verifiable Basescan transaction and Carbonmark retirement link."},{"title":"Automated per-transaction emission offset","prompt":"Every time a transaction completes on our platform, retire 0.002 tonnes of carbon credits on behalf of the user's address — attach the retirement to their wallet and return the proof URL."},{"title":"Corporate sustainability reporting","prompt":"Retire 5 tonnes of carbon credits on-chain and attach the retirement to our company wallet 0xCORP456 so we can include the Carbonmark retirement URL in our annual sustainability report."}],"resultDescription":"Returns a JSON object confirming the retirement with: a boolean ok status, retire-attach version string, cost in USDC, the on-chain retirement transaction hash (retire_tx), a Basescan URL for the Base chain transaction, the amount retired in tonnes, the beneficiary address, and a Carbonmark retirements URL providing a publicly verifiable retirement certificate.","failureModes":["Insufficient USDC balance to cover the $0.25 call fee or carbon credit cost","Invalid or malformed beneficiary_address (non-checksummed or non-EVM address)","amount_tonnes too small or below minimum threshold for retirement","Carbonmark or KlimaDAO liquidity unavailable for the requested amount","Base chain congestion causing transaction timeout","x402 payment protocol failure or incorrect payment header"],"whenToPreferThis":"Choose this endpoint when you need a fully on-chain, verifiable carbon credit retirement with a public transaction hash and a Carbonmark certificate URL attached to a specific beneficiary wallet. Prefer it over off-chain offset services when cryptographic proof of retirement is required for compliance, reporting, or audit trails. Ideal for agents that need to programmatically retire small fractional tonne amounts per user action or transaction.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:42:47.794Z","isFirstParty":false}