Aiken crowdfund #164

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.

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

Open

QSchlegel wants to merge 36 commits into main from aiken-crowdfund

.cursor/debug.log

-Original file line number
+Diff line change
@@ -0,0 +1,19 @@
+    {"location":"offchain.ts:421","message":"mCredential result","data":{"index":0,"credentialHashHex":"78f8a48a00f3f6b9206604c6c2944153879f8e7d4d5c1cc122855d2d","isScriptCredential":true,"credentialType":"object","credentialAlternative":1,"credentialFields":["78f8a48a00f3f6b9206604c6c2944153879f8e7d4d5c1cc122855d2d"],"credentialFieldsTypes":["string"],"hasUndefined":false},"timestamp":1768470739231,"sessionId":"debug-session","runId":"run1","hypothesisId":"C"}
+    {"location":"offchain.ts:467","message":"Pair structure created","data":{"index":0,"credential":"{\"alternative\":1,\"fields\":[\"78f8a48a00f3f6b9206604c6c2944153879f8e7d4d5c1cc122855d2d\"]}","amountBigInt":"30000000000","pairFields":["object","bigint"],"pairAlternative":0},"timestamp":1768470739235,"sessionId":"debug-session","runId":"run1","hypothesisId":"E"}
+    {"location":"offchain.ts:473","message":"beneficiaryPairs before list()","data":{"count":1,"pairs":[{"index":0,"alternative":0,"fieldsCount":2,"field0Type":"object","field1Type":"bigint","field0":"{\"alternative\":1,\"fields\":[\"78f8a48a00f3f6b9206604c6c2944153879f8e7d4d5c1cc122855d2d\"]}","field1":"30000000000"}]},"timestamp":1768470739235,"sessionId":"debug-session","runId":"run1","hypothesisId":"A"}
+    {"location":"offchain.ts:485","message":"beneficiariesList as array","data":{"isArray":true,"length":1,"firstItem":{"alternative":0,"fieldsCount":2}},"timestamp":1768470739236,"sessionId":"debug-session","runId":"run2","hypothesisId":"A"}
+    {"location":"offchain.ts:491","message":"guardrailsOption created","data":{"alternative":1,"fieldsCount":0},"timestamp":1768470739236,"sessionId":"debug-session","runId":"run2","hypothesisId":"B"}
+    {"location":"offchain.ts:488","message":"finalStructure created","data":{"alternative":2,"fieldsCount":2,"field0Type":"object","field1Type":"object","field0Keys":["0"],"field1Keys":["alternative","fields"]},"timestamp":1768470739237,"sessionId":"debug-session","runId":"run1","hypothesisId":"B"}
+    {"location":"offchain.ts:628","message":"Parameters before applyParamsToScript","data":{"authTokenPolicyId":"9584c6c3b735af39ca17947b43c5095a11c78d0559df9dfe47c9346b","proposerKeyHashHex":"3032313662376634383465333237326632346164376538643562663562653733376566316363383139643663316366643637363536623061","govActionParamType":"object","govActionParamAlt":2,"govActionParamFieldsCount":2,"poolIdHex":"f5fddd5469f8bbedb726227df2c6feaeaaeaf79aa597a1fb7f971af4","stakeDeposit":2000000,"stakeDepositType":"number","drepDeposit":500000000,"drepDepositType":"number","govDeposit":100000000000,"govDepositType":"number","allDefined":true},"timestamp":1768470739243,"sessionId":"debug-session","runId":"run2","hypothesisId":"D"}
+    {"location":"offchain.ts:628","message":"Parameters before applyParamsToScript","data":{"authTokenPolicyId":"9584c6c3b735af39ca17947b43c5095a11c78d0559df9dfe47c9346b","proposerKeyHashHex":"3032313662376634383465333237326632346164376538643562663562653733376566316363383139643663316366643637363536623061","govActionParamType":"object","govActionParamAlt":6,"govActionParamFieldsCount":0,"poolIdHex":"f5fddd5469f8bbedb726227df2c6feaeaaeaf79aa597a1fb7f971af4","stakeDeposit":2000000,"stakeDepositType":"number","drepDeposit":500000000,"drepDepositType":"number","govDeposit":100000000000,"govDepositType":"number","allDefined":true},"timestamp":1768470967173,"sessionId":"debug-session","runId":"run2","hypothesisId":"D"}
+    {"location":"offchain.ts:628","message":"Parameters before applyParamsToScript","data":{"authTokenPolicyId":"9584c6c3b735af39ca17947b43c5095a11c78d0559df9dfe47c9346b","proposerKeyHashHex":"3032313662376634383465333237326632346164376538643562663562653733376566316363383139643663316366643637363536623061","govActionParamType":"object","govActionParamAlt":6,"govActionParamFieldsCount":0,"poolIdHex":"f5fddd5469f8bbedb726227df2c6feaeaaeaf79aa597a1fb7f971af4","stakeDeposit":2000000,"stakeDepositType":"number","drepDeposit":500000000,"drepDepositType":"number","govDeposit":100000000000,"govDepositType":"number","allDefined":true},"timestamp":1768471036311,"sessionId":"debug-session","runId":"run2","hypothesisId":"D"}
+    {"location":"offchain.ts:628","message":"Parameters before applyParamsToScript","data":{"authTokenPolicyId":"9584c6c3b735af39ca17947b43c5095a11c78d0559df9dfe47c9346b","proposerKeyHashHex":"3032313662376634383465333237326632346164376538643562663562653733376566316363383139643663316366643637363536623061","govActionParamType":"object","govActionParamAlt":6,"govActionParamFieldsCount":0,"poolIdHex":"f5fddd5469f8bbedb726227df2c6feaeaaeaf79aa597a1fb7f971af4","stakeDeposit":2000000,"stakeDepositType":"number","drepDeposit":500000000,"drepDepositType":"number","govDeposit":100000000000,"govDepositType":"number","allDefined":true},"timestamp":1768471063210,"sessionId":"debug-session","runId":"run2","hypothesisId":"D"}
+    {"location":"offchain.ts:628","message":"Parameters before applyParamsToScript","data":{"authTokenPolicyId":"9584c6c3b735af39ca17947b43c5095a11c78d0559df9dfe47c9346b","proposerKeyHashHex":"3032313662376634383465333237326632346164376538643562663562653733376566316363383139643663316366643637363536623061","govActionParamType":"object","govActionParamAlt":6,"govActionParamFieldsCount":0,"poolIdHex":"f5fddd5469f8bbedb726227df2c6feaeaaeaf79aa597a1fb7f971af4","stakeDeposit":2000000,"stakeDepositType":"number","drepDeposit":500000000,"drepDepositType":"number","govDeposit":100000000000,"govDepositType":"number","allDefined":true},"timestamp":1768471228010,"sessionId":"debug-session","runId":"run2","hypothesisId":"D"}
+    {"location":"offchain.ts:628","message":"Parameters before applyParamsToScript","data":{"authTokenPolicyId":"9584c6c3b735af39ca17947b43c5095a11c78d0559df9dfe47c9346b","proposerKeyHashHex":"3032313662376634383465333237326632346164376538643562663562653733376566316363383139643663316366643637363536623061","govActionParamType":"object","govActionParamAlt":6,"govActionParamFieldsCount":0,"poolIdHex":"f5fddd5469f8bbedb726227df2c6feaeaaeaf79aa597a1fb7f971af4","stakeDeposit":2000000,"stakeDepositType":"number","drepDeposit":500000000,"drepDepositType":"number","govDeposit":100000000000,"govDepositType":"number","allDefined":true},"timestamp":1768471360648,"sessionId":"debug-session","runId":"run2","hypothesisId":"D"}
+    {"location":"offchain.ts:628","message":"Parameters before applyParamsToScript","data":{"authTokenPolicyId":"9584c6c3b735af39ca17947b43c5095a11c78d0559df9dfe47c9346b","proposerKeyHashHex":"3032313662376634383465333237326632346164376538643562663562653733376566316363383139643663316366643637363536623061","govActionParamType":"object","govActionParamAlt":6,"govActionParamFieldsCount":0,"poolIdHex":"f5fddd5469f8bbedb726227df2c6feaeaaeaf79aa597a1fb7f971af4","stakeDeposit":2000000,"stakeDepositType":"number","drepDeposit":500000000,"drepDepositType":"number","govDeposit":100000000000,"govDepositType":"number","allDefined":true},"timestamp":1768471497243,"sessionId":"debug-session","runId":"run2","hypothesisId":"D"}
+    {"location":"offchain.ts:628","message":"Parameters before applyParamsToScript","data":{"authTokenPolicyId":"9584c6c3b735af39ca17947b43c5095a11c78d0559df9dfe47c9346b","proposerKeyHashHex":"3032313662376634383465333237326632346164376538643562663562653733376566316363383139643663316366643637363536623061","govActionParamBytes":"d87f80","govActionParamBytesLength":6,"poolIdHex":"f5fddd5469f8bbedb726227df2c6feaeaaeaf79aa597a1fb7f971af4","stakeDeposit":2000000,"stakeDepositType":"number","drepDeposit":500000000,"drepDepositType":"number","govDeposit":100000000000,"govDepositType":"number","allDefined":true},"timestamp":1768471566203,"sessionId":"debug-session","runId":"run2","hypothesisId":"D"}
+    {"location":"offchain.ts:628","message":"Parameters before applyParamsToScript","data":{"authTokenPolicyId":"9584c6c3b735af39ca17947b43c5095a11c78d0559df9dfe47c9346b","proposerKeyHashHex":"3032313662376634383465333237326632346164376538643562663562653733376566316363383139643663316366643637363536623061","govActionParamBytesHex":"d87f80","govActionParamBytesHexLength":6,"govActionParamBytesHexType":"string","poolIdHex":"f5fddd5469f8bbedb726227df2c6feaeaaeaf79aa597a1fb7f971af4","stakeDeposit":2000000,"stakeDepositType":"number","drepDeposit":500000000,"drepDepositType":"number","govDeposit":100000000000,"govDepositType":"number","allDefined":true},"timestamp":1768471687703,"sessionId":"debug-session","runId":"run2","hypothesisId":"D"}
+    {"location":"offchain.ts:628","message":"Parameters before applyParamsToScript","data":{"authTokenPolicyId":"9584c6c3b735af39ca17947b43c5095a11c78d0559df9dfe47c9346b","proposerKeyHashHex":"3032313662376634383465333237326632346164376538643562663562653733376566316363383139643663316366643637363536623061","govActionParamBytesHex":"d87f80","govActionParamBytesHexLength":6,"govActionParamBytesHexType":"string","poolIdHex":"f5fddd5469f8bbedb726227df2c6feaeaaeaf79aa597a1fb7f971af4","stakeDeposit":2000000,"stakeDepositType":"number","drepDeposit":500000000,"drepDepositType":"number","govDeposit":100000000000,"govDepositType":"number","allDefined":true},"timestamp":1768472035670,"sessionId":"debug-session","runId":"run2","hypothesisId":"D"}
+    {"location":"offchain.ts:628","message":"Parameters before applyParamsToScript","data":{"authTokenPolicyId":"9584c6c3b735af39ca17947b43c5095a11c78d0559df9dfe47c9346b","proposerKeyHashHex":"3032313662376634383465333237326632346164376538643562663562653733376566316363383139643663316366643637363536623061","govActionParamBytesHex":"d87f80","govActionParamBytesHexLength":6,"govActionParamBytesHexType":"string","poolIdHex":"f5fddd5469f8bbedb726227df2c6feaeaaeaf79aa597a1fb7f971af4","stakeDeposit":2000000,"stakeDepositType":"number","drepDeposit":500000000,"drepDepositType":"number","govDeposit":100000000000,"govDepositType":"number","allDefined":true},"timestamp":1768472114078,"sessionId":"debug-session","runId":"run2","hypothesisId":"D"}
+    {"location":"offchain.ts:628","message":"Parameters before applyParamsToScript","data":{"authTokenPolicyId":"9584c6c3b735af39ca17947b43c5095a11c78d0559df9dfe47c9346b","proposerKeyHashHex":"3032313662376634383465333237326632346164376538643562663562653733376566316363383139643663316366643637363536623061","govActionParamBytesHex":"d87f80","govActionParamBytesHexLength":6,"govActionParamBytesHexType":"string","poolIdHex":"f5fddd5469f8bbedb726227df2c6feaeaaeaf79aa597a1fb7f971af4","stakeDeposit":2000000,"stakeDepositType":"number","drepDeposit":500000000,"drepDepositType":"number","govDeposit":100000000000,"govDepositType":"number","allDefined":true},"timestamp":1768472216285,"sessionId":"debug-session","runId":"run2","hypothesisId":"D"}
+    {"location":"offchain.ts:628","message":"Parameters before applyParamsToScript","data":{"authTokenPolicyId":"9584c6c3b735af39ca17947b43c5095a11c78d0559df9dfe47c9346b","proposerKeyHashHex":"3032313662376634383465333237326632346164376538643562663562653733376566316363383139643663316366643637363536623061","govActionParamBytesHex":"d87f80","govActionParamBytesHexLength":6,"govActionParamBytesHexType":"string","poolIdHex":"f5fddd5469f8bbedb726227df2c6feaeaaeaf79aa597a1fb7f971af4","stakeDeposit":2000000,"stakeDepositType":"number","drepDeposit":500000000,"drepDepositType":"number","govDeposit":100000000000,"govDepositType":"number","allDefined":true},"timestamp":1768472327948,"sessionId":"debug-session","runId":"run2","hypothesisId":"D"}

