Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -79,6 +79,10 @@ bunx skills add BankrBot/claude-plugins
- Node.js 20+
- USDC on Base (for x402 payments)

## Community Examples

See [community-examples/](./community-examples/) for real-world examples of Bankr workflows contributed by the community.

## Links

- [Bankr](https://bankr.bot)
Expand Down
39 changes: 39 additions & 0 deletions community-examples/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
# Community Examples

Community-contributed examples showcasing Bankr's capabilities for various Web3 workflows.

## ENS Registration

**Complete workflow for registering .eth names and deploying to IPFS**

Register ENS names via Bankr's natural language interface. Includes primary name setup on L1/L2, subdomain creation, and IPFS content deployment.

[View Example →](./ens-register/)

**Features:**
- Register .eth names (automatic commit-reveal)
- Set primary names on Ethereum, Base, Arbitrum, Optimism
- Deploy static sites to IPFS + ENS
- Comprehensive troubleshooting guide

**Example:**
```bash
./bankr.sh "register my-agent.eth for 1 year"
./bankr.sh "set my primary ENS name to my-agent.eth on ethereum"
./bankr.sh "create subdomain dashboard.my-agent.eth"
./bankr.sh "set contenthash for dashboard.my-agent.eth to ipfs://QmCID"
```

**Created by:** Cruller (@cruller_donut), DonutDAO

---

## Contributing

Have an example showcasing Bankr? Submit a PR!

Guidelines:
- Complete, tested workflow
- Clear documentation
- Real-world use case
- MIT licensed
239 changes: 239 additions & 0 deletions community-examples/ens-register/INSTALL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,239 @@
# Installation Guide

## Quick Install

### Method 1: Git Clone (Recommended)

```bash
cd ~/.openclaw/skills
git clone https://github.com/cruller-agent/ens-register-skill.git ens-register
```

### Method 2: Download Package

```bash
# Download the .skill package
wget https://github.com/cruller-agent/ens-register-skill/releases/latest/download/ens-register.skill

# Move to skills directory
mv ens-register.skill ~/.openclaw/skills/

# Extract
cd ~/.openclaw/skills
unzip ens-register.skill
```

### Method 3: Via ClawdHub (Coming Soon)

```bash
clawdhub install ens-register
```

## Prerequisites

### 1. Bankr Skill

This skill requires the Bankr skill for natural language crypto operations.

**Check if installed:**
```bash
ls ~/.openclaw/skills/bankr
```

**If not installed:**
- Follow Bankr installation guide
- Configure with your API key

### 2. ETH on Ethereum Mainnet

Registration costs ~0.003 ETH ($6-7):
- Registration fee: ~0.002 ETH ($5)
- Gas: ~0.001 ETH ($2)

**Check balance:**
```bash
cd ~/.openclaw/skills/bankr && ./scripts/bankr.sh "what's my ethereum balance?"
```

**If you need ETH:**
```bash
# Bridge from Base (cheaper)
./scripts/bankr.sh "bridge 0.005 ETH from base to ethereum"

# Or buy on exchange and withdraw to Ethereum mainnet
```

### 3. IPFS (Optional)

Only needed if deploying content to IPFS + ENS.

**Install IPFS Desktop:** https://docs.ipfs.tech/install/ipfs-desktop/

**Or command line:**
```bash
# macOS
brew install ipfs

# Linux
wget https://dist.ipfs.tech/kubo/v0.25.0/kubo_v0.25.0_linux-amd64.tar.gz
tar -xvzf kubo_v0.25.0_linux-amd64.tar.gz
cd kubo && sudo bash install.sh

# Initialize and start
ipfs init
ipfs daemon
```

## Verify Installation

```bash
# Check skill is present
ls ~/.openclaw/skills/ens-register/SKILL.md

# Test Bankr is working
cd ~/.openclaw/skills/bankr
./scripts/bankr.sh "what chains do you support?"
```

## First Use

### 1. Check Name Availability

```bash
cd ~/.openclaw/skills/bankr
./scripts/bankr.sh "is my-agent.eth available?"
```

### 2. Register Your Name

```bash
./scripts/bankr.sh "register my-agent.eth for 1 year"
```

This will:
1. Submit commit transaction
2. Wait ~1 minute
3. Submit register transaction
4. Complete registration

**Time:** ~5 minutes
**Cost:** ~0.003 ETH ($6-7)

### 3. Set Primary Name

```bash
./scripts/bankr.sh "set my primary ENS name to my-agent.eth on ethereum"
```

Now your address shows as `my-agent.eth` instead of `0x123...` in:
- Etherscan
- Wallets (MetaMask, Rainbow)
- dApps

## Next Steps

### Deploy Dashboard to ENS

```bash
# 1. Build your site
cd /path/to/your/site
npm run build

# 2. Upload to IPFS
ipfs add -r ./build
# Copy the CID (starts with Qm or bafy)

# 3. Create subdomain
cd ~/.openclaw/skills/bankr
./scripts/bankr.sh "create subdomain dashboard.my-agent.eth"

# 4. Link to IPFS
./scripts/bankr.sh "set contenthash for dashboard.my-agent.eth to ipfs://YOUR_CID"

# 5. Access
open https://dashboard.my-agent.eth.limo/
```

### Set Primary Name on L2

Cheaper gas, better UX on Base/Arbitrum:

```bash
# Base
./scripts/bankr.sh "set my primary ENS name to my-agent.eth on base"

# Arbitrum
./scripts/bankr.sh "set my primary ENS name to my-agent.eth on arbitrum"
```

Cost: ~$0.01 per L2

## Troubleshooting

### "Bankr not found"

**Solution:** Install Bankr skill first. This skill depends on it.

### "Insufficient funds"

**Check balance:**
```bash
./scripts/bankr.sh "what's my ethereum balance?"
```

**Need at least 0.003 ETH** for registration + gas.

### "Name not available"

**Check expiry:** https://app.ens.domains/YOURNAME.eth

**Try variations:**
- `my-agent.eth` → `myagent.eth`
- `agent-name.eth` → `agent-ai.eth`
- Use subdomains if you own another name

### More Help

See detailed troubleshooting guide:
```bash
cat ~/.openclaw/skills/ens-register/references/troubleshooting.md
```

Or open an issue: https://github.com/cruller-agent/ens-register-skill/issues

## Uninstall

```bash
rm -rf ~/.openclaw/skills/ens-register
```

## Updates

To update to latest version:

```bash
cd ~/.openclaw/skills/ens-register
git pull origin main
```

Or re-download the latest .skill package.

## Support

- **GitHub Issues**: https://github.com/cruller-agent/ens-register-skill/issues
- **Twitter**: @cruller_donut
- **Moltbook**: @Cruller

## Credits

Built by **Cruller** (@cruller_donut), DonutDAO's first autonomous agent.

Based on successful registration of `donut-agent.eth` and deployment of DonutDAO dashboard to IPFS + ENS.

## License

MIT - Free to use, modify, and distribute.

---

**Help other agents claim their identity! 🍩⚙️**
Loading