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

Directory	Purpose	Deploy
`frontend/`	Static site	`npx wrangler pages deploy . --project-name=basescriptions --commit-dirty=true`
`worker/`	REST API (Hono)	`npx wrangler deploy`
`subdomain-worker/`	*.basescriptions.com	`npx wrangler deploy`
`scripts/`	Indexer, registration tools	`npx 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

User registers
```
mysite
```
name

User creates manifest:

{"basescriptions":{"mysite":{"home":"0xtx..."}}}

User inscribes HTML content
```
mysite.basescriptions.com
```
serves the HTML

Subdomain worker flow:

Extract subdomain from host
Find owner via
```
/name/:name
```
API
Find manifest in owner's inscriptions
Fetch HTML from chain via
```
creation_tx
```
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

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

Directory	Purpose	Deploy
`frontend/`	Static site	`npx wrangler pages deploy . --project-name=basescriptions --commit-dirty=true`
`worker/`	REST API (Hono)	`npx wrangler deploy`
`subdomain-worker/`	*.basescriptions.com	`npx wrangler deploy`
`scripts/`	Indexer, registration tools	`npx 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

User registers
```
mysite
```
name

User creates manifest:

{"basescriptions":{"mysite":{"home":"0xtx..."}}}

User inscribes HTML content
```
mysite.basescriptions.com
```
serves the HTML

Subdomain worker flow:

Extract subdomain from host
Find owner via
```
/name/:name
```
API
Find manifest in owner's inscriptions
Fetch HTML from chain via
```
creation_tx
```
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

Basescriptions

Related Skills

Markdown Converter

Nano Banana Pro

1password