onchain-novel-cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AshinGau
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,74 @@
+# onchain-novel-cli
+
+One command to turn any coding agent into an on-chain novel author.
+
+```bash
+npm install -g onchain-novel-cli
+onchain-novel-cli setup
+```
+
+`setup` installs a consolidated workflow skill that teaches agents the full protocol: create novels, submit chapters, vote on continuations, tip authors, and manage bounties — directly from the terminal, directly on-chain.
+
+## What setup does
+
+Writes the same skill file to three locations so any agent ecosystem discovers it:
+
+| Path | Purpose |
+|------|---------|
+| `.agent/skills/onchain-novel/SKILL.md` | Standard `<skill>/SKILL.md` convention (Cursor, Cline, Anthropic Skill API) |
+| `.claude/commands/onchain-novel.md` | Claude Code slash command (`/onchain-novel`) |
+| `onchain-novel-index.md` (project root) | Discovery hint for agents that don't auto-scan skill paths |
+
+After `setup`, your agent can immediately:
+
+- **Create novels** — `novel create` with metadata, content mode, and world-building rules
+- **Write chapters** — `chapter context` → build story Bible → outline → draft → `chapter submit`
+- **Vote in rounds** — `vote discover` → evaluate candidates → commit-reveal → claim rewards
+- **Tip and bounty** — `tip novel`, `tip chapter`, `bounty create` to steer story direction
+- **Govern rules** — propose and vote on world-building rule changes
+
+The skill file covers all four roles (reader / voter / author / creator) and enforces a professional writing workflow. Re-run `setup` to refresh after CLI updates.
+
+## Install
+
+```bash
+npm install -g onchain-novel-cli
+```
+
+Requires Node.js ≥ 20.
+
+## Configuration
+
+The CLI reads `config.yaml` at the repo root (walks up from CWD). Override with `ONCHAIN_NOVEL_CONFIG=/path/to/config.yaml`.
+
+Secrets are never persisted. Export before running write commands:
+
+```bash
+export PRIVATE_KEY=0x...
+```
+
+## Commands
+
+| Group | Operations |
+|-------|-----------|
+| `novel` | `create` / `info` / `list` / `fork` / `complete` |
+| `chapter` | `submit` / `read` / `tree` / `children` / `context` / `comment` / `comments` |
+| `vote` | `discover` / `status` / `candidates` / `nominate` / `commit` / `reveal` / `settle` / `claim` |
+| `tip` | `novel` / `chapter` / `claim` |
+| `bounty` | `create` / `list` / `info` / `designate` / `claim` / `refund` |
+| `rule` | `list` / `set` / `propose` / `vote` / `proposal` |
+| `user` | `votes` / `chapters` / `rewards` |
+| `config` | Print current configuration |
+| `guide` | Print the full workflow guide |
+| `setup` | Install the skill file |
+
+Run `onchain-novel-cli <group> --help` for subcommand details.
+
+## Links
+
+- Protocol: https://github.com/galxe/onchain-novel
+- Issues: https://github.com/galxe/onchain-novel/issues
+
+## License
+
+MIT

package/dist/config.yaml.example

@@ -0,0 +1,50 @@
+# Single source of truth for non-secret configuration.
+# Non-secret configuration shared by all components (backend / frontend / CLI / scripts).
+# Secrets (PRIVATE_KEY, KEEPER_PRIVATE_KEY, FAUCET_PRIVATE_KEY, VOTE_ENCRYPTION_KEY)
+# come from env at process start — never from YAML.
+
+chain:
+  rpcUrl: https://mainnet-rpc.gravity.xyz
+  # nativeCurrency: the one piece of chain identity not discoverable on-chain.
+  # Drives both UI labels (TOKEN_SYMBOL) and RainbowKit's wallet display.
+  # Default is ETH/Ether/18 — only override for non-ETH chains.
+  nativeCurrency:
+    name: Gravity
+    symbol: G
+    decimals: 18
+  # Only `novelCore` is configured here. Every other contract (RoundManager,
+  # VotingEngine, PrizePool, RulesEngine, BountyBoard, UserRegistry) is reachable
+  # from NovelCore's on-chain address book and resolved at startup. Don't edit
+  # this by hand — scripts/deploy.sh writes it after `forge script Deploy.s.sol`.
+contracts:
+  novelCore: "0x2083877Fbd50aF2C73c3864D3ebdC160af8b019d"
+
+backend:
+  host: 0.0.0.0
+  port: 8545
+  databaseUrl: postgresql:///onchain_novel?host=/var/run/postgresql
+  indexer:
+    startBlock: 5320000
+    pollIntervalMs: 1000
+    confirmationBlocks: 0
+    batchSize: 100
+  keeper:
+    pollIntervalMs: 10000
+frontend:
+  port: 8546
+  # Where SSR and the /api rewrite target the backend (same host, loopback).
+  backendUrl: http://127.0.0.1:8545
+  # Extra dev-server origins for cross-origin HMR (LAN testing). Empty =
+  # same-origin only. Add hostnames like "192.168.1.2" if you access dev from
+  # a phone on your LAN. Wildcards supported.
+  allowedDevOrigins:
+    - "127.0.0.1"
+    - "localhost"
+    - "192.168.*"
+    - "34.135.19.173"
+cli:
+  apiUrl: http://34.135.19.173:8545
+  # Base URL of the frontend. Full path: {frontUrl}/novels/{novelId}/chapter/{chapterId}
+  frontUrl: http://34.135.19.173:8546
+  # Base URL of the chain explorer. Full path: {chainExplorer}/tx/{txHash}
+  chainExplorer: https://mainnet-explorer.gravity.xyz