@ar.io/deploy 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Permanent Data Solutions, Inc.
+
+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,695 @@
+# ARIO Deploy
+
+`ario-deploy` is a Node.js command-line tool designed to streamline the deployment of web applications to the permaweb using Arweave. It uploads your build folder or a single file, creates Arweave manifests, and can optionally update ArNS (Ar.io Name System) records via ANT (Ar.io Name Token) with the transaction ID.
+
+## Table of Contents
+
+<!-- toc -->
+
+- [Table of Contents](#table-of-contents)
+- [Features](#features)
+- [Installation](#installation)
+- [Prerequisites](#prerequisites)
+- [Commands](#commands)
+- [On-Demand Payment](#on-demand-payment)
+- [Bundler service](#bundler-service)
+- [Command Options](#command-options)
+- [Deduplication](#deduplication)
+- [Package.json Scripts](#packagejson-scripts)
+- [GitHub Action](#github-action)
+- [CLI in GitHub Actions](#cli-in-github-actions)
+- [Development](#development)
+- [Security & Best Practices](#security--best-practices)
+- [Troubleshooting](#troubleshooting)
+- [Contributing](#contributing)
+- [Dependencies](#dependencies)
+- [License](#license)
+- [Resources](#resources)
+
+<!-- tocstop -->
+
+## Features
+
+- **Turbo SDK Integration:** Uses Turbo SDK for fast, reliable file uploads to Arweave
+- **On-Demand Payment:** Pay with ARIO or Base-ETH tokens on-demand during upload
+- **Arweave Manifest v0.2.0:** Creates manifests with fallback support for SPAs
+- **Optional ArNS Updates:** Updates ArNS records via ANT with new transaction IDs
+- **Automated Workflow:** Integrates with GitHub Actions for continuous deployment
+- **Git Hash Tagging:** In CI (GitHub Actions), tags uploaded data items with the deploying commit SHA
+- **404 Fallback Detection:** Automatically detects and sets 404.html as fallback
+- **Network Support:** ArNS updates run against the Solana ARIO programs on `mainnet` or `devnet`, with an optional custom RPC URL
+- **Flexible Deployment:** Supports deploying a folder or a single file
+- **Modern CLI:** Built with oclif for a robust command-line experience
+- **TypeScript:** Fully typed for better developer experience
+
+## Installation
+
+Install the package using pnpm (recommended):
+
+```bash
+pnpm add -D @ar.io/deploy
+```
+
+Or with npm:
+
+```bash
+npm install --save-dev @ar.io/deploy
+```
+
+Or with yarn:
+
+```bash
+yarn add --dev @ar.io/deploy
+```
+
+## Prerequisites
+
+1. **For Arweave signer (default):** Encode your Arweave wallet key in base64 format and set it as a GitHub secret:
+
+   ```bash
+   base64 -i wallet.json | pbcopy
+   ```
+
+2. **For Ethereum/Polygon/KYVE signers:** Use your raw private key (no encoding needed) as the `DEPLOY_KEY`.
+3. **For Solana signers:** Use a base58-encoded secret key (the "export private key" format) as the `DEPLOY_KEY`, or a `solana-keygen` `id.json` byte-array wallet file via `--wallet`.
+4. Ensure that the secret name for the encoded wallet or private key is `DEPLOY_KEY`.
+
+⚠️ **Important:** Use a dedicated wallet for deployments to minimize security risks. Ensure your wallet has sufficient Turbo Credits for uploads.
+
+> **ArNS updates require a Solana signer.** ArNS/ANT records now live on Solana programs, so any deployment that updates ArNS (`--use-arns` / `--arns-name`) must use `--sig-type solana`. Uploads alone can use any supported signer.
+
+## Commands
+
+### Interactive Mode (Easiest)
+
+**Command Menu:**
+
+Simply run the CLI for an interactive command selector:
+
+```bash
+ario-deploy
+# or explicitly
+ario-deploy interactive
+```
+
+This shows a menu with options:
+
+- **Deploy to Permaweb** - Start the deployment wizard
+- **Show Help** - Display help information
+- **Exit** - Exit the CLI
+
+**Interactive Deploy (Guided):**
+
+Run the deploy command without arguments to be guided through all deployment options:
+
+```bash
+ario-deploy deploy
+```
+
+This uploads to the permaweb by default. Use `--use-arns` or `--arns-name` to run the guided ArNS update flow, which will prompt you for:
+
+- ArNS name
+- Wallet method (file, string, or environment variable)
+- Signer type (Arweave, Ethereum, Polygon, KYVE, Solana)
+- What to deploy (folder or file)
+- Advanced options (optional: undername, TTL, Solana cluster)
+
+### Direct Commands
+
+Use flags for faster, scriptable deployments:
+
+```bash
+# Basic deployment with wallet file
+ario-deploy deploy --wallet ./wallet.json
+
+# Deployment with ArNS update (ArNS requires a Solana signer)
+ario-deploy deploy --use-arns --arns-name my-app --sig-type solana --wallet ./id.json
+```
+
+Deploy using private key directly:
+
+```bash
+ario-deploy deploy --private-key "$(cat wallet.json)"
+```
+
+Deploy using environment variable:
+
+```bash
+DEPLOY_KEY=$(base64 -i wallet.json) ario-deploy deploy --deploy-folder ./dist
+```
+
+Deploy a specific folder:
+
+```bash
+ario-deploy deploy --wallet ./wallet.json --deploy-folder ./build
+```
+
+Deploy a single file:
+
+```bash
+ario-deploy deploy --wallet ./wallet.json --deploy-file ./path/to/file.txt
+```
+
+### Upload/deploy without ArNS
+
+`deploy` uploads without updating ArNS by default. You can also use the `upload` command explicitly for the same Turbo upload, dedupe cache, and payment options as deploy, minus ArNS flags:
+
+```bash
+ario-deploy deploy --wallet ./wallet.json --deploy-folder ./dist
+ario-deploy upload --wallet ./wallet.json --deploy-folder ./dist
+ario-deploy upload --wallet ./wallet.json --deploy-file ./dist/index.html
+DEPLOY_KEY=$(base64 -i wallet.json) ario-deploy upload --deploy-folder ./dist
+```
+
+### Advanced Usage
+
+Deploy to an undername (subdomain) — ArNS, so a Solana signer is required:
+
+```bash
+ario-deploy deploy --use-arns --arns-name my-app --sig-type solana --wallet ./id.json --undername staging
+```
+
+Deploy with a custom TTL:
+
+```bash
+ario-deploy deploy --use-arns --arns-name my-app --sig-type solana --wallet ./id.json --ttl-seconds 7200
+```
+
+Update ArNS on devnet (or against a custom RPC):
+
+```bash
+ario-deploy deploy --use-arns --arns-name my-app --sig-type solana --wallet ./id.json --cluster devnet
+ario-deploy deploy --use-arns --arns-name my-app --sig-type solana --wallet ./id.json --rpc-url https://my-rpc.example.com
+```
+
+Upload using an Ethereum wallet (file):
+
+```bash
+ario-deploy deploy --sig-type ethereum --wallet ./private-key.txt
+```
+
+Upload using a Solana wallet (base58 private key):
+
+```bash
+ario-deploy deploy --sig-type solana --private-key "<base58-secret-key>"
+```
+
+## On-Demand Payment
+
+Use on-demand payment to automatically fund uploads with ARIO or Base-ETH tokens when your Turbo balance is insufficient:
+
+Deploy with ARIO on-demand payment:
+
+```bash
+ario-deploy deploy --wallet ./wallet.json --deploy-folder ./dist --on-demand ario --max-token-amount 1.5
+```
+
+Deploy with Base-ETH on-demand payment (using Ethereum signer):
+
+```bash
+ario-deploy deploy --sig-type ethereum --private-key "0x..." --on-demand base-eth --max-token-amount 0.1
+```
+
+**On-Demand Payment Options:**
+
+- `--on-demand`: Token to use for on-demand payment (`ario` or `base-eth`)
+- `--max-token-amount`: Maximum token amount to spend (in native token units, e.g., `1.5` for 1.5 ARIO or `0.1` for 0.1 ETH)
+
+**How it works:**
+
+1. Checks your Turbo balance before upload
+2. If balance is insufficient, converts tokens to Turbo credits on-demand
+3. Automatically adds a 10% buffer (`topUpBufferMultiplier: 1.1`) for reliability
+4. Proceeds with upload once funded
+
+**Token compatibility:**
+
+- **ARIO**: Works with Arweave signer
+- **Base-ETH**: Works with Ethereum signer (Base Network)
+
+## Bundler service
+
+Uploads go through a bundler service that accepts signed data items and posts them to Arweave. By default, ario-deploy uses the [Turbo](https://docs.ardrive.io/docs/turbo/) API and ArDrive’s production bundler (`https://upload.ardrive.io`). **`--uploader`** sets the **base URL** of the bundler service to use (scheme + host; typically no path).
+
+| When to use               | Example value                                           |
+| ------------------------- | ------------------------------------------------------- |
+| **Default** (omit flag)   | ArDrive production bundler — same as Turbo CLI defaults |
+| **Arweave bundler**       | `https://turbo.ardrive.io`                              |
+| **Development / staging** | `https://upload.ardrive.dev`                            |
+| **Custom or self-hosted** | Your own base URL if it implements the Turbo API        |
+
+**Examples:**
+
+```bash
+# Deploy using Arweave’s bundler service
+ario-deploy deploy --wallet ./wallet.json --deploy-folder ./dist --uploader https://turbo.ardrive.io
+
+ario-deploy upload --wallet ./wallet.json --deploy-folder ./dist --uploader https://turbo.ardrive.io
+```
+
+**Notes:**
+
+- Turbo billing and signer behavior follow Turbo.
+- Use a **base URL only** (e.g. `https://turbo.ardrive.io`), not a path to a specific file or route.
+
+## Command Options
+
+**`deploy`** (upload by default, optional ArNS update):
+
+- `--use-arns`: Update an ArNS/ANT record after upload. **Requires `--sig-type solana`.**
+- `--arns-name, -n`: The ArNS name to update. Required when using `--use-arns`; also implies ArNS mode for backwards compatibility.
+- `--cluster, -p`: Solana cluster for ArNS updates. Choices: `mainnet`, `devnet`. Default: `mainnet`
+- `--rpc-url`: Optional Solana RPC URL override for ArNS updates
+- `--deploy-folder, -d`: Folder to deploy. Default: `./dist`
+- `--deploy-file, -f`: Deploy a single file instead of a folder
+- `--undername, -u`: ANT undername to update. Default: `@`
+- `--ttl-seconds, -t`: TTL in seconds for the ANT record (60-86400). Default: `60`
+- `--sig-type, -s`: Signer type for deployment. Choices: `arweave`, `ethereum`, `polygon`, `kyve`, `solana`. Default: `arweave`
+- `--wallet, -w`: Path to wallet file (JWK for Arweave, private key for Ethereum/Polygon/KYVE, `solana-keygen` `id.json` for Solana)
+- `--private-key, -k`: Private key string (alternative to `--wallet`). JWK JSON for Arweave, hex for EVM chains, base58 secret key for Solana
+- `--on-demand`: Enable on-demand payment with specified token. Choices: `ario`, `base-eth`
+- `--max-token-amount`: Maximum token amount for on-demand payment (used with `--on-demand`)
+- `--no-dedupe`: Disable deduplication (do not cache or reuse previous uploads)
+- `--dedupe-cache-max-entries`: Maximum number of entries to keep in the dedupe cache (LRU). Default: `10000`
+- `--uploader`: Custom Turbo upload service base URL. See the **Bundler service** section.
+
+**`upload`** (explicit upload without ArNS): accepts `--deploy-folder`, `--deploy-file`, wallet/signer flags, `--uploader`, `--on-demand` / `--max-token-amount`, and dedupe flags only.
+
+## Deduplication
+
+By default, ario-deploy caches your deployment log to prevent uploading duplicate (unchanged) files. This saves both time and upload costs by reusing existing data on Arweave.
+
+**How it works:**
+
+1. When you deploy, ario-deploy hashes each file in your build
+2. It checks the local cache for matching hashes from previous uploads
+3. Files that haven't changed are skipped - the existing transaction ID is reused
+4. Only new or modified files are uploaded to Arweave
+5. The cache is stored locally in `.ario-deploy/transaction-cache.json`
+
+**Disable deduplication:**
+
+If you need to force a fresh upload of all files (e.g., for debugging or to ensure a completely new deployment):
+
+```bash
+ario-deploy deploy --wallet ./wallet.json --no-dedupe
+```
+
+**Limit cache size:**
+
+The dedupe cache uses an LRU (Least Recently Used) eviction strategy. By default, it keeps up to 10,000 entries. You can adjust this limit:
+
+```bash
+# Keep only the last 1000 file entries
+ario-deploy deploy --wallet ./wallet.json --dedupe-cache-max-entries 1000
+```
+
+**Cache location:**
+
+The cache file is stored at `.ario-deploy/transaction-cache.json` in your project root. You can:
+
+- Add it to `.gitignore` if you don't want to share cache across team members
+- Commit it to share cached transaction IDs with your team (reduces duplicate uploads)
+- Delete it to start fresh: `rm -rf .ario-deploy/`
+
+## Package.json Scripts
+
+Add deployment scripts to your `package.json`:
+
+```json
+{
+  "scripts": {
+    "build": "vite build",
+    "deploy": "pnpm build && ario-deploy deploy --arns-name <ARNS_NAME> --sig-type solana",
+    "deploy:staging": "pnpm build && ario-deploy deploy --arns-name <ARNS_NAME> --sig-type solana --undername staging",
+    "deploy:devnet": "pnpm build && ario-deploy deploy --arns-name <ARNS_NAME> --sig-type solana --cluster devnet",
+    "deploy:on-demand": "pnpm build && ario-deploy deploy --arns-name <ARNS_NAME> --sig-type solana --on-demand ario --max-token-amount 1.5"
+  }
+}
+```
+
+Then deploy with:
+
+```bash
+DEPLOY_KEY=$(base64 -i wallet.json) pnpm deploy
+```
+
+Or with on-demand payment:
+
+```bash
+DEPLOY_KEY=$(base64 -i wallet.json) pnpm deploy:on-demand
+```
+
+## GitHub Action
+
+The easiest way to integrate ario-deploy into your CI/CD pipeline is using our official GitHub Action.
+
+### Basic Usage
+
+```yaml
+- uses: ar-io/ar-io-deploy@v1
+  with:
+    deploy-key: ${{ secrets.DEPLOY_KEY }}
+    arns-name: myapp
+    deploy-folder: ./dist
+    sig-type: solana # ArNS updates require a Solana signer
+```
+
+### PR Preview Deployments
+
+Automatically deploy preview builds for each pull request. The `preview` mode auto-generates an undername from the PR number and posts a comment with the preview URL:
+
+```yaml
+name: Deploy PR Preview
+
+on:
+  pull_request:
+    types: [opened, synchronize]
+
+jobs:
+  deploy-preview:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build
+
+      - name: Deploy Preview
+        uses: ar-io/ar-io-deploy@v1
+        with:
+          deploy-key: ${{ secrets.DEPLOY_KEY }}
+          arns-name: myapp
+          sig-type: solana
+          preview: 'true'
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          deploy-folder: ./dist
+```
+
+When `preview` is enabled, the action will:
+
+- Auto-generate an undername like `pr-123` from the PR number
+- Post a comment on the PR with the preview URL
+- Update the comment on subsequent pushes instead of creating new ones
+
+### Production Deployment
+
+Deploy to your base ArNS name when pushing to main:
+
+```yaml
+name: Deploy to Production
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build
+
+      - name: Deploy to Permaweb
+        uses: ar-io/ar-io-deploy@v1
+        with:
+          deploy-key: ${{ secrets.DEPLOY_KEY }}
+          arns-name: myapp
+          sig-type: solana
+          deploy-folder: ./dist
+```
+
+### With On-Demand Payment
+
+```yaml
+- name: Deploy with ARIO on-demand
+  uses: ar-io/ar-io-deploy@v1
+  with:
+    deploy-key: ${{ secrets.DEPLOY_KEY }}
+    arns-name: myapp
+    sig-type: solana
+    deploy-folder: ./dist
+    on-demand: ario
+    max-token-amount: '2.0'
+```
+
+### Updating ArNS (Solana)
+
+ArNS updates run against the Solana ARIO programs, so set `sig-type: solana` and provide a Solana `DEPLOY_KEY` (base58 secret key). Use `cluster` to target `mainnet` (default) or `devnet`, and `rpc-url` for a custom RPC endpoint.
+
+```yaml
+- name: Deploy and update ArNS
+  uses: ar-io/ar-io-deploy@v1
+  with:
+    deploy-key: ${{ secrets.DEPLOY_KEY }}
+    arns-name: myapp
+    deploy-folder: ./dist
+    sig-type: solana
+    cluster: mainnet
+```
+
+### Disabling Deduplication
+
+By default, the action caches transaction IDs to avoid re-uploading unchanged files. To disable this:
+
+```yaml
+- name: Deploy without dedupe
+  uses: ar-io/ar-io-deploy@v1
+  with:
+    deploy-key: ${{ secrets.DEPLOY_KEY }}
+    deploy-folder: ./dist
+    no-dedupe: 'true'
+```
+
+You can also limit the cache size:
+
+```yaml
+- name: Deploy with limited cache
+  uses: ar-io/ar-io-deploy@v1
+  with:
+    deploy-key: ${{ secrets.DEPLOY_KEY }}
+    deploy-folder: ./dist
+    dedupe-cache-max-entries: '1000'
+```
+
+---
+
+## CLI in GitHub Actions
+
+You can also use the CLI directly in your workflows:
+
+**Basic Workflow:**
+
+```yaml
+name: Deploy to Permaweb
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: pnpm/action-setup@v3
+        with:
+          version: 9
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: 'pnpm'
+
+      - run: pnpm install
+
+      - run: pnpm deploy
+        env:
+          DEPLOY_KEY: ${{ secrets.DEPLOY_KEY }}
+```
+
+**With On-Demand Payment:**
+
+```yaml
+name: Deploy to Permaweb with On-Demand Payment
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: pnpm/action-setup@v3
+        with:
+          version: 9
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: 'pnpm'
+
+      - run: pnpm install
+      - run: pnpm build
+
+      - name: Deploy with ARIO on-demand
+        run: ario-deploy deploy --arns-name my-app --sig-type solana --on-demand ario --max-token-amount 2.0
+        env:
+          DEPLOY_KEY: ${{ secrets.DEPLOY_KEY }}
+
+      # Or upload with Ethereum and Base-ETH on-demand payment (upload only; ArNS requires Solana):
+      # - name: Upload with Base-ETH on-demand
+      #   run: |
+      #     ario-deploy upload \
+      #       --sig-type ethereum \
+      #       --on-demand base-eth \
+      #       --max-token-amount 0.2
+      #   env:
+      #     DEPLOY_KEY: ${{ secrets.ETH_PRIVATE_KEY }}
+```
+
+## Development
+
+### Setup
+
+```bash
+# Install dependencies
+pnpm install
+
+# Build the project
+pnpm build
+
+# Run in development mode
+pnpm dev
+
+# Run tests
+pnpm test
+
+# Run linter
+pnpm lint
+
+# Format code
+pnpm format
+```
+
+### Project Structure
+
+```
+ar-io-deploy/
+├── src/
+│   ├── commands/        # oclif commands
+│   │   ├── deploy.ts
+│   │   └── upload.ts
+│   ├── types/           # TypeScript type definitions
+│   │   └── index.ts
+│   ├── utils/           # Utility functions
+│   │   ├── constants.ts
+│   │   ├── signer.ts
+│   │   ├── uploader.ts
+│   │   └── __tests__/   # Unit tests
+│   └── index.ts         # Main entry point
+├── bin/                 # Executable scripts
+│   ├── run.js
+│   └── dev.js
+├── .changeset/          # Changesets configuration
+├── .husky/              # Git hooks
+└── dist/                # Build output
+```
+
+## Security & Best Practices
+
+- **Dedicated Wallet:** Always use a dedicated wallet for deployments to minimize security risks
+- **Wallet Encoding:** Arweave wallets must be base64 encoded to be used in the deployment script
+- **ArNS Name:** Required only when updating an ANT/ArNS target undername or root record
+- **Turbo Credits:** Ensure your wallet has sufficient Turbo Credits, or use on-demand payment for automatic funding
+- **On-Demand Limits:** Set reasonable `--max-token-amount` limits to prevent unexpected costs
+- **Secret Management:** Keep your `DEPLOY_KEY` secret secure and never commit it to your repository
+- **Build Security:** Always check your build for exposed environmental secrets before deployment, as data on Arweave is permanent
+
+## Troubleshooting
+
+- **Error: "DEPLOY_KEY environment variable not set":** Verify your base64 encoded wallet is set as the `DEPLOY_KEY` environment variable
+- **Error: "deploy-folder does not exist":** Check that your build folder exists and the path is correct
+- **Error: "deploy-file does not exist":** Check that your build file exists and the path is correct
+- **Error: "ArNS name does not exist":** Verify the ArNS name is correct and exists in the specified network
+- **Upload timeouts:** Files have a timeout for upload. Large files may fail and require optimization
+- **Insufficient Turbo Credits:** Use `--on-demand` with `--max-token-amount` to automatically fund uploads when balance is low
+- **On-demand payment fails:** Ensure your wallet has sufficient tokens (ARIO or Base-ETH) and the token type matches your signer (`ario` with Arweave, `base-eth` with Ethereum)
+
+## Contributing
+
+Contributions are welcome! Please follow these guidelines:
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Run tests and linter: `pnpm test && pnpm lint`
+5. Create a changeset: `pnpm changeset`
+6. Commit your changes using conventional commits
+7. Push and create a pull request
+
+### Conventional Commits
+
+This project uses [Conventional Commits](https://www.conventionalcommits.org/). Commit messages should follow this format:
+
+```
+type(scope): subject
+
+body (optional)
+```
+
+Types: `feat`, `fix`, `docs`, `style`, `refactor`, `perf`, `test`, `build`, `ci`, `chore`, `revert`
+
+### Changesets
+
+We use [changesets](https://github.com/changesets/changesets) for version management. When making changes:
+
+```bash
+pnpm changeset
+```
+
+Follow the prompts to describe your changes.
+
+## Dependencies
+
+- **@ar.io/sdk** - For ANT operations and ArNS management on Solana
+- **@ardrive/turbo-sdk** - For fast file uploads to Arweave (and signer types)
+- **@solana/kit** - Solana RPC clients and transaction signers for ArNS updates
+- **bs58** - Base58 encoding/decoding for Solana keys
+- **@oclif/core** - CLI framework
+- **mime-types** - MIME type detection
+
+## License
+
+MIT — © Permanent Data Solutions, Inc.
+
+## Resources
+
+- [GitHub Repository](https://github.com/ar-io/ar-io-deploy)
+- [Issues](https://github.com/ar-io/ar-io-deploy/issues)
+- [Arweave Documentation](https://docs.arweave.org/)
+- [AR.IO Documentation](https://docs.ar.io/)