Skip to content

siwe llms.txt railway and demo #26

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
0xthrpw merged 1 commit into from
Sep 10, 2025
Merged

siwe llms.txt railway and demo #26

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 26 additions & 6 deletions public/llms/siwe/llms-full.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,18 +2,19 @@

> Offering resources and guidance for integrating Sign-In with Ethereum, enhancing user control over digital identities in web applications, while promoting best practices and supporting community involvement within the Ethereum ecosystem.

> Updated at: 21:35 08/27/25
> Updated at: 23:25 09/09/25

# ⭐ Deployment Guide

This guide covers deploying the SIWE OIDC Provider in production environments. Choose from multiple deployment options based on your infrastructure needs.

## Deployment Options

The SIWE OIDC Provider can be deployed in two primary modes:
The SIWE OIDC Provider can be deployed in three primary modes:

1. **[Cloudflare Workers](#cloudflare-workers-deployment)** - Serverless, globally distributed
2. **[Standalone Binary](#standalone-binary-deployment)** - Self-hosted with full control
1. **[Railway Template](#railway-template-deployment)** - Preconfigured and easily deployed
2. **[Cloudflare Workers](#cloudflare-workers-deployment)** - Serverless, globally distributed
3. **[Standalone Binary](#standalone-binary-deployment)** - Self-hosted with full control

## Prerequisites

Expand All @@ -34,6 +35,15 @@ The SIWE OIDC Provider can be deployed in two primary modes:
- **Cloudflare account** with Workers enabled
- **Wrangler CLI** installed locally

## Railway Template Deployment

Railway is a platform that allows users to easily deploy and manage services and environments.

Deploying the SIWE-OIDC template on Railway is the easiest option to deploy the service and is as simple as clicking the button below. The template is preconfigured and only requires you to create a Railway account if you don't already have one, and enter in a Re-Own (Wallet Connect) project ID.

<a href="https://railway.com/deploy/siwe-oidc?referralCode=98Kre1" target="_blank" rel="noopener noreferrer"><img src="https://railway.com/button.svg" alt="Deploy on Railway" /></a>


Comment on lines +38 to +46
Copy link

@coderabbitai coderabbitai bot Sep 10, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Verification agent

🧩 Analysis chain

Railway section: tighten wording and verify deploy URL/domain.

  • Copy/grammar: simplify “enter in a Re-Own (Wallet Connect) project ID” and use current WalletConnect branding.
  • SEO/compliance: consider adding nofollow to referral link.

Proposed edits:

- Deploying the SIWE-OIDC template on Railway is the easiest option to deploy the service and is as simple as clicking the button below.  The template is preconfigured and only requires you to create a Railway account if you don't already have one, and enter in a Re-Own (Wallet Connect) project ID.
+ Deploying the SIWE-OIDC template on Railway is the easiest way to get started—click the button below. The template is preconfigured and only requires a Railway account and a WalletConnect Cloud Project ID.
- <a href="https://railway.com/deploy/siwe-oidc?referralCode=98Kre1" target="_blank" rel="noopener noreferrer"><img src="https://railway.com/button.svg" alt="Deploy on Railway" /></a>
+ <a href="https://railway.com/deploy/siwe-oidc?referralCode=98Kre1" target="_blank" rel="noopener noreferrer nofollow"><img src="https://railway.com/button.svg" alt="Deploy on Railway" /></a>

Please also confirm the official deploy button domain/path (railway.com vs railway.app) and that the template slug is correct:

🌐 Web query:

What is Railway’s current official deploy button URL/domain (railway.app vs railway.com) and the correct path format for template deploy links?

💡 Result:

Short answer: use railway.com for the official "Deploy on Railway" button image and template deploy URL — e.g.:

Notes: Railway’s docs sometimes show railway.app links in examples, but the official "Publish and Share Templates" doc uses railway.com/button.svg and the /new/template/ path. [1][2]

Sources:
[1] Railway docs — Publish and Share Templates (railway.com).
[2] Railway docs — Templates / Deploy examples (railway.app / railway.com examples).

Railway section: tighten wording, update deploy URL path & add nofollow

  • Simplify copy and use current WalletConnect branding.
  • Update deploy link to use railway.com/new/template/… and add nofollow to rel.
- Deploying the SIWE-OIDC template on Railway is the easiest option to deploy the service and is as simple as clicking the button below.  The template is preconfigured and only requires you to create a Railway account if you don't already have one, and enter in a Re-Own (Wallet Connect) project ID.
+ Deploying the SIWE-OIDC template on Railway is the easiest way to get started—click the button below. The template is preconfigured and only requires a Railway account and a WalletConnect Cloud Project ID.
- <a href="https://railway.com/deploy/siwe-oidc?referralCode=98Kre1" target="_blank" rel="noopener noreferrer"><img src="https://railway.com/button.svg" alt="Deploy on Railway" /></a>
+ <a href="https://railway.com/new/template/siwe-oidc?referralCode=98Kre1" target="_blank" rel="noopener noreferrer nofollow"><img src="https://railway.com/button.svg" alt="Deploy on Railway" /></a>
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
## Railway Template Deployment
Railway is a platform that allows users to easily deploy and manage services and environments.
Deploying the SIWE-OIDC template on Railway is the easiest option to deploy the service and is as simple as clicking the button below. The template is preconfigured and only requires you to create a Railway account if you don't already have one, and enter in a Re-Own (Wallet Connect) project ID.
<a href="https://railway.com/deploy/siwe-oidc?referralCode=98Kre1" target="_blank" rel="noopener noreferrer"><img src="https://railway.com/button.svg" alt="Deploy on Railway" /></a>
## Railway Template Deployment
Railway is a platform that allows users to easily deploy and manage services and environments.
Deploying the SIWE-OIDC template on Railway is the easiest way to get started—click the button below. The template is preconfigured and only requires a Railway account and a WalletConnect Cloud Project ID.
<a href="https://railway.com/new/template/siwe-oidc?referralCode=98Kre1" target="_blank" rel="noopener noreferrer nofollow"><img src="https://railway.com/button.svg" alt="Deploy on Railway" /></a>
🤖 Prompt for AI Agents 
In public/llms/siwe/llms-full.txt around lines 38–46, simplify and tighten the
Railway deployment copy, replace the deploy URL path to use
railway.com/new/template/siwe-oidc (instead of
railway.com/deploy/siwe-oidc?referralCode=...), update the WalletConnect
branding text to a concise "WalletConnect project ID", and add rel="noopener
noreferrer nofollow" to the anchor tag; keep the paragraph short and clear that
the template is preconfigured and only requires a Railway account and your
WalletConnect project ID.

## Cloudflare Workers Deployment

Cloudflare Workers provide a serverless, globally distributed deployment option.
Expand Down Expand Up @@ -441,6 +451,16 @@ Axum and Redis) and (2) a WASM module within a Cloudflare Worker. Both are built
from the same codebase, specializing at build time. Compilation with a `cargo` target
of `wasm32` will build for Cloudflare Worker deployments.

## Demo

A demo site is available that demonstrates how the OIDC flow works in production

<FullWidthLink
href='https://oidc-demo.siwe.xyz'
logo='/img/logo.svg'
text='signinwithethereum/oidc-demo'
/>
<br />
---

import FullWidthLink from '@site/src/components/full-width-link'
Expand Down Expand Up @@ -853,12 +873,12 @@ Create two files:
`message.txt`:

```
login.xyz wants you to sign in with your Ethereum account:
siwe.xyz wants you to sign in with your Ethereum account:
0xfA151B5453CE69ABf60f0dbdE71F6C9C5868800E

Sign in with Ethereum Example Statement

URI: https://login.xyz
URI: https://siwe.xyz
Version: 1
Chain ID: 1
Nonce: ToTaLLyRanDOM
Expand Down