pandora-cli-skills 1.1.16 → 1.1.17

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +40 -0
  2. package/SKILL.md +7 -1
  3. package/package.json +2 -1
package/README.md ADDED
@@ -0,0 +1,40 @@
1
+ # Pandora CLI & Skills
2
+
3
+ Production CLI for Pandora prediction markets with mirror + hedge tooling.
4
+
5
+ ## Install
6
+
7
+ ```bash
8
+ npm i -g pandora-cli-skills
9
+ pandora --help
10
+ ```
11
+
12
+ Or run without installing:
13
+
14
+ ```bash
15
+ npx pandora-cli-skills@latest --help
16
+ ```
17
+
18
+ ## Core commands
19
+
20
+ - `pandora markets list|get`
21
+ - `pandora quote`
22
+ - `pandora trade`
23
+ - `pandora history`
24
+ - `pandora export`
25
+ - `pandora arbitrage`
26
+ - `pandora autopilot run|once`
27
+ - `pandora mirror browse|plan|deploy|verify|lp-explain|hedge-calc|simulate|go|sync|status|close`
28
+ - `pandora polymarket check|approve|preflight|trade`
29
+
30
+ ## Mirror economics commands
31
+
32
+ - `pandora mirror lp-explain --liquidity-usdc 10000 --source-yes-pct 58`
33
+ - `pandora mirror hedge-calc --reserve-yes-usdc 8 --reserve-no-usdc 12 --excess-no-usdc 2 --polymarket-yes-pct 60`
34
+ - `pandora mirror simulate --liquidity-usdc 10000 --source-yes-pct 58 --target-yes-pct 58 --volume-scenarios 1000,5000,10000`
35
+
36
+ ## Notes
37
+
38
+ - Node.js `>=18` required.
39
+ - Full operational and JSON contract documentation is in
40
+ [`README_FOR_SHARING.md`](./README_FOR_SHARING.md).
package/SKILL.md CHANGED
@@ -45,7 +45,7 @@ npm link
45
45
  - `pandora export`
46
46
  - `pandora arbitrage`
47
47
  - `pandora autopilot run|once`
48
- - `pandora mirror browse|plan|deploy|verify|go|sync|status|close`
48
+ - `pandora mirror browse|plan|deploy|verify|lp-explain|hedge-calc|simulate|go|sync|status|close`
49
49
  - `pandora webhook test`
50
50
  - `pandora leaderboard`
51
51
  - `pandora analyze`
@@ -100,6 +100,9 @@ pandora --output json arbitrage --venues pandora,polymarket --min-spread-pct 3 -
100
100
  pandora --output json autopilot once --market-address <0x...> --side no --amount-usdc 10 --trigger-yes-below 15 --paper
101
101
  pandora --output json mirror browse --min-yes-pct 20 --max-yes-pct 80 --min-volume-24h 100000 --limit 10
102
102
  pandora --output json mirror plan --source polymarket --polymarket-market-id <id> --with-rules --include-similarity
103
+ pandora --output json mirror lp-explain --liquidity-usdc 10000 --source-yes-pct 58
104
+ pandora --output json mirror hedge-calc --reserve-yes-usdc 8 --reserve-no-usdc 12 --excess-no-usdc 2 --polymarket-yes-pct 60
105
+ pandora --output json mirror simulate --liquidity-usdc 10000 --source-yes-pct 58 --target-yes-pct 58 --volume-scenarios 1000,5000,10000
103
106
  pandora --output json mirror go --polymarket-slug <slug> --liquidity-usdc 10 --paper
104
107
  pandora --output json mirror verify --pandora-market-address <0x...> --polymarket-market-id <id> --include-similarity
105
108
  pandora --output json mirror sync once --pandora-market-address <0x...> --polymarket-market-id <id> --paper --hedge-ratio 1.0
@@ -168,6 +171,9 @@ pandora --output json suggest --wallet <0x...> --risk medium --budget 50 --inclu
168
171
  - `mirror browse`: Polymarket candidate discovery with optional Pandora mirror hints.
169
172
  - `mirror deploy`: dry-run/execute Pandora AMM deployment from mirror plan inputs, with execute-time wallet preflight and trust-manifest persistence.
170
173
  - `mirror verify`: explicit question/rules similarity endpoint for AI-subagent validation, with optional `--trust-deploy` manifest bypass for similarity.
174
+ - `mirror lp-explain`: complete-set liquidity walkthrough (minted YES/NO, seeded pool reserves, returned excess inventory).
175
+ - `mirror hedge-calc`: reserve/excess-driven hedge sizing (`deltaTotalUsdc`, target hedge leg, break-even volume).
176
+ - `mirror simulate`: planning-grade LP + hedge scenario simulation with customizable `--volume-scenarios`.
171
177
  - `mirror go`: one-command orchestration for plan → deploy → verify, with optional auto-sync start.
172
178
  - `mirror sync`: paper-first delta-neutral loop with strict gates, state persistence, and optional live hedging (`--hedge-ratio <n>`, `--no-hedge`).
173
179
  - live hedge env: `POLYMARKET_PRIVATE_KEY`, `POLYMARKET_FUNDER`, `POLYMARKET_API_KEY`, `POLYMARKET_API_SECRET`, `POLYMARKET_API_PASSPHRASE`, `POLYMARKET_HOST`.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "pandora-cli-skills",
3
- "version": "1.1.16",
3
+ "version": "1.1.17",
4
4
  "description": "Pandora CLI & Skills",
5
5
  "main": "cli/pandora.cjs",
6
6
  "bin": {
@@ -16,6 +16,7 @@
16
16
  "references/contracts.md",
17
17
  "references/creation-script.md",
18
18
  "SKILL.md",
19
+ "README.md",
19
20
  "README_FOR_SHARING.md",
20
21
  "tsconfig.json"
21
22
  ],