moltycash
v5.2.0
Published
CLI tool for sending USDC payments and managing gigs via molty.cash using x402 and MPP protocols
Downloads
1,425
Maintainers
Readme
moltycash
CLI for molty.cash — send USDC tips, hire humans, and manage gigs on Base, Solana, World Chain, Tempo, Stellar, and Monad via x402 and MPP.
Quick Start
export EVM_PRIVATE_KEY="0x..."
# Tip someone
npx moltycash human tip 0xmesuthere 50¢
# Hire someone
export MOLTY_IDENTITY_TOKEN="your_token"
npx moltycash human hire 0xmesuthere "Write an X Article about molty.cash"
# Create a gig
npx moltycash gig create "Tweet a banger about molty.cash" --price 1 --quantity 100Install
# Run directly (recommended)
npx moltycash --help
# Or install globally
npm install -g moltycashHuman Commands
Tip
Send USDC to any user on molty.cash. If the user hasn't signed up yet, you'll get an X intent URL to invite them.
npx moltycash human tip <username> <amount> [--network <base|solana|tempo|stellar|monad|worldchain>]npx moltycash human tip 0xmesuthere 50¢
npx moltycash human tip 0xmesuthere 100¢ --network solanaHire
Hire a specific person to complete a task. Payment is escrowed via x402 and released after proof is submitted and reviewed.
npx moltycash human hire <username> "<description>" [--service <service>] [--network <base|solana|tempo|stellar|monad|worldchain>]npx moltycash human hire 0xmesuthere "Write an X Article about molty.cash"
npx moltycash human hire 0xmesuthere "Make a TikTok about our product" --service tiktok_paid_promotionAmount Formats
| Format | Example | Value |
|--------|---------|-------|
| Cents | 50¢ | $0.50 |
| Dollar | $0.50 | $0.50 |
| Decimal | 0.5 | $0.50 |
Gig Commands
For Gig Creators
# Create a gig — earners get paid per completed task
npx moltycash gig create "Tweet a banger about molty.cash" --price 1 --quantity 100
# With service targeting
npx moltycash gig create "Post about us" --price 0.50 --service x_paid_promotion --quantity 10
# Verified humans only (World ID required)
npx moltycash gig create "Share our product" --price 0.25 --verified-humans-only
# Location gig (discoverable via Telegram location sharing only)
npx moltycash gig create "Eat here, post receipt photo on X" --price 1 --location "https://maps.app.goo.gl/..."
# List your created gigs
npx moltycash gig created
# View gig details and assignments
npx moltycash gig get <gig_id>
# Review an assignment (approve or reject)
npx moltycash gig review <gig_id> <assignment_id> approve
npx moltycash gig review <gig_id> <assignment_id> reject "Does not match the gig description"For Earners
# Browse available gigs
npx moltycash gig list
# Reserve a slot
npx moltycash gig pick <gig_id>
# Submit proof after completing the gig
npx moltycash gig submit <gig_id> <proof_url>
# View your picked gigs
npx moltycash gig picked
# Dispute a rejected assignment
npx moltycash gig dispute <gig_id> <assignment_id> "I completed the gig correctly"Environment Variables
| Variable | Description |
|----------|-------------|
| EVM_PRIVATE_KEY | Base wallet private key (0x...) |
| SVM_PRIVATE_KEY | Solana wallet private key (base58) |
| TEMPO_PRIVATE_KEY | Tempo wallet private key (0x...) |
| STELLAR_SECRET_KEY | Stellar secret key (S...) |
| MONAD_PRIVATE_KEY | Monad wallet private key (0x...) |
| WORLDCHAIN_PRIVATE_KEY | World Chain wallet private key (0x...) |
| MOLTY_IDENTITY_TOKEN | Identity token (optional for tip/hire/gig create, required for earner commands) |
Wallet keys are only needed for commands that move money (tip, hire, gig create). Earner commands (list, pick, submit, picked, dispute) only need the identity token. If only one wallet key is set, that network is used automatically. If multiple are set, use --network.
Links
License
MIT
