Get started
What Origin is
Origin lets a DogeOS app ask Dogecoin a question and use the answer. Does this wallet hold the coin? Does it own a Doginal from this collection? Did this payment confirm?
Origin indexes every Dogecoin block: DOGE, UTXOs, inscriptions, Doginals, collections and the full DRC-20 ledger. One front door for all of it. You can search it, read it from your server, or use it from a DogeOS contract. When you need to write back to Dogecoin, Origin hands you the request, and your user’s wallet signs it.
Get started
Quickstart
Three ways in. Use whichever matches where you are.
1. No code
Go to ø.co, paste a Dogecoin address and type DU$T balance. You get the answer, where it came from, and your plugs.
2. From your server or frontend
Every fact Origin shows can be read straight from Origin’s public API. No key needed.
curl -s 'https://explorer.dogesoft.io/api/wallet/address/DPXjXNN2oiY8UWdGK1U5PgwK6ZV8cstn1s/drc20'{
"address": "DPXjXNN2oiY8UWdGK1U5PgwK6ZV8cstn1s",
"balances": [
{ "tick": "DU$T", "balance": "6969", "available": "6969.0", "transferable": "0.0", "decimals": 18 }
]
}3. From a DogeOS contract
Your contract calls Origin, Origin returns the fact. One address, one interface.
interface IOrigin {
function drc20Balance(string calldata dogeAddress, string calldata tick)
external view returns (uint256 amount, uint64 l1Height, uint64 attestedAt);
}
contract HoldersOnly {
IOrigin public immutable origin;
constructor(IOrigin origin_) { origin = origin_; }
function canEnter(string calldata dogeAddress) external view returns (bool) {
(uint256 amount, , uint64 attestedAt) = origin.drc20Balance(dogeAddress, "DU$T");
require(block.timestamp - attestedAt <= 1 hours, "stale");
return amount >= 1_000_000 * 1e18;
}
}0xcc816160fF36891090780Aca810f637600329d5E on Chikyū (chain id 6281971). All addresses: index.json.Get started
What’s live today
We only call something live when you can use it right now.
| Piece | State | Where |
|---|---|---|
| Search and guided paths | Live | ø.co · origin.dogesoft.io |
| Read API (balances, Doginals, collections, txs) | Live | explorer.dogesoft.io/api |
| Origin, OriginPlugs, OriginEnvelope contracts | Live · testnet | ABI explorer · addresses |
| Origin Services (OriginInscriber, OriginAnchor) | Live · testnet | See Origin Services |
| Genesis ANCHOR (prove any Dogecoin block or tx) | Live · free | See Genesis ANCHOR |
| Plugs marketplace | Live · testnet | plugs.dogesoft.io |
| Built on Origin badge | Live | See badge |
| Signed facts (attestations) | Live | /api/attest · multi-signed by Origin attesters, posted to Origin on DogeOS |
| Origin Proof | Planned | See Origin Proof |
| OP_CHECKZKP shadow index · OP_RETURN index | Live | Proof checking still to come. See OP_CHECKZKP |
DogeOS itself is still on testnet: Chikyū, chain id 6281971, RPC https://rpc.testnet.dogeos.com.
Get started
Plugs and earning
A plug is one reusable piece of a Dogecoin-powered build. “Holders of this coin get in.” “This Doginal is a playable character.”
- Origin Plugs: the marketplace. Every plug and build, with code generated from the real Origin ABI.
- Origin Plugs: build your own plug, list it on the marketplace, and browse the ABI explorer.
- Search on ø.co answers with plugs. Type what you’re building.
How the money moves
| 99% | of every plug license sale goes to the creator. |
| 1% | platform fee to Origin, fixed in the OriginPlugs contract. |
| 20% | of every paid call made through a verified plug goes to its creator: fresh facts (0.05 DOGE), inscriptions and stamps. Name your plug in the request (plugId). The rest funds attesters and the treasury. |
| Free | reading facts on DogeOS. View calls never cost anything. |
OriginPlugs: 0x71a96204D86194FfA46b04f89eB7eB6a0B2D4290.Get started
DogeSoft base plugs
Every build starts from the DogeSoft base for its category. Bases are free, owned by DogeSoft, and run on DogeSoft’s inscriber, the Inscription Standard, indexer and attesters.
| Identity | Wallet Connect Base (in every build) and Signature Verify Base |
| Bridge & Payments | Bridge Base, the one doorway for value and proof between Dogecoin and Origin (replaces Doge Confirm) |
| Holders | Holder Gate Base |
| Doginals | Doginal Verify Base |
| Coins | Coin Data Base |
| Proof | Anchor Base (free, under Season Seal) |
| Inscriber | Inscriber Base |
| ZK | ZK Base (read only while OP_CHECKZKP is a draft) |
- Build console: pick a category and its base is locked in first. Adding a plug adds the bases it needs; forks and share links keep them.
- Your own plug: the package declares
requireswith the base for its category. Plugs that inscribe, stamp, use ZK facts, take payments or check signatures also declare that base. Packages without them are refused. - No base for your category? Submit one with
base: true. It waits for DogeSoft review before it can become the official base.
OriginPlugs comes next.Get started
Build console, SDK and webhooks
From an idea to a deployed contract without leaving Origin.
- Build console: describe what you’re making (or tap + on plugs, or Fork a build). Origin picks the plugs layer by layer and writes the starter contract, front end and README. Try it runs every function on real Dogecoin data; Deploy compiles on Origin and deploys from your wallet.
- Signed facts: generated gates and reads take a fact your app fetches from
/api/attest(free within the daily quota), and check it on chain withorigin.verify. Fresh, no gas, nothing to keep posted. - SDK:
import { facts } from 'https://origin.dogesoft.io/sdk/origin.js', thenconst { fact, sigs } = await facts.drc20Balance('D…', 'DU$T'). Zero dependencies, browsers and Node 18+. - Earnings: creators see what Origin owes them (plug sales, creator shares, refunds) on the Earnings tab of their profile, with one Withdraw per contract.
- Webhooks: on the same tab, save one https URL. Origin POSTs when a plug sells or your stamps, inscriptions and fresh facts land or refund, signed
X-Origin-Signature: sha256=HMAC(secret, body).
Get started
Origin Services
Write to Dogecoin from a DogeOS contract. Pay in DOGE and Origin does the L1 work.
| Service | Price | What you get |
|---|---|---|
OriginInscriber | 0.01 DOGE on-chain base (per verb) + Soft license metering | Plain Doginal under the Inscription Standard via the licensed SoftInscribeBase. Body needs a Soft-issued ref. Free quota per license/day for refs and assists; overage billed by Soft (see /api/metering). Max 1.4 KB. |
OriginAnchor | 1 DOGE | Up to 76 bytes in an OP_RETURN, e.g. a hash that proves a leaderboard or a document. |
Origin.requestFact | 0.05 DOGE | One fresh fact, read now instead of from the last update. |
Attesters re-read the result from Dogecoin before signing a receipt, so you get exactly the bytes you paid for. If it isn’t done in 24 hours, reclaim gives your fee back. DRC-20 bodies aren’t offered. Full guide: docs.dogesoft.io/origin/services.
Dogecoin basics
UTXOs in one minute
Dogecoin doesn’t store account balances. It stores coins sitting in outputs.
Every transaction spends some earlier outputs and creates new ones. An output nobody has spent yet is a UTXO (unspent transaction output). A wallet’s DOGE balance is the sum of the UTXOs it can spend.
An output is named by the transaction that created it plus its position: txid:vout. That pair is an outpoint. You’ll see outpoints a lot, because inscriptions live on them.
balanceOf on Dogecoin. Think of a wallet as a purse of exact bills. Paying means handing over whole bills and getting change back as a new bill.Dogecoin basics
Inscriptions and Doginals
An inscription is data written into a Dogecoin transaction. A Doginal is a one-of-a-kind inscription, collected like an NFT.
The data (an image, text, JSON, HTML, audio, video) sits inside an envelope in the transaction. It gets an id like <txid>i0. The inscription then rides on a small output called the carrier. Whoever holds the carrier UTXO owns the inscription. To move it, you spend that output to someone else.
Collections aren’t a chain object. Origin keeps a registry of which inscriptions belong to which collection (298 at last count), and Origin uses it to answer “does this wallet own one of these?”.
contentHash.Dogecoin basics
DRC-20 coins
DRC-20 coins are written on Dogecoin with plain-text inscriptions. No contract is involved.
A coin is deployed, minted and moved by inscribing small JSON bodies like {"p":"drc-20","op":"transfer","tick":"DU$T","amt":"10"}. An indexer replays every block to keep the ledger.
Sending a coin is two steps:
- Inscribe the transfer to your own address. That amount becomes transferable, meaning locked inside that inscription.
- Move the inscription to the recipient. When the move confirms, the ledger debits you and credits them.
That’s why a balance has three numbers. Balance is the total. Available is free to inscribe. Transferable is locked in transfer inscriptions that haven’t moved yet.
DU$T is not DUST). The only transform Origin applies is lowercase with control characters removed. Amounts in Origin return values are base units: amount × 10^decimals.Dogecoin basics
Confirmations
A transaction is confirmed once it’s in a block. Each block after that adds a confirmation.
Dogecoin makes a block about every minute. Six confirmations is a common bar for “this won’t change”. Origin defaults to six for payments, and you can ask for more.
DRC-20 is one step behind: the ledger can only settle a block once Origin’s indexer has processed it. Origin reports the height the ledger is indexed to, and answers pending for anything newer.
Dogecoin basics
Words we use
| Coin | A DRC-20 asset. We say coin, not token. It’s inscribed on L1, not issued by a contract. |
| Doginal | A one-of-a-kind inscription. |
| Koinu | Smallest DOGE unit. 1 DOGE = 100,000,000 koinu. |
| Fee | Dogecoin charges per byte. There’s no gas. |
| Commit / reveal | The two transactions that write an inscription. |
| Move | The transaction that hands an inscription to its recipient. |
| Fact | One thing Origin can tell you, e.g. a coin balance at a block height. |
| L1 / L2 | Dogecoin mainnet / DogeOS. |
Guide
Reward holders of a coin
Only let people in, airdrop, or unlock a feature if their Dogecoin wallet holds enough of a coin.
- On Origin, choose I have a coin → Let DogeOS apps reward my holders, or Building an app → A wallet holds a coin.
- Enter the ticker, a wallet to test with, and the minimum.
- Copy plug 01 to check it from your server today, or plug 02 for your contract.
const res = await fetch(`https://explorer.dogesoft.io/api/wallet/address/${addr}/drc20`);
const { balances } = await res.json();
const dust = balances.find((b) => b.tick.toLowerCase() === 'du$t');
const ok = Number(dust?.balance ?? 0) >= 1_000_000;window.dogesoft.signMessage on your site, and check the signature on your server.Guide
Reward holders of a collection
“Does this wallet own at least one DU$TINAL DOG?”
- Choose I have Doginals → Let DogeOS apps reward my holders.
- Start typing the collection name. The list fills from Origin’s registry.
- Origin counts the Doginals that wallet holds right now and confirms each one against the registry.
The Origin call is collectionCount(dogeAddress, collectionId). Collection ids are slugs like dustinal-dogs.
Guide
Verify a coin transfer
Paste a txid and ask “was this DRC-20 transfer valid?”.
Origin fails closed. A transfer is valid only when the move settled on the ledger and wasn’t settled by a manual repair or sweep. If the indexer hasn’t reached that block yet, the answer is pending, never yes.
curl -s 'https://explorer.dogesoft.io/api/explorer/tx/06f8c5cc6c54e94045db7b0fe2ee82f4d95dc8b12a4fcf3d4d5eb85d0d7450ed'
# look at drc20_operations[].data.ledger_settled and .settle_reasonGuide
Confirm a DOGE payment
Ship the order once the payment has enough confirmations.
const tx = await fetch(`https://explorer.dogesoft.io/api/tx/${txid}`).then((r) => r.json());
const paid = tx.confirmations >= 6;On DogeOS the call is txConfirmed(txid, minConfirmations). The txid is passed as bytes32, written exactly as explorers display it. See Encoding rules.
Guide
Check an inscription is real
Paste an inscription id (…i0). Origin tells you whether Origin parsed it from chain, which envelope it uses, its content hash, where it was born and who holds it.
Inscription Standard means the body’s JSON opens with a ds tag: {"ds":{"action":"<VERB>","ref":"<id>"}}. Legacy Doginal means a valid inscription made before the standard. Both are real. The label tells you which rules it was written under.
Guide
Verify an inscription
Your users inscribe with their own Dogecoin wallet, using the Inscription Standard. Your DogeOS contract proves it landed exactly as expected.
- Expect. Your contract computes the hash it expects with
OriginEnvelope.envelopeHashOf(contentType, body). No owner, no storage, nothing to trust. - Inscribe. The user inscribes it on Dogecoin from their own wallet as a plain Doginal, with the verb inside the body’s
dstag. Origin never holds their key. - Prove. Once it has 6 confirmations, Origin’s attesters record what landed.
origin.inscriptionMatches(inscriptionId, envelopeHash)is true only if it is byte-for-byte what you expected.
bytes memory body = envelope.launchMintBody("dustinal-dogs", id, "777");
bytes32 expected = envelope.envelopeHashOf("application/json", body);
// after the user inscribes it with their own wallet:
require(origin.inscriptionMatches(inscriptionId, expected), "not the prize we minted");
require(origin.isInscriptionOwner(inscriptionId, dogeAddress), "not theirs");OriginEnvelope has launchMintBody and dsTag for the standard JSON byte-for-byte, plus drc20TransferBody and drc20MintBody for the separate DRC-20 protocol.envelopeHash = keccak256(abi.encode(contentType, body)), where the body opens with {"ds":{"action":"<VERB>","ref":"<id>"}}. Nothing but the plain Doginal goes on chain: no ACTION push, no metadata pushes. The SDK computes the same hash and is tested byte-for-byte against the contract.Guide · Anchor Base
Genesis ANCHOR — prove any Dogecoin block or tx Free
Ask Origin “is this Dogecoin transaction or block real?” and get back proof, not an opinion.
Origin fetches the raw block from a Dogecoin node and recomputes everything itself: every txid, the merkle root and your transaction’s merkle path, the block hash and the proof of work. It also checks the block is on the best chain. Once a result is 7+ confirmations deep, the attesters sign it as an Origin fact your DogeOS contract can check. Nothing is inscribed and nothing is charged.
curl -s 'https://origin.dogesoft.io/api/anchor/verify?tx=5b2a3f53f605d62c53e62932dac6925e3d74afa5a4b459745c36d42d0ed26a69'
# → "verified": true, "block": { "height": 0, "hash": "1a91e3da…5691", "pow": { "algo": "scrypt", "ok": true } },
# "checks": { "txidRecomputed": true, "merkleProof": true, "blockHashRecomputed": true, "proofOfWork": true,
# "onBestChain": true, "genesisRecordMatches": true },
# "genesis": { "message": "Nintondo", "value": "88 DOGE", "spendable": false }, "attestation": { "fact", "signatures" }
curl -s 'https://origin.dogesoft.io/api/anchor/verify?block=1' # by height
curl -s 'https://origin.dogesoft.io/api/anchor/verify?block=<hash>' # or block hash; add &txids=1 for every txidimport { anchor } from 'https://origin.dogesoft.io/sdk/origin.js';
const r = await anchor.verifyTx(anchor.GENESIS.txid);
if (r.verified) console.log(r.block.height, r.genesis.message); // 0 'Nintondo'
const b = await anchor.verifyBlock(1);
const fake = await anchor.verifyTx('de'.repeat(32)); // { ok: false, verified: false, error: 'No Dogecoin transaction has that txid.' }What comes back. verified is true only when every entry in checks is true. final is true at 7+ confirmations; before that you get the checks but no signature. proof has the tx’s index, merkle path (display hex, bottom-up) and the block’s txCount. Unknown txids answer 404, malformed ones 400, always with "verified": false.
On DogeOS. A final tx comes with two facts signed for the live Origin contract: TX_INCLUDED (subject txid, value 1, the same fact as /api/attest/tx-included) and L1_BLOCK (subject block hash, key tx count, value merkle root). Check either for free with Origin.verify(fact, signatures), or keep it for good with Origin.submit(fact, signatures) (you pay only gas), after which txConfirmed(txid, n) works for everyone. One L1_BLOCK fact covers every transaction in that block through its merkle path.
(bool ok, , uint64 height, ) = IGenesisAnchor(plug).verifyTx(fact, sigs); // signed TX_INCLUDED
bool first = IGenesisAnchor(plug).isGenesisTx(rawTx); // genesis needs no signature at allGenesis is special. Block 0 is built into Dogecoin Core, so the node can’t return its coinbase like a normal transaction (see the Genesis page). Origin rebuilds it from block 0’s raw bytes and matches it against the published genesis record. Origin’s contract reserves height 0, so for genesis the GenesisAnchorPlug helper hard-codes the genesis hashes and checks raw bytes with SHA-256 on chain, no signature needed.
GenesisAnchorPlug Live · testnet 0xa2B16644D978EF6f9A9aB9fcAF196e19d9aD2551 on DogeOS Chikyū (chain 6281971), wired to Origin 0xcc816160fF36891090780Aca810f637600329d5E. All of its functions are free view/pure calls (SDK: anchor.PLUG_ADDRESS, GENESIS_ANCHOR_ABI). See it on the explorer.
| Limit | Anonymous | Licensed (signed session) |
|---|---|---|
| Price | Free | Free (0 DOGE overage) |
| Per minute | Small allowance, per IP | 120 per license (and per IP) |
| Per UTC day | Small allowance, per IP | 100,000 per license |
The licensed tier needs proof that you control the wallet: sign in once (License sessions) and send the token as X-Origin-Session. A bare plugId/wallet in the query is ignored and you get the anonymous tier. Inputs are strict: block is a plain height or a 64-hex hash, txids is 1 or 0, and unknown parameters answer 400.
Want the proof stamped on Dogecoin itself? That’s the paid ANCHOR verb through Origin Services, with a Soft-issued ref and the normal fees. Verifying stays free.
Guide · Licenses
License sessions: prove you hold the license
Licensed calls need proof that you control the wallet holding the license, not just its address.
Sign one plain message with the wallet (no transaction, no gas). Origin builds the message itself: it names origin.dogesoft.io, DogeOS chain 6281971, your plug, your wallet, a one-time nonce and a 5-minute expiry. Origin checks the signature (EIP-191 personal_sign; smart-contract wallets through EIP-1271), then checks OriginPlugs.hasLicense(plugId, wallet) on chain, and returns a session token bound to that wallet and plug. It lasts 30 minutes. Send it as the X-Origin-Session header.
import { session, refs, anchor, facts, metering } from 'https://origin.dogesoft.io/sdk/origin.js';
const s = await session.signIn({ wallet, plugId: 12, provider: window.ethereum }); // or signMessage: (m) => signer.signMessage(m)
await anchor.verifyTx(txid, { session: s }); // licensed limits
await facts.drc20Balance('D…', 'DU$T', { session: s }); // signed facts on your license quota
await refs.issue({ session: s, action: 'BUY' }); // single-use Soft ref for an inscription body
await metering({ session: s }); // today’s usage for this license
if (!session.fresh(s)) { /* sign in again */ }GET /api/session/challenge?wallet=0x…&plugId=12 → { nonce, message, expiresAt }
# sign message with personal_sign
POST /api/session { "nonce": "…", "signature": "0x…" } → { token, wallet, plugId, chainId, expiresAt }
GET /api/session X-Origin-Session: <token> → who the token belongs to
POST /api/ref { "action": "BUY" } X-Origin-Session: <token> → { ref, expiresInSeconds }| Rule | What happens |
|---|---|
| Each nonce works once | It is used up the moment it is presented, even if the signature is wrong. A replayed signature answers 401. |
| 5 minutes to sign | An expired challenge answers 401; get a new one. |
| Wrong wallet, plug, chain or site | The signature must match the exact message Origin built for that wallet, plug, chain 6281971 and origin.dogesoft.io. Anything else answers 401. |
| No license | 403. Licenses are re-checked on chain while a session is in use, so a revoked license stops working shortly. |
| Edited or expired token | 401; sign in again. |
| No session | /api/ref answers 401. /api/anchor/verify and /api/attest/<fact> answer on the anonymous tier. |
Refs. A Soft-issued ref is bound to your plug, your wallet and one Origin action (BUY, GIFT, ANCHOR, …), is used once, and expires after 24 hours. A ref only works for the wallet it was issued to, so a copied ref is useless.
Guide
Built on Origin badge
Show users your Dogecoin data is verified by Origin. One line.
<script src="https://origin.dogesoft.io/shared/badge/origin-badge.js" defer></script>
<origin-badge plug="collection-holder-gate"></origin-badge>Attributes: plug (links to that plug’s page on Origin Plugs), variant="mark" (logo only), theme="light", size="sm", floating (pinned bottom-right).
[](https://plugs.dogesoft.io)Every plug page on Origin Plugs, every finished build on Origin and the Plugs studio hands you this snippet with your plug filled in.
Reference
Read API
Base: https://explorer.dogesoft.io/api. GET, public, JSON.
| Endpoint | Gives you |
|---|---|
/health | Indexed height, chain tip, DRC-20 ledger height, staleness |
/wallet/address/{addr}/balance | DOGE balance in koinu, UTXO count |
/wallet/address/{addr}/utxos | UTXOs and the inscriptions sitting on them |
/wallet/address/{addr}/drc20 | Coin balances: balance, available, transferable |
/wallet/address/{addr}/history | Recent confirmed activity |
/tx/{txid} | Confirmations, mempool flag, raw hex |
/explorer/tx/{txid} | Decoded DRC-20 operations and inscriptions |
/explorer/drc20/{tick} | Coin deploy, supply, holders |
/explorer/inscriptions/{id} | Owner, location, genesis, content hash, collections |
/content/{id} | The content, reassembled from chain (no /api prefix) |
/explorer/collections | Collections (max 200 per page, use offset) |
/explorer/collections/{id}/items | Items in a collection |
du%24t). The decoded-tx endpoint can take several seconds on busy transactions, so cache what you can.Reference
Origin contract Live · testnet
One entry point on DogeOS. Every method is a view, and every answer carries the L1 height it was true at.
| Contract | Address on DogeOS Chikyū (6281971) |
|---|---|
Origin | 0xcc816160fF36891090780Aca810f637600329d5E |
OriginPlugs | 0x71a96204D86194FfA46b04f89eB7eB6a0B2D4290 |
OriginEnvelope | 0xdfa7fACb890C6966019BbC0EdA26508df9130592 |
OriginInscriber | 0xFd4dB41F0Dd1ac4C0EBB06FF2705A97B8e31b37b |
OriginAnchor | 0xA52DF38e689F76c95cE5d4d596142CB0C9471577 |
The full, compiled interface lives in the ABI explorer (download: Origin.json, OriginPlugs.json). The calls you’ll use most:
function drc20Balance(string calldata dogeAddress, string calldata tick)
external view returns (uint256 amount, uint64 l1Height, uint64 attestedAt);
function collectionCount(string calldata dogeAddress, string calldata collectionId)
external view returns (uint256 count, uint64 l1Height, uint64 attestedAt);
function isInscriptionOwner(string calldata inscriptionId, string calldata dogeAddress)
external view returns (bool);
function inscriptionValid(string calldata inscriptionId)
external view returns (bool ok, bytes32 contentHash, uint64 l1Height);
function drc20Supply(string calldata tick)
external view returns (uint256 minted, uint256 maxSupply, uint64 l1Height);
function txConfirmed(bytes32 txid, uint256 minConfirmations)
external view returns (bool ok, uint64 l1Height);
function drc20TransferValid(bytes32 txid) external view returns (bool ok, uint64 l1Height);
function isLinked(address account, string calldata dogeAddress) external view returns (bool);
function inscriptionHasAction(string calldata inscriptionId, string calldata action) external view returns (bool);
function inscriptionMatches(string calldata inscriptionId, bytes32 envelopeHash) external view returns (bool);
function check(bytes32 factType, bytes32 subject, bytes32 key, uint8 op, uint256 threshold, uint64 maxAge)
external view returns (bool);
function requestFact(bytes32 factType, bytes32 subject, bytes32 key, uint256 plugId)
external payable returns (uint256 requestId);Fact types
| Fact | Value |
|---|---|
DOGE_BALANCE | koinu at outputs with more than 6 confirmations |
DRC20_BALANCE | amount, 18-decimal fixed point |
DRC20_MINTED / DRC20_MAX_SUPPLY | supply, 18-decimal fixed point |
DRC20_TRANSFER_VALID | 1 if the transfer settled on the ledger, else 0 |
COLLECTION_COUNT | Doginals held from one collection |
INSCRIPTION_OWNER | keccak256(bytes(ownerAddress)) |
INSCRIPTION_VALID | SHA-256 of the content |
INSCRIPTION_ACTION / INSCRIPTION_ENVELOPE | the Inscription Standard verb / the hash of the plain Doginal |
TX_INCLUDED | 1 once the transaction is six blocks deep |
ADDRESS_LINK | a DogeOS account linked to a Dogecoin address |
L1_TIP | latest Dogecoin height Origin has seen (refreshed every 30 minutes) |
Signed fact reads: limits
Signed facts from GET /api/attest/<fact> are metered like every other read. Without a session you get the anonymous tier, counted per IP. With a license session (X-Origin-Session) reads count against your license instead. Every answer carries a license block with usedToday, freePerDay and overQuota; GET /api/metering shows today’s usage.
| Limit | Anonymous | Licensed (signed session) |
|---|---|---|
| Per minute | Small allowance, per IP | 120 per license (and per IP) |
| Free per UTC day | Small allowance, per IP, then 429 | 2,000 per license |
| After the free quota | Refused until 00:00 UTC | 0.005 DOGE per read (overQuota: true), up to 20,000 a day |
Status reads, and reads that fail on Origin’s side, aren’t counted. A bad or expired token answers 401; it never falls back to the anonymous tier. Reading facts that are already stored on Origin (contract views on DogeOS) stays free.
Freshness
Facts are snapshots. Check attestedAt (or l1Height) against your own limit, e.g. one hour for a gate, and reject anything older.
verify(), so contracts built on Origin stop too. Every parameter, role and attester change goes through a timelock. 197 automated tests.Reference
Encoding rules
| Thing | How Origin encodes it |
|---|---|
| Dogecoin address | Passed as string. Hashed as keccak256(bytes(addr)), case-sensitive. |
| Ticker | Passed as string, exact. Keyed by keccak256(lowercase(tick)). |
| Inscription id | string like <txid>i0. Keyed by keccak256(lowercase(id)). |
| Collection | Slug string, e.g. dustinal-dogs. |
| txid | bytes32 = 0x + the txid as explorers display it (no byte reversal). |
| Amounts | uint256 base units. DOGE in koinu. |
Reference
Inscription standard
Every inscription under the standard is a plain Doginal. The verb rides inside the body:
{"ds":{"action":"<VERB>","ref":"<id>"}} // ref is optional; nothing else inside ds
Origin serves marketplace and launch verbs (BUY, LAUNCH_MINT, and the rest of the licensed Origin set) through SoftInscribeBase only. Some Doge Soft actions are internal and never available through Origin. The verbs are documented on the inscription standard. An action is official only with the Doge Soft signature. The indexer, reading Dogecoin Core, is the source of truth for the orbit. DRC-20 stays its own positional protocol.
Reference
Answers and failures
| Answer | Means |
|---|---|
| ✓ Yes | True on L1 at the stated height, under Origin’s rules. |
| ✕ No | Checked, and not true. |
| … Pending | Not decided yet: too few confirmations, or the DRC-20 ledger hasn’t reached that block. |
| Ø Info | Context, not a yes/no fact. |
Origin fails closed. When data is ambiguous, missing or slow, it doesn’t guess. It says so.
Trust and roadmap
Trust model
- Source of truth: Origin’s indexer, replaying every Dogecoin block.
- On DogeOS: facts are multi-signed by Origin attesters, with their own dedicated keys. The contracts refuse anything below the signature threshold or with fewer than six Dogecoin confirmations.
- Writes: on DogeOS, always signed by the user’s wallet; Origin never holds user keys. For paid Origin Services, Origin’s inscriber writes to Dogecoin and the attesters re-read it from chain before the fee is released. If it isn’t done in time, the fee is refundable.
- AI: when the assistant arrives, it only turns your words into a query. The answer always comes from Origin’s deterministic index.
- Domains: ø.co is branding. Nothing on-chain or in the APIs depends on it.
Trust and roadmap
Origin Proof Planned
Prove something about a wallet’s Dogecoin history without showing all of it.
Examples: active for more than two years, used on 100 different days, held a Doginal from a collection since 2024, has created coins. These are activity and Sybil-resistance signals, not identity. A wallet is not a person, and Proof will never claim it is. No KYC, no names, no documents.
Trust and roadmap
OP_CHECKZKP Shadow index live
A draft Dogecoin soft fork (discussion #3869) that would let scripts verify zero-knowledge proofs.
It redefines OP_NOP10 (0xB9) as OP_CHECKZKP, with a Groth16 / BLS12-381 mode and a Halo2-KZG / BN256 mode. It isn’t activated, and Dogecoin Core hasn’t agreed to it.
Origin indexes it in shadow mode: every use is detected and parsed (mode, proof, verifying key, public inputs) and labelled not consensus-enforced. Proofs are stored but not checked yet; verification comes next. Older blocks are still being added. If it activates, the history is already there, and Origin can treat a verified proof as a native L1 fact.
Read it at explorer.dogesoft.io/api/explorer/zkp/status, /zkp/recent, /zkp/tx/:txid and /zkp/vk/:sha256. Every OP_RETURN is indexed too: /opreturn/recent?magic=ORA1, /opreturn/tx/:txid, /opreturn/sha256/:hash. Full reference: docs.dogesoft.io/explorer/zkp.
Trust and roadmap
FAQ
Do I need an API key?
No. Reads are public and rate-limited.
Does it cost anything?
Reading facts already stored on Origin (contract views) is free. Signed facts from /api/attest are free within a small per-IP allowance, or 2,000 a day per license with a signed session, then 0.005 DOGE per read on a license (limits). A fresh on-demand fact and Soft-issued refs use the license quota then a small Soft overage (defaults in /api/metering). On-chain inscription fee is 0.01 DOGE base on OriginInscriber; Soft may add assist metering. Paid plugs cost whatever their creator sets; the marketplace keeps 1%.
Is there a Dogecoin testnet?
Origin reads Dogecoin mainnet. DogeOS is on testnet (Chikyū) today.
Why does a balance show “transferable”?
Those coins are locked inside a transfer inscription that hasn’t moved yet. See DRC-20 coins.
Can Origin move coins for my users?
No. It builds the request; the user’s wallet signs it.
Something looks wrong.
Every answer links to the raw record it came from. Send that link to Origin.