siwa-private-key

Sign SIWA messages with a raw private key via Viem LocalAccount.

43|12|Updated Feb 4, 2026
One-click install
npx skills add https://github.com/builders-garden/siwa --skill siwa-private-key
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: siwa-private-key
Source: https://github.com/builders-garden/siwa/tree/main/packages/siwa-website/public/skills/private-key
Command: npx skills add https://github.com/builders-garden/siwa --skill siwa-private-key

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enables SIWA authentication by signing messages with a raw Ethereum private key via Viem's LocalAccount, removing the need for external signing infrastructure in agent flows.

Core Features & Use Cases

  • Create a LocalAccount signer from a private key for SIWA authentication.
  • Sign and verify SIWA messages with the server nonce and verification endpoints.
  • Register as ERC-8004 agent and use ERC-8128 signatures for authenticated requests.

Quick Start

Create a LocalAccount signer from PRIVATE_KEY and use signSIWAMessage to sign and verify a SIWA flow.

Frequently Asked Questions about siwa-private-key

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sign SIWA messages with a raw Ethereum private key?

You can sign SIWA messages by creating a Viem LocalAccount from your PRIVATE_KEY environment variable, removing the need for external signing infrastructure in on-chain ERC-8004 agent flows.

What is SIWA authentication for ERC-8004 agent identities?

SIWA authentication is an agent flow mechanism that registers on-chain ERC-8004 identities and verifies authenticated requests using ERC-8128 signatures generated via a Viem LocalAccount signer.

Do I need external signing infrastructure to use a raw private key for SIWA?

No, using a raw private key for SIWA removes the need for external signing infrastructure because Viem's LocalAccount handles the signing directly for ERC-8128 authenticated agent requests.

How do I integrate nonce and verify endpoints for ERC-8128 signatures?

You integrate by routing your Viem LocalAccount signer through the /siwa/nonce endpoint to retrieve a server nonce, then submitting the signed SIWA message to the /siwa/verify endpoint for ERC-8128 validation.

What are the limitations of using a raw private key signer for agent authentication?

A key limitation is that it requires managing a PRIVATE_KEY environment variable locally, which introduces security risks compared to external signing infrastructure for SIWA agent authentication.