.gitignore

-Original file line number
+Diff line change
@@ Expand Up / @@ -35,6 +35,7 @@ yarn-error.log* @@
     # do not commit any .env files to git, except for the .env.example file. https://create.t3.gg/en/usage/env-variables#using-environment-variables
     .env
     .env*.local
+    /.local/
     # vercel
     .vercel
@@ Expand All / @@ -43,4 +44,4 @@ yarn-error.log* @@
     *.tsbuildinfo
     # idea files
-    .idea
+    .idea

TESTING.md

-Original file line number
+Diff line change
@@ -0,0 +1,311 @@
+    # Local Server Testing Guide
+    This guide will help you set up and test the server on your local device.
+    ## Prerequisites
+    Before testing, ensure you have:
+. **Node.js 18+** installed
+       ```bash
+       node --version  # Should be 18.x or higher
+       ```
+. **PostgreSQL database** running locally or accessible
+       - Install PostgreSQL: https://www.postgresql.org/download/
+       - Or use Docker: `docker run --name postgres -e POSTGRES_PASSWORD=password -p 5432:5432 -d postgres`
+. **npm** or **yarn** package manager
+    ## Step 1: Install Dependencies
+    ```bash
+    npm install
+    ```
+    This will also run `postinstall` which formats and generates Prisma client.
+    ## Step 2: Set Up Environment Variables
+    Create a `.env.local` file in the root directory with the following variables:
+    ```env
+    # Database
+    DATABASE_URL="postgresql://username:password@localhost:5432/multisig"
+    # Blockfrost API Keys (get from https://blockfrost.io/)
+    NEXT_PUBLIC_BLOCKFROST_API_KEY_MAINNET="your-mainnet-api-key"
+    NEXT_PUBLIC_BLOCKFROST_API_KEY_PREPROD="your-preprod-api-key"
+    # Vercel Blob Storage (get from https://vercel.com/dashboard)
+    BLOB_READ_WRITE_TOKEN="your-blob-token"
+    # GitHub Token (for API access if needed)
+    GITHUB_TOKEN="your-github-token"
+    # Optional: Skip environment validation during development
+    # SKIP_ENV_VALIDATION=true
+    ```
+    ### Getting API Keys:
+. **Blockfrost API Keys**:
+       - Visit https://blockfrost.io/
+       - Sign up for a free account
+       - Create projects for both Mainnet and Preprod networks
+       - Copy the API keys
+. **Vercel Blob Token**:
+       - Visit https://vercel.com/dashboard
+       - Go to Storage → Blob
+       - Create a new blob store
+       - Copy the read/write token
+. **GitHub Token** (optional):
+       - Visit https://github.com/settings/tokens
+       - Generate a new token with appropriate permissions
+    ## Step 3: Set Up Database
+    ### Option A: Using Prisma Migrate (Recommended)
+    ```bash
+    # Push schema to database
+    npm run db:push
+    # Generate Prisma client
+    npm run db:generate
+    ```
+    ### Option B: Using Prisma Migrate
+    ```bash
+    # Run migrations
+    npm run db:migrate
+    # Generate Prisma client
+    npm run db:generate
+    ```
+    ### Verify Database Connection
+    You can use Prisma Studio to verify the database:
+    ```bash
+    npm run db:studio
+    ```
+    This will open a browser at `http://localhost:5555` where you can view and edit your database.
+    ## Step 4: Start the Development Server
+    ```bash
+    npm run dev
+    ```
+    The server should start on `http://localhost:3000`
+    ### Expected Output:
+    ```
+    ✓ Ready in Xms
+    ○ Compiling / ...
+    ✓ Compiled / in XXXms
+    ```
+    ## Step 5: Test the Server
+    ### 1. **Check Server Health**
+    Open your browser and navigate to:
+    - **Main Application**: http://localhost:3000
+    - **API Documentation**: http://localhost:3000/api-docs (if available)
+    ### 2. **Test Wallet Connection**
+. Open http://localhost:3000
+. Click "Connect Wallet" button
+. Select a Cardano wallet extension (Nami, Eternl, etc.)
+. Verify the connection works
+    ### 3. **Test API Endpoints**
+    You can test API endpoints using curl or a tool like Postman:
+    ```bash
+    # Test health endpoint (if available)
+    curl http://localhost:3000/api/health
+    # Test wallet list endpoint
+    curl http://localhost:3000/api/v1/walletIds
+    ```
+    ### 4. **Check Console for Errors**
+    Open browser DevTools (F12) and check:
+    - Console tab for JavaScript errors
+    - Network tab for failed API requests
+    - Application tab for localStorage/sessionStorage issues
+    ## Step 6: Test Production Build (Optional)
+    To test the production build locally:
+    ```bash
+    # Build the application
+    npm run build
+    # Start production server
+    npm run start
+    ```
+    The production server will also run on `http://localhost:3000`
+    ## Troubleshooting
+    ### Issue: Environment Variables Not Found
+    **Error**: `Missing required environment variable: DATABASE_URL`
+    **Solution**:
+    - Ensure `.env.local` file exists in the root directory
+    - Check that all required variables are set
+    - Restart the development server after adding variables
+    ### Issue: Database Connection Failed
+    **Error**: `Can't reach database server`
+    **Solution**:
+    - Verify PostgreSQL is running: `pg_isready` or check Docker container
+    - Check DATABASE_URL format: `postgresql://user:password@host:port/database`
+    - Ensure database exists: `createdb multisig` (if using PostgreSQL CLI)
+    ### Issue: Prisma Client Not Generated
+    **Error**: `@prisma/client did not initialize yet`
+    **Solution**:
+    ```bash
+    npm run db:generate
+    ```
+    ### Issue: Port Already in Use
+    **Error**: `Port 3000 is already in use`
+    **Solution**:
+    - Find and kill the process: `lsof -ti:3000 | xargs kill`
+    - Or use a different port: `PORT=3001 npm run dev`
+    ### Issue: Wallet Connection Fails
+    **Error**: Wallet not detected or connection fails
+    **Solution**:
+    - Ensure you have a Cardano wallet extension installed (Nami, Eternl, etc.)
+    - Check browser console for errors
+    - Try refreshing the page
+    - Clear browser cache and localStorage
+    ### Issue: Blockfrost API Errors
+    **Error**: `401 Unauthorized` or API rate limit errors
+    **Solution**:
+    - Verify API keys are correct
+    - Check Blockfrost dashboard for rate limits
+    - Ensure you're using the correct network (mainnet vs preprod)
+    ## Testing Checklist
+    - [ ] Dependencies installed (`npm install`)
+    - [ ] Environment variables configured (`.env.local`)
+    - [ ] Database set up and connected
+    - [ ] Prisma client generated
+    - [ ] Development server starts without errors
+    - [ ] Application loads in browser
+    - [ ] Wallet connection works
+    - [ ] API endpoints respond correctly
+    - [ ] No console errors
+    - [ ] Database operations work (create wallet, transaction, etc.)
+    ## Additional Testing Commands
+    ```bash
+    # Run linter
+    npm run lint
+    # Run tests (if available)
+    npm test
+    # Type check
+    npx tsc --noEmit
+    # Format code
+    npx prettier --write .
+    ```
+    ## Test Agent + Private Faucet (Dev Only)
+    This project includes a dev-only smoke test agent for the crowdfund contract. It creates a Mesh wallet, requests funds from a private faucet, and executes a smoke flow (setup → contribute → withdraw) while streaming events to the debug UI panel.
+    ### Required Environment Variables
+    Add these to `.env.local` (values shown are examples):
+    ```env
+    # Enable the test agent panel in non-dev environments (optional)
+    NEXT_PUBLIC_ENABLE_TEST_AGENT=true
+    # Faucet wallet (used to fund the agent)
+    FAUCET_MAX_SEND_LOVELACE=200000000
+    FAUCET_MIN_BALANCE_LOVELACE=50000000
+    # Agent config
+    TEST_AGENT_POOL_ID="pool1..."
+    # Reference script address (required by crowdfund setup)
+    NEXT_PUBLIC_REF_ADDR="addr_test1..."
+    ```
+    ### Usage
+. Run `npm run dev`.
+. Open the app and connect a wallet (network is taken from the connected wallet).
+. The first time you open the panel, the app will create `./.local/test-agent-mnemonics.json` in the repo with auto-generated mnemonics for the faucet + agent wallets.
+. Use the floating **Test Agent** panel (bottom-right) to copy the faucet address and fund it once.
+. Start a run and watch the event log and React Flow state graph update in real time.
+    ### Dev Agent Info Endpoint
+    `GET /api/dev/agent/info?networkId=0`
+    Returns:
+    ```json
+    {
+      "faucetAddress": "addr_test1...",
+      "agentAddress": "addr_test1...",
+      "networkId": 0
+    }
+    ```
+    ## Next Steps
+    Once the server is running locally:
+. **Create a test wallet** to verify wallet creation flow
+. **Test transaction creation** to verify transaction flow
+. **Test multi-signature signing** to verify signing flow
+. **Check API documentation** at `/api-docs` (if available)
+. **Test on different networks** (Preprod vs Mainnet)
+    ## Getting Help
+    If you encounter issues:
+. Check the browser console for errors
+. Check the terminal output for server errors
+. Verify all environment variables are set correctly
+. Ensure database is running and accessible
+. Check the README.md for additional setup instructions

next.config.js

-Original file line number
+Diff line change
@@ Expand Up / @@ -39,6 +39,10 @@ const config = { @@
             protocol: "https",
             hostname: "ipfs.io",
           },
+          {
+            protocol: "https",
+            hostname: "*.mypinata.cloud",
+          },
           {
             protocol: "https",
             hostname: "gateway.pinata.cloud",
@@ Expand Down @@

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Aiken crowdfund #164

Uh oh!

Diff view

Diff view

There are no files selected for viewing

Uh oh!

Aiken crowdfund #164

Are you sure you want to change the base?

Uh oh!

Aiken crowdfund #164

Uh oh!

Uh oh!

Diff view

Diff view

There are no files selected for viewing

Uh oh!