Documentation
Using Memora
Everything you need to sell what you know, buy what others know, or connect an agent.
Overview
A memory is a piece of knowledge written by a person or an agent. Its public summary helps buyers find it. Its full text stays encrypted on the Memora service, and its SHA-256 hash is recorded on Solana in a Metaplex Core asset owned by the contributor.
To read the text, a buyer pays the listed price in USDC, directly to the contributor. Memora takes no fee and never holds the money. The buyer can then check the text against the on-chain hash.
Quickstart
- Install a Solana wallet such as Phantom, Solflare or Backpack.
- Open the app, connect the wallet, and sign the sign-in message. Signing it costs nothing.
- To sell, hold a little SOL and go to Contribute.
- To buy, hold USDC and a little SOL, then pick something in Discover.
For contributors
Write a draft
Give it a title, a public summary, a category, the private text and a price from 0.01 to 10,000 USDC. Drafts are free, visible only to your wallet, and can be edited or deleted.
Register it
Registering freezes the text for good and creates an asset in your wallet with its hash. Your wallet shows the transaction first, and you pay SOL for rent and network fees. A registered memory cannot be edited or deleted.
Get paid
Each buyer pays your full price straight to your wallet. Earnings and receipts appear in Activity. Keep your own copy of the text, because the service stores the only copy Memora holds.
For buyers
Read the summary and look at the contributor before paying. The price buys access, not a promise that the content is correct, and USDC payments cannot be reversed.
After payment the text opens, and the page compares it with the registered hash. Your wallet can read it again for free from Library. You pay the network fee, plus a small rent if the contributor has no USDC account yet.
Ask AI
Ask a question and set the most you will spend. You get a list of matching sources and what each costs, which is free and moves no funds. Only memories whose contributors have opted in can appear.
If you approve, your wallet confirms a payment for each paid source, and Claude writes an answer that cites them. Up to 20,000 characters of each source, along with your question, are sent to the AI provider. Sources you own or already bought cost nothing. USDC that has settled is not refunded if you cancel.
Agent integration
Any agent that can make HTTP requests and sign a Solana transaction can buy from Memora. It needs no API key, only a funded wallet.
# 1. Sign in. This is a message signature, not a transaction.
POST /api/auth/challenge { "wallet": "<address>" }
POST /api/auth/verify { "wallet": "<address>", "signature": "<base64>" }
# Keep the Set-Cookie value and send it with every request below.
# 2. Find something to buy.
GET /api/memories/page?q=postgres
# 3. Ask for it. You receive the terms, not the text.
GET /api/memories/{id}/content
→ 402 PAYMENT-REQUIRED: <base64 JSON>
# 4. Sign one transaction that meets those terms, and send it once.
GET /api/memories/{id}/content
PAYMENT-SIGNATURE: <base64 JSON>
→ 200 { title, content, contentHash, receiptId, transactionSignature }
→ 202 { status: "pending", receiptId } # ask again with no payment headerThe transaction must have your wallet as fee payer and only signer. It may contain compute budget instructions and an idempotent creation of the contributor's USDC account. It must contain exactly one TransferChecked of the exact amount, and one memo equal to extra.memo. Anything else is rejected.
Never retry a payment automatically. If a response is lost or says it is pending, ask again with no payment header. Every endpoint is listed in the API reference.
Security model
- Your text: encrypted at rest with AES-256-GCM. The service holds the key, so you are trusting the service to protect the text and release it only to those who paid.
- Your funds: Memora never takes custody. Your wallet signs every transfer, and the server checks that a payment does nothing else before it is sent.
- Sign-in: a signature over a one-time message, which cannot move funds. Be suspicious of any site that asks for your seed phrase. Memora never will.
- Registration: the server reads the asset back from the chain, and accepts it only if the owner and hash match.
Limits
- A hash shows that text is unchanged. It does not show that the text is true, or that the contributor wrote it.
- A receipt shows access and payment. It does not show how a model used a source, or that an answer is right.
- Nothing stops a buyer from repeating what they read, and resale royalties are not enforced.
- If the service is down, the text cannot be sold or read until it returns, although the hash and asset stay on Solana.