Skip to content
LiveNew tools this week
Submit
AIMarketly
Basescriptions logo

Basescriptions

Ethscriptions platform on Base L2. On-chain inscriptions for names, data, and websites.

jefdiesel/basescriptions0installs0starsDevOps & CI/CD

SKILL.md

Full skill instructions

Basescriptions

Ethscriptions platform on Base L2. On-chain inscriptions for names, data, and websites.

Protocol

Ethscriptions use transaction calldata for permanent on-chain storage:

  • Create: Self-transfer (to === from) with data: prefixed UTF-8 calldata
  • ID: SHA-256 hash of calldata (lowercase)
  • Transfer: Send TX to recipient with inscription hash as calldata
data:,name                          # Plain text name
data:image/​png;base64,iVBORw...     # Base64 image
data:text/​html;base64,PCFET...      # Base64 HTML
data:application/​json,{"key":...}   # JSON data

Architecture

Base Chain (calldata) → Indexer → Supabase (metadata only)
                                        ↓
                                  API Worker → Frontend
                                        ↓
                              Subdomain Worker (*.basescriptions.com)

Key design: Database stores metadata only, NOT content. Content fetched from chain via RPC.

Components

DirectoryPurposeDeploy
frontend/Static sitenpx wrangler pages deploy . --project-name=basescriptions --commit-dirty=true
worker/REST API (Hono)npx wrangler deploy
subdomain-worker/*.basescriptions.comnpx wrangler deploy
scripts/Indexer, registration toolsnpx tsx script.ts

API Endpoints

Base URL: https://basescriptions-api.wrapit.workers.dev

GET /​content/:id          # Raw content (tx hash or content hash)
GET /​name/:name           # Check name availability
GET /​hash/:hash           # Inscription metadata
GET /​recent               # Recent inscriptions (?limit=&offset=)
GET /​owned/:address       # Owned by address
GET /​stats                # Indexer stats
GET /​marketplace/​listings # Active listings
POST /​register            # Register inscription
POST /​transfer            # Record transfer

Database (Supabase)

base_ethscriptions

  • id (text, PK) - SHA-256 hash
  • content_uri (text) - NULL (content on chain)
  • content_type (text) - MIME type
  • creator, current_owner (text) - Addresses
  • creation_tx (text) - TX hash for content fetch
  • creation_block (bigint)
  • inscription_number (int)

base_transfers - Transfer history indexer_state - Last indexed block marketplace_* - Listings, offers, sales

Content Fetching

Content lives on-chain. To fetch:

// 1. Get TX from RPC
const tx = await fetch('https://mainnet.base.org', {
  method: 'POST',
  body: JSON.stringify({
    jsonrpc: '2.0', id: 1,
    method: 'eth_getTransactionByHash',
    params: [txHash]
  })
}).then(r => r.json());

// 2. Decode hex calldata
const hex = tx.result.input.slice(2);
const bytes = new Uint8Array(hex.match(/​.{2}/​g).map(b => parseInt(b, 16)));
const content = new TextDecoder().decode(bytes);
// => "data:text/​html;base64,..."

Or use API: GET /​content/:id handles this automatically.

Common Tasks

Deploy frontend

cd frontend && npx wrangler pages deploy . --project-name=basescriptions --commit-dirty=true

Deploy API

cd worker && npx wrangler deploy

Run indexer

npx tsx scripts/​backfill.ts
START_BLOCK=40000000 npx tsx scripts/​backfill.ts

Check indexer status

curl https://basescriptions-api.wrapit.workers.dev/stats

Check Mac Mini indexer

SSHPASS='Margot25' sshpass -e ssh [email protected] "tail -30 ~/​basescriptions/​logs/​backfill.log"
SSHPASS='Margot25' sshpass -e ssh [email protected] "launchctl list | grep base"

Restart Mac Mini indexer

SSHPASS='Margot25' sshpass -e ssh [email protected] "launchctl stop com.basescriptions.backfill && launchctl start com.basescriptions.backfill"

Deploy script to Mac Mini

SSHPASS='Margot25' sshpass -e scp scripts/​backfill.ts [email protected]:~/​basescriptions/​scripts/

Insert missing inscription

npx tsx scripts/​insert-missing.ts

Environment Variables

BASE_RPC_URL=https://mainnet.base.org
SUPABASE_URL=https://xxx.supabase.co
SUPABASE_SERVICE_KEY=eyJ...
PRIVATE_KEY=0x...  # For registration scripts

Frontend Pages

  • / - Homepage, search, recent inscriptions
  • /​item/:hash - Inscription detail
  • /:address - Wallet profile (if 0x...)
  • /:name - Name profile (if not 0x)
  • /​register/ - Register name
  • /​inscribe/ - Inscribe data
  • /​upload/ - Upload website
  • /​marketplace/ - Buy/​sell

Subdomain Sites

  1. User registers mysite name
  2. User creates manifest: {"basescriptions":{"mysite":{"home":"0xtx..."}}}
  3. User inscribes HTML content
  4. mysite.basescriptions.com serves the HTML

Subdomain worker flow:

  1. Extract subdomain from host
  2. Find owner via /​name/:name API
  3. Find manifest in owner's inscriptions
  4. Fetch HTML from chain via creation_tx
  5. Serve with injected base tag

RPC Endpoints

https://mainnet.base.org              # Primary (rate limited)
https://base-mainnet.g.alchemy.com    # Fallback
https://base.llamarpc.com             # Fallback
https://base-rpc.publicnode.com       # Fallback

Indexer Notes

  • Uses staticNetwork: true in ethers.js to skip network detection (prevents blocking when RPC is down)
  • Automatic RPC fallback when rate limited or failing
  • Saves progress to indexer_state table every batch
  • Runs as launchd service on Mac Mini with KeepAlive

Frontend Notes

  • Chain verification before every transaction (prevents wrong-chain sends)
  • Filters application/​json and application/​text spam from recent display
  • HTML iframes get injected CSS for transparent backgrounds
  • Infinite scroll with lazy loading for recent inscriptions

Notes

  • Chain: Base L2, chainId 8453 (hex: 0x2105)
  • Gas: ~$0.001 per inscription
  • Content must be valid UTF-8 with data: prefix
  • Large content (>2.7KB) was causing DB index issues - now content_uri is NULL
  • Inscription numbers are sequential per indexer
  • Transfers require sender to currently own the inscription