Skip to content

Commit

Permalink
Merge branch 'main' of github.com:d4mr/zkrail
Browse files Browse the repository at this point in the history
  • Loading branch information
d4mr committed Dec 7, 2024
2 parents e87dc60 + b26a908 commit 0783f3c
Show file tree
Hide file tree
Showing 25 changed files with 7,630 additions and 51 deletions.
47 changes: 0 additions & 47 deletions .github/workflows/lint.yaml
Original file line number Diff line number Diff line change
@@ -1,47 +0,0 @@
name: Lint

on:
push:
branches:
- main
pull_request:
branches:
- main

jobs:
ci:
runs-on: ${{ matrix.os }}

strategy:
matrix:
os: [ubuntu-latest]
node: [lts/*]

steps:
- name: Checkout
uses: actions/checkout@master

- name: Setup node env
uses: actions/setup-node@v3
with:
node-version: ${{ matrix.node }}
cache: yarn

- name: Install dependencies
run: yarn install --immutable

- name: Install foundry-toolchain
uses: foundry-rs/foundry-toolchain@v1
with:
version: nightly

- name: Run foundry node, deploy contracts (& generate contracts typescript output)
env:
ETHERSCAN_API_KEY: ${{ secrets.ETHERSCAN_API_KEY }}
run: yarn chain & yarn deploy

- name: Run nextjs lint
run: yarn next:lint --max-warnings=0

- name: Check typings on nextjs
run: yarn next:check-types
141 changes: 140 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,142 @@
<div align="center">
<h1>ZKRails</h1>
<p><strong>Decentralized UPI Payments powered by Zero Knowledge Proofs</strong></p>

![image](https://github.com/user-attachments/assets/c90534d8-7b51-42bb-bd2f-6aed89da92ec)


<p>
<a href="#features">Features</a> •
<a href="#architecture">Architecture</a> •
<a href="#quick-start">Quick Start</a> •
<a href="#development">Development</a>
</p>

<p>
<img src="https://img.shields.io/badge/Base-Sepolia-blue" alt="Base Sepolia" />
<img src="https://img.shields.io/badge/USDC-Payments-green" alt="USDC Payments" />
<img src="https://img.shields.io/badge/AI-Powered-purple" alt="AI Powered" />
</p>
</div>

## 🌟 Overview

ZKRail is a revolutionary payment infrastructure that bridges traditional UPI payments with blockchain technology using zero-knowledge proofs. It enables secure, private, and efficient cross-border payments while maintaining the simplicity of UPI transactions.

## 🎯 Use Cases

- **Cross-Border Remittances**: Send money internationally using UPI
- **Private Business Payments**: Keep transaction details confidential
- **Decentralized Payment Networks**: Build on top of our intent-based architecture
- **AI-Enhanced Payments**: Natural language payment processing

## ✨ Features

- **UPI Integration**: Send payments to any UPI ID directly from your crypto wallet
- **Zero-Knowledge Privacy**: Transaction details are kept private using ZK proofs
- **AI-Powered CLI**: Natural language interface for initiating payments
- **Cross-Border Support**: Seamless international payments using USDC
- **Intent-Based Architecture**: Decentralized intent matching for optimal payment routing
- **Bond-Based Security**: Solver bonding mechanism ensures payment reliability

## 🏗 Architecture

![image](https://github.com/user-attachments/assets/3fbc49a3-ee37-42b9-a0f1-2d8fd9594b78)


## 🚀 Technical Stack

- **Smart Contracts**: Solidity, Foundry
- **Backend**: TypeScript, Node.js
- **AI Integration**: GPT-4, LangChain
- **Blockchain**: Base Sepolia Network
- **Payment**: USDC, UPI
- **Privacy**: Zero Knowledge Proofs
- **SDK**: Coinbase Cloud CDP

## 🚀 Quick Start

1. Install dependencies:

```bash
yarn install
```

2. Set up your environment variables:

```bash
cp .env.example .env
# Add your API keys and configuration
```

3. Start the payment CLI:

```bash
yarn cli
```

4. Make your first payment:

```bash
transfer 100 rs to user@upi
```

## 🛠 Development

### Prerequisites

- Node.js >= v18.18
- Yarn
- Foundry
- Coinbase Cloud API Keys

### Environment Variables

```bash
CDP_API_KEY_NAME=your_api_key_name
CDP_API_KEY_PRIVATE_KEY=your_private_key
OPENAI_API_KEY=your_openai_key
```

### Local Setup

1. Clone the repository:

```bash
git clone https://github.com/your-username/zkrail.git
cd zkrail
```

2. Install dependencies:

```bash
yarn install
```

3. Start local blockchain:

```bash
yarn chain
```

4. Deploy contracts:

```bash
yarn deploy
```

5. Run the development server:

```bash
yarn dev
```

## 📜 License

MIT License - see [LICENSE](LICENSE) for details

---

# 🏗 Scaffold-ETH 2

<h4 align="center">
Expand Down Expand Up @@ -77,4 +216,4 @@ To know more about its features, check out our [website](https://scaffoldeth.io)

We welcome contributions to Scaffold-ETH 2!

Please see [CONTRIBUTING.MD](https://github.com/scaffold-eth/scaffold-eth-2/blob/main/CONTRIBUTING.md) for more information and guidelines for contributing to Scaffold-ETH 2.
Please see [CONTRIBUTING.MD](https://github.com/scaffold-eth/scaffold-eth-2/blob/main/CONTRIBUTING.md) for more information and guidelines for contributing to Scaffold-ETH 2.
Loading

0 comments on commit 0783f3c

Please sign in to comment.