Telegram Bot

@inkdbot is the simplest way to use inkd. No SDK, no CLI, no terminal.

Send a file or text. Choose public or private. Done — stored forever on Arweave, registered on Base, paid in USDC.

Home screen

Every time you open the bot you see:

⬆️ Upload a File
💼 Wallet     📁 My Files
❓ Help        🎓 Tutorial

Upload flow

Tap ⬆️ Upload a File — or just send a file, photo, or video directly
Choose: file, text, or GitHub repo
Enter a name + optional description (text/file only)
Choose visibility: 🌍 Public or 🔒 Only me
Confirm cost → USDC deducted automatically
Done — Arweave hash + Basescan link returned

Commands

Command	Description
`/start`	Home screen
`/wallet`	Address, ETH + USDC balance, QR code for deposits
`/upload_text`	Upload text or notes
`/upload_repo`	Archive a GitHub repo
`/my_projects`	Browse your projects
`/history`	Recent uploads with share links
`/search <name>`	Search public projects
`/top`	Trending public projects
`/estimate <size>`	Calculate cost before uploading
`/export_key`	Export private key (bot wallets)
`/tutorial`	4-step onboarding
`/links`	Website, socials, buy $INKD
`/cancel`	Cancel current action
`/help`	Full command reference

GitHub Repo

Send a username or profile link — the bot lists all public repos as buttons. Tap one to upload it directly.

inkdprotocol             → lists repos
github.com/inkdprotocol  → also works
owner/repo               → direct upload

Public vs Private

🌍 Public — anyone with the Arweave link can view it
🔒 Only me — AES-256-GCM encrypted before upload. Key derived from your wallet private key (sha256(key + "inkd-private-v1")). Only your wallet can decrypt.

For private projects, the project detail view shows a 🔓 View Content button. Tap it to decrypt and retrieve your content directly in the chat.

See Private Uploads for the full security model.

Cost Estimator

Not sure what something will cost? Use /estimate before uploading:

/estimate 500kb   → $0.10 USDC
/estimate 4mb     → $0.14 USDC
/estimate 100mb   → $1.83 USDC

Exact cost is always shown before you confirm. No surprises.

Agent Notifications

The bot watches your wallet balance in the background. When USDC arrives, you get notified instantly with a direct deposit confirmation and upload button. No polling needed — push notifications are sent as soon as a transfer is detected on Base.

Pricing

Action	Cost
Store file / text	from $0.10 USDC
Store GitHub repo	Arweave cost × 1.20 (min $0.10)

Wallet

The bot creates and manages a wallet for you. Your private key is stored AES-256-GCM encrypted — only you can export it via /export_key.

Fund it: send USDC (and a small amount of ETH for gas) on Base to your wallet address. Tap 💰 Add Funds to see your address with a scannable QR code.

Export Key

Need to use your wallet elsewhere? Use /export_key or tap 🔑 Export Key in the wallet menu. You'll see a security warning before the key is revealed — make sure to store it safely and delete the message after saving.

Hide / Archive Projects

Don't want to see a project in your file list anymore? Each project detail view has a 🙈 Hide button. Hidden projects move to the 📦 Archived section in My Files.

To restore a hidden project, open 📦 Archived and tap the project to unhide it. This is purely cosmetic — the on-chain data is never affected.

Share on X

After a successful upload, you'll see a Share on 𝕏 button. Tap it to post your upload directly to Twitter/X with a pre-filled message including the Arweave link.

Inline mode

Search projects from any Telegram chat: type @inkdbot <project name> anywhere.