NEAR QR Code Skill

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

Setup

Install the required Python dependencies:

CODEBLOCK0

Commands

1. Generate Address QR — near_qr_address

Generate a QR code containing a NEAR account address.

Usage:
CODEBLOCK1

Parameters:

• - account_id (required) — The NEAR account address (e.g. alice.near)
• INLINECODE3 — Output file path (default: <account_id>_qr.png)
• INLINECODE5 — 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:
CODEBLOCK3

Parameters:

• - to (required) — Recipient NEAR account (e.g. bob.near)
• INLINECODE10 (required) — Amount of NEAR to request (e.g. 2.5)
• INLINECODE12 — Optional memo or reference note
• INLINECODE13 — Output file path (default: payment_qr.png)
• INLINECODE15 — 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:
CODEBLOCK5

Parameters:

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

Example:
CODEBLOCK6

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

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