Mini-Pay Skill

The starknet-mini-pay skill enables simple P2P payments on Starknet. Generate QR codes, create payment links, manage invoices, and transfer ETH/STRK/USDC - like Lightning, but native to Starknet.

Installation

# Install via skills CLI
npx skills add keep-starknet-strange/starknet-agentic/skills/starknet-mini-pay

# Or clone the repo
git clone https://github.com/keep-starknet-strange/starknet-agentic.git

Instant Payments

Unlike Lightning which requires channel setup, Mini-Pay works instantly with any Starknet wallet.

Example Usages

Features

Feature	Description
P2P Transfers	Send ETH/STRK/USDC to any Starknet address
QR Codes	Generate QR codes for addresses
Payment Links	`starknet:{addr}?amount=1&memo=coffee`
Invoices	Payment requests with expiry
Telegram Bot	Send/receive via chat commands
Transaction History	Track all transfers with status

Payment Link Format

starknet:{address}?amount={value}&memo={text}&token={ETH|STRK|USDC}

Example:

starknet:0x053c91253bc9682c04929ca02ed00b3e423f6714...?amount=0.01&memo=coffee&token=ETH

Telegram Bot Commands

Command	Description
`/pay {address} {amount} [memo]`	Send payment
`/qr`	Show your QR code
`/balance`	Check balance
`/link {amount} [memo]`	Generate payment link
`/invoice {amount}`	Create invoice
`/history`	Transaction history
`/help`	Show help

Comparison with Lightning

Feature	Lightning	Starknet Mini-Pay
Setup time	Hours (channels)	Instant
Privacy	Onion routing	Per-transaction
Speed	~1 second	~2-3 minutes
Fees	Variable	Predictable
Custody	Lightning node	Self-custody
Native	No (needs BTC)	Yes

Error Handling

Error	Cause	Solution
`INSUFFICIENT_BALANCE`	Not enough tokens	Add more to account
`ACCOUNT_NOT_FOUND`	Invalid address	Check address format
`INVALID_AMOUNT`	Amount less than or equal to 0	Use positive amount
`TX_FAILED`	Transaction reverted	Check recipient address
`INVOICE_EXPIRED`	Past expiry	Create new invoice

Security Notes

Security

Never expose private keys in logs or errors
Validate all addresses before sending
Set reasonable invoice expiry times
Use HTTPS for any web interfaces