@ape-church/skill 1.0.0 → 1.0.2

package/README.md

@@ -0,0 +1,107 @@
+# @ape-church/skill
+
+Autonomous gambling agent skill for [Ape Church](https://ape.church) on ApeChain.
+
+Let your AI agent play casino games, manage its bankroll, and gamble autonomously.
+
+## Quick Start
+
+```bash
+# Install globally
+npm install -g @ape-church/skill
+
+# Setup (generates wallet, registers username)
+apechurch install
+
+# Fund the printed address with APE on ApeChain
+# Bridge: https://relay.link/bridge/apechain
+
+# Check status
+apechurch status
+
+# Start autonomous play
+apechurch heartbeat --strategy balanced
+```
+
+## Games
+
+| Game | Type | Controls |
+|------|------|----------|
+| Jungle Plinko | Plinko | `--mode 0-4` `--balls 1-100` |
+| Dino Dough | Slots | `--spins 1-15` |
+| Bubblegum Heist | Slots | `--spins 1-15` |
+
+## Commands
+
+```bash
+apechurch install [--username NAME] [--persona TYPE]  # Setup
+apechurch status [--json]                              # Check balance
+apechurch heartbeat [--strategy TYPE]                  # Autonomous play
+apechurch bet --game NAME --amount APE [options]       # Manual bet
+apechurch pause                                        # Stop autonomous play
+apechurch resume                                       # Resume autonomous play
+apechurch register --username NAME                     # Change username
+apechurch profile show                                 # View profile
+apechurch profile set --persona TYPE                   # Set strategy
+```
+
+## Strategies
+
+| Profile | Bet Size | Cooldown | Risk |
+|---------|----------|----------|------|
+| `conservative` | 5% | 60s | Low |
+| `balanced` | 8% | 30s | Medium |
+| `aggressive` | 12% | 15s | High |
+| `degen` | 20% | 10s | Extreme |
+
+## How It Works
+
+1. **Install** creates a self-sovereign wallet at `~/.apechurch-wallet.json`
+2. **Human funds** the wallet with APE on ApeChain
+3. **Heartbeat** runs on a schedule (cron), placing bets autonomously
+4. Agent tracks wins/losses in `~/.apechurch/state.json`
+5. **Pause/Resume** to control when the agent plays
+
+## Safety
+
+- Always keeps 1 APE reserved for gas
+- Never bets more than strategy's max percentage
+- Stops automatically when balance is too low
+- Dynamic cooldowns: slower after losses, faster on win streaks
+
+## For Agent Frameworks
+
+This skill is designed for autonomous AI agents. Add to your agent's cron:
+
+```yaml
+cron:
+  - schedule: "* * * * *"
+    task: "apechurch heartbeat --strategy balanced --json"
+```
+
+The agent will:
+- Check balance and respect cooldowns
+- Choose a game based on strategy
+- Place one bet per heartbeat
+- Report results in JSON
+
+## Docs
+
+- [SKILL.md](https://ape.church/skill.md) — Full documentation
+- [HEARTBEAT.md](https://ape.church/heartbeat.md) — Autonomous play rules  
+- [STRATEGY.md](https://ape.church/strategy.md) — Bankroll management
+
+## Requirements
+
+- Node.js >= 18
+- APE on ApeChain (for gas + wagers)
+
+## Links
+
+- Website: https://ape.church
+- Games: https://ape.church/games
+- Bridge APE: https://relay.link/bridge/apechain
+
+## License
+
+ISC

package/SKILL.md

@@ -162,10 +162,6 @@ Run `apechurch status --json` to fetch:
   - `https://www.ape.church/games/dino-dough?id=<gameId>`
   - `https://www.ape.church/games/bubblegum-heist?id=<gameId>`
 
-## Required Env (Optional)
-- `APECHAIN_RPC_URL` for HTTP RPC (recommended).
-- `APECHAIN_WSS_URL` for WebSocket event streaming (preferred for fast events).
-
 ## Hosted Docs (Reference)
 - `https://ape.church/skill.md`
 - `https://ape.church/heartbeat.md`

package/agent_nodes.md

@@ -97,7 +97,7 @@ WHAT'S LEFT BEFORE GO-LIVE
 HIGH PRIORITY
 - Refactor game definitions into a registry so adding games is data-only. (DONE - registry.js)
 - Registry updates are shipped inside package (Option A). New games require package update.
-- Confirm ApeChain RPC defaults and recommended env variables.
+- ✅ ApeChain RPC uses viem defaults (no env vars needed).
 - Ensure package install + register flow works end-to-end with API.
 
 MEDIUM PRIORITY (POST-LAUNCH)

package/assets/SKILL.md

@@ -162,10 +162,6 @@ Run `apechurch status --json` to fetch:
   - `https://www.ape.church/games/dino-dough?id=<gameId>`
   - `https://www.ape.church/games/bubblegum-heist?id=<gameId>`
 
-## Required Env (Optional)
-- `APECHAIN_RPC_URL` for HTTP RPC (recommended).
-- `APECHAIN_WSS_URL` for WebSocket event streaming (preferred for fast events).
-
 ## Hosted Docs (Reference)
 - `https://ape.church/skill.md`
 - `https://ape.church/heartbeat.md`

package/bin/cli.js

@@ -11,7 +11,6 @@ import {
   formatEther,
   http,
   parseEther,
-  webSocket,
 } from 'viem';
 import { privateKeyToAccount, generatePrivateKey } from 'viem/accounts';
 import { apechain } from 'viem/chains';
@@ -103,23 +102,10 @@ function getWallet() {
   return privateKeyToAccount(data.privateKey);
 }
 
-function getRpcUrl() {
-  if (process.env.APECHAIN_RPC_URL) return process.env.APECHAIN_RPC_URL;
-  if (apechain?.rpcUrls?.default?.http?.[0]) return apechain.rpcUrls.default.http[0];
-  if (apechain?.rpcUrls?.public?.http?.[0]) return apechain.rpcUrls.public.http[0];
-  return null;
-}
-
 function getTransport() {
-  if (process.env.APECHAIN_WSS_URL) {
-    return webSocket(process.env.APECHAIN_WSS_URL);
-  }
-  const rpcUrl = getRpcUrl();
-  if (!rpcUrl) {
-    console.error(JSON.stringify({ error: 'Missing APECHAIN_RPC_URL for HTTP transport.' }));
-    process.exit(1);
-  }
-  return http(rpcUrl);
+  // Use viem's built-in ApeChain RPC (https://rpc.apechain.com/http)
+  // HTTP transport works for everything including event polling
+  return http();
 }
 
 function createClients(account) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ape-church/skill",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Autonomous agent skill for Ape Church on ApeChain.",
   "main": "index.js",
   "scripts": {
@@ -13,7 +13,15 @@
   "engines": {
     "node": ">=18"
   },
-  "keywords": ["openclaw", "agent", "casino", "apechain", "ape", "church", "apechurch"],
+  "keywords": [
+    "openclaw",
+    "agent",
+    "casino",
+    "apechain",
+    "ape",
+    "church",
+    "apechurch"
+  ],
   "author": "",
   "license": "ISC",
   "dependencies": {