[CI/CD] add cd

.github/workflows/ci.yml

@@ -0,0 +1,34 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 10.24.0
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'pnpm'
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Typecheck
+        run: pnpm codecheck
+
+      - name: Prettier
+        run: pnpm prettier
+
+      - name: Lint
+        run: pnpm lint

.github/workflows/publish-coinfello-skill.yml

@@ -0,0 +1,45 @@
+name: Publish Coinfello Skill
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'coinfello/**'
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install clawhub CLI
+        run: npm i -g clawhub
+
+      - name: Extract version
+        run: echo "VERSION=$(node -p "require('./package.json').version")" >> $GITHUB_ENV
+
+      - name: Generate changelog
+        run: |
+          PREV_TAG=$(git describe --tags --abbrev=0 2>/dev/null || echo "")
+          if [ -n "$PREV_TAG" ]; then
+            CHANGELOG=$(git log "${PREV_TAG}..HEAD" --oneline --no-merges | head -20 | tr '\n' '; ')
+          else
+            CHANGELOG="Release v${VERSION}"
+          fi
+          echo "CHANGELOG=${CHANGELOG}" >> $GITHUB_ENV
+
+      - name: Publish coinfello skill to ClawHub
+        env:
+          CLAWHUB_TOKEN: ${{ secrets.CLAWHUB_TOKEN }}
+        run: |
+          clawhub publish ./coinfello \
+            --slug coinfello \
+            --name "CoinFello" \
+            --version "$VERSION" \
+            --changelog "$CHANGELOG"

.github/workflows/publish.yml

@@ -0,0 +1,56 @@
+name: Publish @coinfello/agent-cli
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write  # enables npm provenance
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 10.24.0
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
+          cache: 'pnpm'
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Typecheck
+        run: pnpm codecheck
+
+      - name: Build
+        run: pnpm build
+
+      - name: Check if version is already published
+        id: version_check
+        run: |
+          PKG_VERSION=$(node -p "require('./package.json').version")
+          PKG_NAME=$(node -p "require('./package.json').name")
+          echo "version=${PKG_VERSION}" >> $GITHUB_OUTPUT
+          if npm view "${PKG_NAME}@${PKG_VERSION}" version 2>/dev/null | grep -q "${PKG_VERSION}"; then
+            echo "already_published=true" >> $GITHUB_OUTPUT
+          else
+            echo "already_published=false" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Publish to npm
+        if: steps.version_check.outputs.already_published == 'false'
+        run: pnpm publish --no-git-checks
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Skip publish (version already exists)
+        if: steps.version_check.outputs.already_published == 'true'
+        run: echo "Version ${{ steps.version_check.outputs.version }} already published. Skipping."

.prettierrc

@@ -0,0 +1,7 @@
+{
+  "semi": false,
+  "singleQuote": true,
+  "tabWidth": 2,
+  "trailingComma": "es5",
+  "printWidth": 100
+}

.vscode/settings.json

@@ -0,0 +1,12 @@
+{
+  "editor.bracketPairColorization.enabled": true,
+  "prettier.configPath": "${fileDirname}/../.prettierrc.json",
+  "editor.formatOnSave": true,
+  "editor.defaultFormatter": "esbenp.prettier-vscode",
+  "[javascript]": {
+    "editor.formatOnSave": true
+  },
+  "[typescript]": {
+    "editor.formatOnSave": true
+  }
+}

LICENSE.md

@@ -0,0 +1 @@
+© 2026 HyperPlay Labs, Inc. - All Rights Reserved.

coinfello/SKILL.md

