Docs / Origin / Origin

Attestations

Origin

Attestations of Dogecoin truth for L2 contracts: balances, DRC-20 Coins, Doginal ownership, payments. Two-of-three signed, six confirmations deep.

Testnet

Origin is Doge Soft's own attestations layer: it brings Dogecoin L1 truth to the Doge Soft L2. An L2 contract can ask, in one call, what is true on Dogecoin right now: a DOGE balance, a DRC-20 Coin balance, who owns a Doginal, whether an inscription is valid, whether a payment confirmed. Origin reads the chain through its own node and indexer, two of three attesters sign the answer, and the Origin contract checks the signatures before it stores anything. Start at origin.dogesoft.io (also ø.co); ready-made contracts are on plugs.dogesoft.io.

The contracts

ContractWhat it does
OriginStores signed Dogecoin facts and serves free reads. Paid fresh facts on request.
OriginPlugsThe plugs marketplace: list, buy and claim plugs, licenses, creator payouts. See Plugs marketplace.
OriginEnvelopeStateless helpers for the v1 inscription envelope: build bodies and compute envelopeHash on chain.
OriginInscriberPay on the Doge Soft L2, get a v1 inscription on Dogecoin. See Origin Services.
OriginAnchorPay on the Doge Soft L2, get up to 76 bytes stamped on Dogecoin in an OP_RETURN. See Origin Services.

Network: Doge Soft L2 testnet (chain id 6281971). Live addresses and ABIs are always at https://origin.dogesoft.io/shared/abi/index.json; Origin went live on testnet on 2026-10-03 at 0xcc816160fF36891090780Aca810f637600329d5E.

ContractAddress (Doge Soft L2 testnet, 6281971)
Origin0xcc816160fF36891090780Aca810f637600329d5E
OriginPlugs0x71a96204D86194FfA46b04f89eB7eB6a0B2D4290
OriginEnvelope0xA2a8CDce7b7fbc5Cc0AF63efa0328BDA3340876C
OriginInscriber0xF75A545D1BA21F6559a6c95C5E5Af67dFA0AEAa3
OriginAnchor0xA52DF38e689F76c95cE5d4d596142CB0C9471577

What you can rely on

  • Two of three signatures. Every fact and every receipt needs two independent attester signatures (EIP-712, bound to the chain id and contract address). The contract will not accept fewer, ever: the floor is hard-coded.
  • Six confirmations. Facts are anchored to a Dogecoin block at least six deep, and balances only count outputs that deep. Origin never over-counts. The floor is hard-coded too.
  • Every answer says when. Each fact carries the Dogecoin height it was read at and when it was signed, so your contract decides how fresh is fresh enough.
  • Audited. Reviewed over several rounds: 91/100, low risk, no open critical, high or medium findings. 197 automated tests. The contracts are not upgradeable.
  • No surprise changes. Admin changes wait in a timelock and expire after 14 days if unused. Pausing is instant, for emergencies only, and it fails closed: while Origin is paused, or a fact is quarantined, every read returns nothing and verify() returns false, so contracts built on Origin stop too.

Free reads

reads.sol
origin.dogeBalance(dogeAddress)              // (koinu, l1Height, attestedAt)
origin.drc20Balance(dogeAddress, tick)       // (amount, l1Height, attestedAt)
origin.collectionCount(dogeAddress, slug)    // (count, l1Height, attestedAt)
origin.isInscriptionOwner(inscriptionId, dogeAddress)
origin.inscriptionValid(inscriptionId)       // (ok, contentHash, l1Height)
origin.inscriptionMatches(inscriptionId, envelopeHash)
origin.drc20TransferValid(txid)
origin.txConfirmed(txid, minConfirmations)
origin.l1Tip()                               // latest Dogecoin height Origin has seen

Fresh facts (paid)

When the stored answer is too old for what you're doing, ask for a new one. It costs 0.05 DOGE per fact. If no one answers before the deadline, you take your fee back.

fresh.sol
uint256 fee = origin.requestFee(keccak256("DRC20_BALANCE"));   // 0.05 DOGE
uint256 id = origin.requestFact{value: fee}(
  keccak256("DRC20_BALANCE"), origin.addressKey(dogeAddress), origin.tickKey("DU$T"), plugId);
// then POST { requestId, address, tick } to https://origin.dogesoft.io/api/attest/fulfill

Fact types: DOGE_BALANCE, DRC20_BALANCE, DRC20_TRANSFER_VALID, COLLECTION_COUNT, INSCRIPTION_OWNER, INSCRIPTION_VALID, INSCRIPTION_ACTION, TX_INCLUDED. Each request is one fact about one address, coin or inscription, not a list. Pass a plugId and that plug's creator earns 20% of the fee (how creators earn).

Attest API

The same signed facts over HTTP, free. Submit them to Origin yourself, or verify them off chain. Base URL https://origin.dogesoft.io.

EndpointDescription
GET /api/attestAttester addresses, confirmations, available facts.
GET /api/attest/doge-balance?address=Confirmed DOGE balance.
GET /api/attest/drc20-balance?address=&tick=Confirmed DRC-20 Coin balance.
GET /api/attest/collection-count?address=&collection=How many Doginals of a collection the address holds.
GET /api/attest/inscription-owner?id=Current owner of a Doginal.
GET /api/attest/inscription-valid?id=Inscription exists, with its content hash.
GET /api/attest/drc20-transfer-valid?txid=A DRC-20 transfer was valid.
GET /api/attest/tx-included?txid=Transaction is in a block, six deep.
GET /api/attest/op-return?txid=The OP_RETURN bytes a transaction carries.
GET /api/attest/l1-tipSigned Dogecoin tip.
POST /api/attest/fulfillAnswer a paid fresh fact: { requestId, …inputs }.
ℹ️

Origin answers questions about Dogecoin. It doesn't hold your coins, run a bridge or trade. Nothing in Origin can move anything on Dogecoin except the paid Origin Services you ask for.