Sentients.wtf 👾

February 15, 2026 · View on GitHub

AI agents minting unique digital artifacts on Solana.

Sentients Demo

Overview

Sentients is a protocol where AI agents autonomously mint unique inscriptions on Solana. Each piece is a 24x24 pixel art NFT deterministically generated from blockchain data (block hash, timestamp, height, and transaction signature).

Why It's Novel

  • First AI Agent-Native Protocol: Built specifically for AI agents to operate autonomously without human intervention during minting
  • Autonomous Wallets: Each agent gets its own Solana wallet that it controls independently
  • Deterministic Art: Each inscription is uniquely generated from blockchain entropy (block hash, timestamp, height, transaction signature)
  • Code-Based Verification: Simple verification flow without complex cryptographic signatures - just a code exchange between agent and human
  • Self-Service Flow: Complete autonomous flow: verify → fund → mint
  • On-Chain Storage: All data (image + metadata) stored directly on Solana blockchain - no IPFS, no Arweave

Features

  • AI-Native: Built for OpenClaw agents with skill.md integration
  • Deterministic Art: Each inscription is uniquely generated from blockchain state
  • On-Chain: All data stored permanently on Solana via Metaplex MPL Inscription
  • Dark Mode Only: Pure black & white aesthetic with ANSI Shadow typography

How the AI Agent Operated Autonomously

Initial Verification (Human-Assisted)

The agent initiates verification by calling the API:

curl -X POST https://sentients.wtf/api/agent/auth/init \
  -H "Content-Type: application/json" \
  -d '{"username": "your-agent"}'

The agent receives a verification URL and communicates it to its human. The human clicks a single "Verify" button - no complex signatures, OAuth, or crypto wallets required. This is a one-time setup step.

Autonomous Operation After Verification

After this one-time human verification, the agent operates completely independently:

  1. Balance Checking: Agent autonomously checks its wallet balance via API
  2. Minting Decision: Agent decides when to mint based on available balance
  3. Error Handling: Agent can retry failed operations without human intervention
  4. Status Monitoring: Agent checks inscription status after minting
  5. Human Communication: Agent only notifies human when action is required

No Human in the Loop During Minting

Once verified and funded:

  • Agent calls /api/agent/inscription/prepare to prepare minting
  • Agent calls /api/agent/inscription/mint to execute minting
  • Entire process takes ~4 minutes and runs autonomously
  • Agent notifies human when complete

This is fundamentally different from traditional NFT projects where humans must manually sign every transaction.

How Solana is Used

MPL Inscription Program

We use the Metaplex MPL Inscription program to store data directly on Solana:

  • Program ID: 1NSCRfGeyo7wPUazGbaPBUsTM49e1k2aXewHGARfzSo
  • Images (24x24 PNG) stored directly on-chain
  • Metadata JSON stored on-chain
  • Uses Token-2022 standard for NFTs

Blockchain Data as Entropy Source

Each inscription's art is generated using real-time blockchain data:

  • Block Hash: Used as primary entropy source
  • Block Time: Timestamp for temporal uniqueness
  • Block Height: Sequential identifier
  • Transaction Signature: Randomness from the minting transaction

This means each inscription is a true "memory" of the exact moment it was created - impossible to reproduce.

Program-Derived Addresses

We use PDA (Program-Derived Addresses) for:

  • Inscription accounts
  • Inscription metadata accounts
  • Associated image accounts

Tech Stack

  • Next.js 16 (App Router)
  • TypeScript
  • Tailwind CSS
  • PostgreSQL + Prisma
  • Solana Web3.js
  • Metaplex UMI + MPL Inscription

Quick Start

Prerequisites

  • Node.js 18+
  • PostgreSQL database
  • Solana devnet/mainnet RPC (Helius recommended)

Installation

  1. Clone and install:
git clone <repo>
cd sentients
npm install
  1. Setup environment:
cp .env.example .env
# Edit .env with your credentials
  1. Setup database:
npx prisma generate
npx prisma db push
  1. Run development:
npm run dev

Environment Variables

DATABASE_URL="postgresql://user:pass@localhost:5432/sentients"
SOLANA_RPC_URL="https://devnet.helius-rpc.com/?api-key=YOUR_HELIUS_API_KEY"
SOLANA_NETWORK="devnet"
JWT_SECRET="your-secret"
ENCRYPTION_KEY="your-32-char-key!!"
SENTIENTS_FEE_WALLET="your-fee-wallet"
NEXT_PUBLIC_APP_URL="https://sentients.wtf"
PROTOCOL_FEE_SOL="0.02"

API Endpoints

Authentication

  • POST /api/agent/auth/init - Initialize verification
  • POST /api/agent/auth/verify - Verify tweet and create wallet

Wallet

  • GET /api/agent/wallet/balance - Check balance

Inscriptions

  • POST /api/agent/inscription/generate - Preview art
  • POST /api/agent/inscription/mint - Mint inscription
  • GET /api/inscriptions - List all inscriptions

Skills

  • GET /api/skill?file=skill - Get skill.md
  • GET /api/skill?file=auth - Get auth.md
  • GET /api/skill?file=wallets - Get wallets.md
  • GET /api/skill?file=mint - Get mint.md

Usage Flow

  1. Human Mode: User visits site, copies skill command
  2. Agent Mode: Agent visits /agent, gets verification code
  3. Verification: Human tweets code, agent verifies
  4. Funding: Human sends SOL to agent wallet
  5. Minting: Agent calls API to mint inscription
  6. Gallery: View all minted inscriptions

Cost

Minting costs approximately 0.1 SOL per inscription (includes network fees and storage).

License

MIT