@@ -0,0 +1,161 @@
+---
+name: coinfello
+description: 'Interact with CoinFello using the openclaw CLI to create MetaMask smart accounts, manage delegations, send prompts with ERC-20 token subdelegations, and check transaction status. Use when the user wants to send crypto transactions via natural language prompts, manage smart account delegations, or check CoinFello transaction results.'
+compatibility: Requires Node.js 20+ and pnpm.
+metadata:
+  {
+    'clawdbot':
+      { 'emoji': '👋', 'homepage': 'https://coinfello.com', 'requires': { 'bins': ['node'] } },
+  }
+---
+
+# CoinFello CLI Skill
+
+Use the `openclaw` CLI to interact with CoinFello through MetaMask Smart Accounts. The CLI handles smart account creation, delegation management, prompt-based ERC-20 token transactions, and transaction status checks.
+
+## Prerequisites
+
+- Node.js 20 or later
+- pnpm package manager
+- Build the CLI before first use: `pnpm build`
+
+The CLI binary is available at `./dist/index.js` after building, or as `openclaw` if installed globally.
+
+## Quick Start
+
+```bash
+# 1. Create a smart account on a chain (generates a new private key automatically)
+openclaw create_account sepolia
+
+# 2. Send a prompt with token subdelegation
+openclaw send_prompt "swap 5 USDC for ETH" \
+  --token-address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 \
+  --amount 5 \
+  --decimals 6
+
+# 3. Check transaction status
+openclaw get_transaction_status <txn_id>
+```
+
+## Commands
+
+### create_account
+
+Creates a MetaMask Hybrid smart account with an auto-generated private key and saves it to local config.
+
+```bash
+openclaw create_account <chain>
+```
+
+- `<chain>` — A viem chain name: `sepolia`, `mainnet`, `polygon`, `arbitrum`, `optimism`, `base`, etc.
+- Generates a new private key automatically
+- Saves `private_key`, `smart_account_address`, and `chain` to `~/.clawdbot/skills/coinfello/config.json`
+- Must be run before `send_prompt`
+
+### get_account
+
+Displays the current smart account address from local config.
+
+```bash
+openclaw get_account
+```
+
+- Prints the stored `smart_account_address`
+- Exits with an error if no account has been created yet
+
+### set_delegation
+
+Stores a signed parent delegation (JSON) in local config for use with redelegation flows.
+
+```bash
+openclaw set_delegation '<delegation-json>'
+```
+
+- `<delegation-json>` — A JSON string representing a `Delegation` object from MetaMask Smart Accounts Kit
+- Only needed if you plan to use `--use-redelegation` with `send_prompt`
+
+### send_prompt
+
+Sends a natural language prompt to CoinFello with a locally-created and signed ERC-20 token subdelegation.
+
+```bash
+openclaw send_prompt "<prompt>" \
+  --token-address <erc20-address> \
+  --amount <amount> \
+  [--decimals <n>] \
+  [--use-redelegation]
+```
+
+**Required options:**
+
+- `--token-address <address>` — ERC-20 token contract address for the subdelegation scope
+- `--amount <amount>` — Maximum token amount in human-readable form (e.g. `5`, `100.5`)
+
+**Optional:**
+
+- `--decimals <n>` — Token decimals for parsing `--amount` (default: `18`)
+- `--use-redelegation` — Create a redelegation from a stored parent delegation (requires `set_delegation` first)
+
+**What happens internally:**
+
+1. Fetches CoinFello's delegate address from the API
+2. Rebuilds the smart account from the stored private key and chain in config
+3. Creates a subdelegation scoped to `erc20TransferAmount` with the specified token and max amount
+4. Signs the subdelegation with the smart account
+5. Sends the prompt + signed subdelegation to CoinFello's conversation endpoint
+6. Returns a `txn_id` for tracking
+
+### get_transaction_status
+
+Checks the status of a previously submitted transaction.
+
+```bash
+openclaw get_transaction_status <txn_id>
+```
+
+- Returns a JSON object with the current transaction status
+
+## Common Workflows
+
+### Basic: Send a Token Transfer Prompt
+
+```bash
+# Create account if not already done
+openclaw create_account sepolia
+
+# Send prompt to transfer up to 10 USDC
+openclaw send_prompt "send 5 USDC to 0xRecipient..." \
+  --token-address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 \
+  --amount 10 \
+  --decimals 6
+
+# Check the result
+openclaw get_transaction_status <txn_id-from-above>
+```
+
+### With Redelegation
+
+Use this when you have a parent delegation from another delegator and want to create a subdelegation chain.
+
+```bash
+# Store the parent delegation
+openclaw set_delegation '{"delegate":"0x...","delegator":"0x...","authority":"0x...","caveats":[],"salt":"0x...","signature":"0x..."}'
+
+# Send with redelegation
+openclaw send_prompt "swap tokens" \
+  --token-address 0xTokenAddress \
+  --amount 100 \
+  --use-redelegation
+```
+
+## Edge Cases
+
+- **No smart account**: Run `create_account` before `send_prompt`. The CLI checks for a saved private key and address in config.
+- **Invalid chain name**: The CLI throws an error listing valid viem chain names.
+- **Missing parent delegation with --use-redelegation**: The CLI exits with an error. Run `set_delegation` first.
+
+## Reference
+
+See [references/REFERENCE.md](references/REFERENCE.md) for the full config schema, supported chains, API details, and troubleshooting.
+
+See [scripts/setup-and-send.sh](scripts/setup-and-send.sh) for an end-to-end automation script.