Upload markdown files to Arweave for permanent, decentralized storage with IPFS CID tagging

version
0.0.1
GitHub stars
10

Install

/plugin install markdown-provenance@markdown-provenance

Run it inside Claude Code after adding the marketplace with /plugin marketplace add rickmanelius/markdown-provenance.

Contents

Discovered from source

Skills 1

Upload markdown content to Arweave's permanent, decentralized storage network with proper metadata tags. Returns a viewblock.io transaction URL and logs all uploads locally.

SECURITY: This skill should ONLY be invoked via the explicit /markdown-provenance slash command, never automatically based on conversation context.

<quick_start>

  1. Ensure MP_WALLET_PATH environment variable points to wallet.json
  2. Run the upload script with the markdown file path
cd "${CLAUDE_PLUGIN_ROOT}"
npm run upload path/to/file.md

</quick_start>

## Step 1: Confirm User Intent

Before uploading, confirm the user explicitly requested this via /markdown-provenance command. Never auto-trigger based on conversation about Arweave or permanent storage.

Step 2: Check Environment

Verify MP_WALLET_PATH is set:

echo $MP_WALLET_PATH

If not set, guide user through wallet setup:

# Generate wallet
npx -y arweave wallet generate > wallet.json

# Set environment variable (add to ~/.zshrc or ~/.bashrc)
export MP_WALLET_PATH="/path/to/wallet.json"
export MP_AUTHOR="Your Name"  # Optional

Step 3: Upload File

Execute the upload script:

cd "${CLAUDE_PLUGIN_ROOT}"
npm run upload <file-path>

Step 4: Report Results

Share with user:

  • ViewBlock URL for the transaction
  • Direct Arweave URL
  • IPFS CID of the content
  • Confirmation that transaction was logged to ~/.markdown-provenance/transactions.jsonl

<tags_applied> The following tags are automatically added to each upload:

TagValue
Content-Typetext/markdown
App-NameMarkdown Provenance
App-Version0.0.1
TypeAttestation
IPFS-CID(calculated from content)
Author(from MP_AUTHOR env var or --author flag, if set)
File-Name(from --fileName flag, if set)
Source(from --source flag, if set)
</tags_applied>

<success_criteria>

  • Transaction ID returned from Arweave
  • viewblock.io URL displayed to user
  • Transaction logged to ~/.markdown-provenance/transactions.jsonl
  • All required tags applied (App-Name, App-Version, Content-Type, Type, IPFS-CID) </success_criteria>

<error_handling> If MP_WALLET_PATH not set:

  • Direct user to README.md wallet setup section
  • Provide quick setup commands shown above

If wallet file not found:

  • Verify path is correct
  • Check file permissions

If upload fails with network error:

  • Suggest retry
  • Check internet connection

If upload fails with insufficient funds (files >100KB):

  • Files under 100KB are FREE via Turbo
  • For larger files, direct user to fund wallet with AR tokens
  • Get wallet address: npx arweave wallet address wallet.json </error_handling>

Commands 1

Upload the specified markdown file to Arweave permanent storage.

Arguments: $ARGUMENTS

Options

  • --author "Name" - Override the MP_AUTHOR environment variable for this upload
  • --fileName "name" - Add a File-Name tag for easier lookup on Arweave
  • --source "URL" - Add a Source tag referencing the origin URL or URI

Process

  1. First, verify the file exists at the specified path
  2. Check that MP_WALLET_PATH environment variable is set
  3. Run the upload script from the markdown-provenance plugin directory
  4. Report the ViewBlock URL and IPFS CID to the user

Commands

# Navigate to the plugin directory and run upload
cd "${CLAUDE_PLUGIN_ROOT}" && npm run upload $ARGUMENTS

On Success

Report to user:

  • ViewBlock transaction URL
  • Direct Arweave URL
  • IPFS CID of the content
  • Confirmation that transaction was logged

On Error

If MP_WALLET_PATH not set, show setup instructions from README.md. If file not found, show the path that was attempted. If upload fails, show the error message with troubleshooting hints.

Sponsors

Details

Marketplace
rickmanelius/markdown-provenance
Source
plugins/markdown-provenance
Author
Rick Manelius
Category
Community