Near Qr Skill

Generate QR codes for NEAR addresses and payment requests, and read NEAR QR codes from images.

NEAR QR Code Skill

Generate and read QR codes for NEAR Protocol addresses and payment requests.

Setup

Install the required Python dependencies:

pip install -r requirements.txt

Commands

1. Generate Address QR — near_qr_address

Generate a QR code containing a NEAR account address.

Usage:

python near_qr.py address <account_id> [--output <path>] [--size <pixels>]

Parameters:

• account_id (required) — The NEAR account address (e.g. alice.near)
• --output — Output file path (default: <account_id>_qr.png)
• --size — QR image size in pixels (default: 400)

Example:

python near_qr.py address alice.near --output alice_qr.png --size 500

---

2. Generate Payment QR — near_qr_payment

Generate a QR code for a NEAR payment request, encoding recipient, amount, and optional memo.

Usage:

python near_qr.py payment <to> <amount> [--memo <text>] [--output <path>] [--size <pixels>]

Parameters:

• to (required) — Recipient NEAR account (e.g. bob.near)
• amount (required) — Amount of NEAR to request (e.g. 2.5)
• --memo — Optional memo or reference note
• --output — Output file path (default: payment_qr.png)
• --size — QR image size in pixels (default: 400)

Example:

python near_qr.py payment bob.near 5.0 --memo "Invoice #42" --output pay_bob.png

---

3. Read QR Code — near_qr_read

Decode a NEAR QR code from an image file and extract the embedded data.

Usage:

python near_qr.py read <image_path>

Parameters:

• image_path (required) — Path to the QR code image

Example:

python near_qr.py read alice_qr.png

Output: Returns a JSON object with the decoded type and data:

{
  "type": "near_address",
  "account": "alice.near"
}

or for payment QR codes:

{
  "type": "near_payment",
  "to": "bob.near",
  "amount": "5.0",
  "memo": "Invoice #42"
}