feat: add wallet import flow and release automation

Author: kitakitsune0x

.changeset/README.md

@@ -0,0 +1,5 @@
+# Changesets
+
+This directory stores release notes and semver intent for pending changes.
+
+Run `pnpm changeset` after making a user-visible change, then commit the generated markdown file with the code change.

.changeset/config.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://unpkg.com/@changesets/config@3.0.3/schema.json",
+  "changelog": false,
+  "commit": false,
+  "fixed": [],
+  "linked": [],
+  "access": "public",
+  "baseBranch": "main",
+  "updateInternalDependencies": "patch",
+  "ignore": []
+}

.changeset/release-automation-bootstrap.md

@@ -0,0 +1,5 @@
+---
+"solana-agent-wallet-ops": minor
+---
+
+Add wallet import and storage cleanup work, tighten the CLI structure, and introduce automated version PRs plus GitHub releases.

.github/workflows/ci.yml

@@ -0,0 +1,35 @@
+name: CI
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 8.15.1
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Build
+        run: pnpm build
+
+      - name: Test
+        run: pnpm test

.github/workflows/github-release.yml

@@ -0,0 +1,64 @@
+name: GitHub Release
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - package.json
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Read package versions
+        id: package
+        run: |
+          CURRENT_VERSION=$(node -e "console.log(JSON.parse(require('node:fs').readFileSync('package.json', 'utf8')).version)")
+          PREVIOUS_VERSION=$(git show "${{ github.event.before }}:package.json" 2>/dev/null | node -e "const fs = require('node:fs'); const input = fs.readFileSync(0, 'utf8').trim(); console.log(input ? JSON.parse(input).version : '');" || true)
+          echo "current=$CURRENT_VERSION" >> "$GITHUB_OUTPUT"
+          echo "previous=$PREVIOUS_VERSION" >> "$GITHUB_OUTPUT"
+
+      - name: Fetch tags
+        run: git fetch --tags --force
+
+      - name: Check for version bump
+        id: version
+        run: |
+          if [ "${{ steps.package.outputs.current }}" = "${{ steps.package.outputs.previous }}" ]; then
+            echo "changed=false" >> "$GITHUB_OUTPUT"
+          else
+            echo "changed=true" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Check for existing tag
+        id: tag
+        if: steps.version.outputs.changed == 'true'
+        run: |
+          if git rev-parse "v${{ steps.package.outputs.current }}" >/dev/null 2>&1; then
+            echo "exists=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "exists=false" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Create tag
+        if: steps.version.outputs.changed == 'true' && steps.tag.outputs.exists == 'false'
+        run: |
+          git tag "v${{ steps.package.outputs.current }}"
+          git push origin "v${{ steps.package.outputs.current }}"
+
+      - name: Publish GitHub release
+        if: steps.version.outputs.changed == 'true' && steps.tag.outputs.exists == 'false'
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: v${{ steps.package.outputs.current }}
+          generate_release_notes: true

.github/workflows/version-packages.yml

@@ -0,0 +1,44 @@
+name: Version Packages
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  version:
+    if: github.actor != 'github-actions[bot]'
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 8.15.1
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Create or update version PR
+        uses: changesets/action@v1
+        with:
+          version: pnpm release:version
+          commit: "chore: version packages"
+          title: "chore: version packages"
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -1,6 +1,8 @@
 node_modules
 dist
 .DS_Store
+.agents
+.pnpm-store
 *.log
 exports
 data/wallet-sets/

README.md

@@ -14,6 +14,7 @@ This is not a consumer wallet app, not a GUI, and not tied to a single host such
 ## Features
 
 - Bulk create Solana wallets and save them as named wallet sets
+- Import wallet JSON into local wallet-set storage
 - List wallet sets or inspect wallets inside a set
 - Store wallet sets in local SQLite with indexed lookups
 - Check balances in bulk
