Arweave Upload & ArNS Skill

Upload files and websites to permanent storage on Arweave, and manage ArNS (Arweave Name System) domain records.

Phrase Mappings User Request Command "use arweave to upload " upload "use arweave to upload

" upload-site "use arweave to attach to " attach "use arweave to query transactions" query Wallet Handling

Important: This skill requires an Arweave wallet file (JWK format).

If the user has not provided a wallet path, ask them for it before proceeding Pass the wallet path via --wallet argument Never expose or log wallet contents Commands Upload a Single File node skills/arweave/index.mjs upload "" --wallet ""

Upload a Website/Directory node skills/arweave/index.mjs upload-site "" --index "index.html" --wallet ""

--index specifies the default file served at the root (defaults to index.html) The returned txId is the manifest transaction that serves the entire site Attach Transaction to ArNS Name node skills/arweave/index.mjs attach "" "" --wallet "" --yes

Options:

--ttl - Time-to-live in seconds (default: 3600) --network - Network to use (default: mainnet) --ario-process - Override network with specific ARIO process ID --yes - Skip confirmation prompts

Propagation: Updates usually appear within a few minutes, but can take up to ~30 minutes to reflect everywhere (gateway/operator caches and client TTLs).

ArNS Name Format Names with underscore like hello_rakis mean undername hello on base name rakis Strip .ar.io suffix if present (e.g., rakis.ar.io becomes rakis)

Examples:

rakis - base name (updates @ record) hello_rakis - undername hello under base rakis docs_myproject - undername docs under base myproject Network Selection

By default, the skill uses mainnet. You can specify a different network:

Use mainnet (default)

node skills/arweave/index.mjs attach "" "" --network mainnet --wallet "..." --yes

Use testnet

node skills/arweave/index.mjs attach "" "" --network testnet --wallet "..." --yes

Use specific ARIO process ID (overrides --network)

node skills/arweave/index.mjs attach "" "" --ario-process "" --wallet "..." --yes

Output Handling

After successful upload, report back:

Transaction ID (txId) Gateway URL: https://arweave.net/

Example response to user:

Uploaded successfully! - Transaction ID: abc123xyz... - View at: https://arweave.net/abc123xyz...

For site uploads, clarify that the txId represents the manifest transaction serving the entire site.

Query Transactions node skills/arweave/index.mjs query [options]

Search and filter Arweave transactions using the GraphQL endpoint.

Options:

--tag - Filter by tag (can specify multiple, uses AND logic) --owner

- Filter by owner wallet address --recipient

- Filter by recipient wallet address --ids - Query specific transaction IDs --block-min - Minimum block height --block-max - Maximum block height --limit - Max results to return (default: 10, set to 0 for all) --sort - Sort order (default: HEIGHT_DESC)

Tag Syntax:

Tags use the format name:value. Multiple --tag flags apply AND logic (all conditions must match).

Single tag

--tag "Content-Type:text/html"

Multiple tags (both must match)

--tag "Content-Type:text/html" --tag "User-Agent:ArweaveAutoDPL/0.1"

Pagination:

Default limit is 10 transactions Use --limit 0 to fetch all matching results Large queries may take time; consider narrowing filters for faster results

Examples:

Query last 10 recent transactions

node skills/arweave/index.mjs query --sort HEIGHT_DESC

Find all HTML content (fetch all results)

node skills/arweave/index.mjs query --tag "Content-Type:text/html" --limit 0

Query by owner with custom limit

node skills/arweave/index.mjs query --owner "M6w588ZkR8SVFdPkNXdBy4sqbMN0Y3F8ZJUWm2WCm8M" --limit 50

Multiple tags (AND logic: both conditions must match)

node skills/arweave/index.mjs query \ --tag "Content-Type:text/html" \ --tag "User-Agent:ArweaveAutoDPL/0.1" \ --limit 20

Query block height range

node skills/arweave/index.mjs query --block-min 587540 --block-max 587550 --limit 100

Combine filters: HTML in specific block range, oldest first

node skills/arweave/index.mjs query \ --tag "Content-Type:text/html" \ --block-min 587540 \ --block-max 587550 \ --sort HEIGHT_ASC

Query specific transaction IDs

node skills/arweave/index.mjs query --ids "abc123,def456,ghi789"

Find transactions from specific recipient

node skills/arweave/index.mjs query --recipient "M6w588ZkR8SVFdPkNXdBy4sqbMN0Y3F8ZJUWm2WCm8M" --limit 25

GraphQL Endpoint Fallback

The query command automatically tries multiple GraphQL endpoints for reliability:

https://arweave.net/graphql (primary - official gateway) https://arweave-search.goldsky.com/graphql (fallback - Goldsky indexer) https://g8way.io/graphql (fallback - alternative gateway)

This happens transparently - the command uses whichever endpoint responds first. You don't need to do anything; it just works.

Custom Endpoint Override

To use a specific GraphQL endpoint (useful for testing or private gateways):

Use a custom endpoint

node skills/arweave/index.mjs query --tag "Content-Type:text/html" --limit 5 \ --graphql-endpoint "https://custom-gateway.com/graphql"

Force use of a specific public endpoint

node skills/arweave/index.mjs query --owner

--limit 10 \ --graphql-endpoint "https://g8way.io/graphql"

Note: When --graphql-endpoint is provided, the automatic fallback is disabled. Only the specified endpoint will be tried.

Example Invocations

Upload a single markdown file

node skills/arweave/index.mjs upload "foo.md" --wallet "/path/to/wallet.json"

Upload a website directory

node skills/arweave/index.mjs upload-site "./mywebsite" --index "index.html" --wallet "/path/to/wallet.json"

Attach a transaction to an ArNS undername (mainnet)

node skills/arweave/index.mjs attach "" "hello_rakis" --ttl 3600 --network mainnet --wallet "/path/to/wallet.json" --yes

Attach to testnet

node skills/arweave/index.mjs attach "" "hello_rakis" --network testnet --wallet "/path/to/wallet.json" --yes

Attach using specific ARIO process

node skills/arweave/index.mjs attach "" "hello_rakis" --ario-process testnet --wallet "/path/to/wallet.json" --yes

安装