← Back to Skills Marketplace
buildersgarden

Sign-in with Agent

by Builders Garden · GitHub ↗ · v0.0.4
cross-platform ⚠ suspicious
1133
Downloads
0
Stars
2
Active Installs
4
Versions
Install in OpenClaw
/install siwa
Description
SIWA (Sign-In With Agent) authentication for ERC-8004 registered agents.
Usage Guidance
What to consider before installing/using this skill: - Incoherent metadata: the registry entry declares no required environment variables, but the documentation clearly expects many secrets (private keys, proxy HMAC secrets, API keys) for different signer backends. Treat the docs as authoritative: the skill will need secrets to operate. - Don’t paste private keys or shared HMAC secrets into a skill or chat. If you need signing, prefer a keyring/proxy deployed by you (self-hosted) and keep the proxy secret in your environment, not in chat or skill configuration. If you must test, use ephemeral testnet keys and testnet faucets. - Verify upstream packages/images before running installs or deploys: the docs reference npm package @buildersgarden/siwa and a GHCR Docker image and Railway deploy links. Inspect the npm package repository, its maintainers, and the container image contents before running them in any environment you care about. - The instructions expect filesystem access (specific workspace paths) and running pnpm/npm commands. Only run these commands in a controlled environment (isolated dev VM or container), not on sensitive production hosts. - Reverse CAPTCHA and captcha-solve helpers require the agent to generate content under constraints; that is not inherently malicious but could inadvertently leak generated content to the server endpoints shown. Confirm the server endpoints you will talk to and that you trust them. - Because the package is instruction-only in the registry and source/homepage are unknown, ask the skill author for the canonical repository URL, the npm package link, and the source for the Docker image. Without those you cannot easily audit the code you will install. If you plan to proceed: (1) audit the @buildersgarden/siwa npm package and the referenced Docker image; (2) prefer the keyring-proxy approach to avoid exposing private keys, and host it yourself; (3) use testnets and throwaway credentials for initial experiments; (4) ensure SIWA_SECRET and other server secrets are never stored in public or shared chat.
Capability Analysis
Type: OpenClaw Skill Name: siwa Version: 0.0.4 The skill is classified as suspicious due to the inherent risks associated with its core functionality and specific instructions, despite a strong stated security model. Key indicators include instructions in `CLAUDE.md` and `keyring-proxy/skill.md` to run a Docker container (`ghcr.io/builders-garden/siwa-keyring-proxy`) for key management, which is a powerful command that could be risky if the image were compromised. Additionally, `private-key/skill.md` explicitly allows using a raw private key from an environment variable, which, while accompanied by clear security warnings and recommendations for safer alternatives, represents a less secure option that could lead to vulnerabilities if mishandled by the agent or user. The skill's purpose of managing cryptographic keys and performing on-chain transactions is legitimate, and its documentation (`references/security-model.md`) demonstrates a proactive approach to security, but the high-risk capabilities prevent a 'benign' classification.
Capability Assessment
Purpose & Capability
The name/description (SIWA for ERC-8004 agents) aligns with the content: signing, verification, onchain registration, multiple signer backends, and ERC-8128 authenticated requests. The included signer adapters (Bankr, Circle, Privy, private-key, keyring proxy) are consistent with the stated purpose.
Instruction Scope
The SKILL.md and companion docs instruct the agent/operator to run CLI commands inside a workspace (e.g. /home/node/.openclaw/workspace/siwa/packages/siwa-testing), to read SIWA_IDENTITY.md, and to install/use an npm package. They also show code that expects access to environment variables and to deploy/run a keyring proxy. Those runtime instructions go beyond a simple read-only doc: they expect filesystem access, running package installs, and use of secrets. The instructions also include links to external deploy buttons and Docker images which will cause network activity and external deployments if followed.
Install Mechanism
There is no formal install spec in the registry (instruction-only), lowering installer risk. However the docs tell users to run `npm install @buildersgarden/siwa` and other package installs, and recommend deploying a keyring-proxy Docker image (ghcr.io/builders-garden/siwa-keyring-proxy) or one-click Railway deploys. That means following the docs will fetch code from npm/ghcr/railway — normal for an SDK, but you should verify those packages/images/repos before running them.
Credentials
Registry metadata lists no required environment variables, but the documentation and examples reference many sensitive variables (KEYRING_PROXY_SECRET, KEYRING_PROXY_URL, PRIVATE_KEY, BANKR_API_KEY, PRIVY_APP_SECRET, CIRCLE_API_KEY, SIWA_SECRET, etc.). This is an inconsistency: the skill will not function without secrets for many signers or server setups, yet none are declared as required. Requesting private keys or HMAC secrets is plausible for this skill's function, but the lack of explicit declared requirements is a red flag and increases the chance of accidental secret exposure if the user follows the examples carelessly.
Persistence & Privilege
The skill does not set always:true and does not request persistent elevated privileges. It is instruction-only and does not declare any automatic self-enabling behavior. Nothing in the provided files indicates it will modify other skills' configs or demand permanent presence.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install siwa
  3. After installation, invoke the skill by name or use /siwa
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.0.4
SIWA 0.0.4 brings major documentation overhaul and new wallet-specific guides. - Major overhaul of documentation for clarity and quick starts. - Added wallet-specific skill docs (Bankr, Circle, Privy, Private Key, Keyring Proxy). - Introduced a new modular SKILL.md with a concise overview of SDK modules and examples. - Dedicated server-side verification guide. - Removed outdated unified keyring skill; replaced with self-hosted proxy doc. - New sections for x402 payment flows and reverse CAPTCHA support for agent verification.
v0.0.3
**Expanded multi-wallet support and improved onboarding for ERC-8004 and SIWA.** - Added guides and code examples for integrating SIWA with Privy, Coinbase, Circle, Bankr, smart wallets, and custom wallet solutions. - Reorganized and clarified ERC-8004 agent registration instructions, including user consent prompts and metadata choices. - Introduced a unified Signer interface to simplify wallet integration for both EOA and smart contract wallets (including ERC-1271). - Added quick start, wallet selection guide, and security notices for developers. - Expanded documentation with new reference files and clearer separation of agent-side and server-side usage. - Updated and modularized assets, guides, and supporting documentation for easier integration.
v0.0.2
- Major update: Project structure and documentation have been overhauled for modularity and clarity. - Added skill-specific agent-side and server-side guides, with links to Circle, Privy, Private Key, and Keyring Proxy wallet setups. - Introduced clear SDK module breakdowns and quick reference table for all available imports. - Streamlined documentation to focus on core SIWA (Sign-In With Agent) authentication and ERC-8004 usage. - Centralized external documentation and protocol reference links for easier access.
v0.0.1
Initial release of the SIWA skill for secure Ethereum wallet operations: - Secure Ethereum wallet creation, signing, and management with private keys kept on a proxy server (never in the agent process). - Enforces use of the `@buildersgarden/siwa` SDK for all blockchain operations. - Supports wallet creation, message/transaction signing, and SIWA authentication. - Includes onchain agent registration with explicit user confirmation and metadata. - Step-by-step setup and funding instructions, plus API examples for DeFi and contract interactions. - Identity and reputation functions, onchain data registry, and authenticated API calls built in.
Metadata
Slug siwa
Version 0.0.4
License
All-time Installs 2
Active Installs 2
Total Versions 4
Frequently Asked Questions

What is Sign-in with Agent?

SIWA (Sign-In With Agent) authentication for ERC-8004 registered agents. It is an AI Agent Skill for Claude Code / OpenClaw, with 1133 downloads so far.

How do I install Sign-in with Agent?

Run "/install siwa" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Sign-in with Agent free?

Yes, Sign-in with Agent is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Sign-in with Agent support?

Sign-in with Agent is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Sign-in with Agent?

It is built and maintained by Builders Garden (@buildersgarden); the current version is v0.0.4.

💬 Comments