@@ -47,6 +48,56 @@ Optional local build:
 pnpm build
 ```
 
+## Releases
+
+This repo now has GitHub-backed release automation with Changesets.
+
+Local release workflow:
+
+1. Run `pnpm changeset` for any user-visible change.
+2. Commit the generated file in `.changeset/` with the code change.
+3. Merge to `main`.
+4. GitHub Actions opens or updates a `chore: version packages` PR.
+5. After that PR is merged, GitHub Actions tags `v<version>` and creates a GitHub Release.
+
+Useful commands:
+
+```bash
+pnpm changeset
+pnpm release:status
+pnpm release:version
+```
+
+## Agent Skill
+
+This repo now exposes the repository root as the skill package for GitHub distribution:
+
+```text
+SKILL.md
+agents/openai.yml
+```
+
+That root-level skill is meant for Codex-style agents that need a safe, repeatable workflow for:
+
+- creating wallet sets
+- inspecting balances
+- exporting public addresses
+- previewing and executing SOL or SPL batch transfers
+- running SplitNOW quote, order, and status flows
+
+The skill points agents at the existing repo docs instead of copying them. It also bakes in the important operational rules:
+
+- keep wallet DBs and API keys outside the repo
+- use `devnet` by default unless the user explicitly wants `mainnet-beta`
+- preview before any live transfer
+- preserve the sender rent reserve for SOL transfers
+
+If an execution environment blocks `pnpm tsx` because of `tsx` IPC restrictions, agents can use the equivalent fallback form:
+
+```bash
+node --import tsx src/cli/<command>.ts ...
+```
+
 ## Command Examples
 
 Create a wallet set:
@@ -61,6 +112,18 @@ Create a wallet set with an explicit external DB path:
 pnpm tsx src/cli/create-wallets.ts --set test-set --count 25 --network devnet --db-path ~/.solana-agent-wallet-ops/wallets.sqlite
 ```
 
+Import a wallet-set JSON file into SQLite storage:
+
+```bash
+pnpm tsx src/cli/import-wallets.ts --from ./wallet-set.json
+```
+
+Import a standalone wallet JSON file as a one-wallet set:
+
+```bash
+pnpm tsx src/cli/import-wallets.ts --from ./wallet.json --set imported-treasury --network devnet
+```
+
 List all wallet sets:
 
 ```bash
@@ -128,6 +191,18 @@ Preview a SplitNOW order from an existing quote into a wallet set:
 pnpm tsx src/cli/splitnow-order.ts --quote-id QUOTE123 --to-set campaign
 ```
 
+Preview a SplitNOW order from a CSV recipient list:
+
+```bash
+pnpm tsx src/cli/splitnow-order.ts --quote-id QUOTE123 --to-csv ./splitnow-recipients.csv
+```
+
+Preview a SplitNOW order with a specific exchanger from the quote:
+
+```bash
+pnpm tsx src/cli/splitnow-order.ts --quote-id QUOTE123 --to-set campaign --exchanger changenow
+```
+
 Create the real SplitNOW order after review:
 
 ```bash
@@ -140,6 +215,27 @@ Track SplitNOW order status:
 pnpm tsx src/cli/splitnow-status.ts --order-id ABC123
 ```
 
+## SplitNOW Notes
+
+- `splitnow-quote` creates a floating-rate quote and prints the exchangers returned by SplitNOW, sorted by estimated output.
+- `splitnow-order` consumes an existing quote and builds a multi-wallet order from either `--to-set` or `--to-csv`.
+- The current implementation splits funds evenly across recipients. It does not support per-recipient custom percentages yet.
+- The current implementation uses one exchanger per order. By default it selects `best`, or you can pass `--exchanger <id>` to force one of the exchanger ids returned by the quote.
+- SplitNOW recipient sources are address-only:
+  - wallet set via `--to-set`
+  - CSV via `--to-csv`
+- SplitNOW recipient CSV columns:
+  - required: `public_key`
+  - optional: `label`
+- SplitNOW orders reject empty recipient lists, duplicate recipient public keys, and recipient counts above 100.
+- Before creating an order, the client checks SplitNOW deposit limits and rejects orders that are below the minimum required deposit for the selected asset and recipient count.
+- Creating an order does not move funds by itself. It returns:
+  - `orderId`
+  - `depositAddress`
+  - `depositAmount`
+- After order creation, you still need to send the deposit to the returned address, then track progress with `splitnow-status`.
+- Use `--api-url` only when intentionally pointing at a non-default SplitNOW API endpoint.
+
 Notes for CSV recipient input:
 
 - If the CSV includes an `amount` column, per-row amounts are used.
@@ -157,6 +253,12 @@ Storage path overrides:
 - repo-local DBs are rejected unless you pass `--allow-repo-db` or set `SAWO_ALLOW_REPO_DB=1`
 - SplitNOW API key: `SPLITNOW_API_KEY=...`
 
+Wallet import formats:
+
+- wallet-set JSON file with `set_name`, `created_at`, `network`, and `wallets`
+- standalone wallet JSON object with `label`, `public_key`, and `secret_key_base58`
+- JSON array of wallet entries when you also pass `--set` and `--network`
+
 ## Storage Format
 
 Primary wallet storage lives in a local SQLite database: