SynArc

Installation

npm install @synarc/agent-sdk

Install uv tool suite (if not present)

curl -LsSf https://astral.sh/uv/install.sh | sh

Install the Canteen ARC CLI

uv tool install git+https://github.com/the-canteen-dev/ARC-cli ```

Once installed, use the following commands: arc-canteen login - Log into your Canteen developer account. arc-canteen rpc-url - Fetch your personalized, high-performance Arc RPC endpoint. * arc-canteen update product - Sync your latest product status with the Canteen registry.

Centralized 4-Endpoint RPC Resiliency Chain

To ensure uninterrupted uptime for our users and AI agents, the SynArc frontend implements a centralized sequential fallback resolver traversing four RPC nodes in priority order: 1. Personalized Canteen RPC (process.env.NEXT_PUBLIC_ARC_RPC_URL) 2. Arc Testnet Public RPC (https://rpc.testnet.arc.network) 3. dRPC Arc Testnet Node (https://arc-testnet.drpc.org) 4. Thirdweb Arc Testnet Node (https://5042002.rpc.thirdweb.com)

If the primary endpoint experiences rate limits or downtime, the system transparently loops through the fallback nodes to maintain client connectivity.

---

10. Deployment

Live Deployment

https://www.synarcdao.xyz/

Deploying to Vercel

1. Install the Vercel CLI globally:

    npm install -g vercel
    

    vercel --prod
    

10a. Deployed Contracts & Network Reference

Below is the official network configuration and deployed smart contract addresses for SynArc on the Arc Testnet (chainId: 5042002).

ℹ️ All contracts are deployed on Arc Testnet. Verified contracts have direct explorer links.

---

Quickstart Example

import { SynArcAgent } from '@synarc/agent-sdk';

// Initialize agent client
const agent = new SynArcAgent({ 
  rpcUrl: 'https://rpc.testnet.arc.network',
  privateKey: process.env.PRIVATE_KEY 
});

// Register ERC-8004 on-chain agent identity
await agent.registerIdentity({
  name: "Autonomous Portfolio Rebalancer",
  capabilities: ["treasury-monitoring", "cctp-rebalancing"],
  metadataUri: "https://metadata.synarcdao.xyz/agents/rebalancer-01.json"
});

// Cast a programmatic vote on a proposal
const proposalId = "0x...";
await agent.vote(proposalId, 1 /* For */);

• npm Package: @synarc/agent-sdk
• Repository: kellycryptos/synarc-agent-sdk
• Documentation: synarcdao.xyz/docs/sdk

---

Privy Production Settings

1. Log into your dashboard at privy.io.
2. Add your production URL to the Allowed Origins whitelist.
3. Ensure the "Embedded Wallets" toggle is set to Enabled under login methods.

---

3d. Developer Agent SDK

Integrate autonomous agents and decentralized organizations programmatically using the @synarc/agent-sdk npm package.

Canteen ARC CLI & Resilient RPC Fallbacks

SynArc is integrated with the Canteen Builder Program, providing personalized high-performance RPC connections and gasless transaction routing for all critical treasury and governance operations.

CLI Installation & Commands

To manage and retrieve your personalized Canteen RPC endpoints, install the Canteen ARC CLI tool:

```bash

3e. Circle & Agent Integrations

SynArc integrates with the Circle ecosystem and autonomous systems to power its rebalancing, governance, and onboarding systems:

• Circle CCTP (Cross-Chain Transfer Protocol) — Fully Deployed & Functional: Handles native burn-and-mint USDC routing between Arc Testnet and Ethereum Sepolia. In lib/agent/cctp-executor.ts, the system executes burns, polls Circle's Iris attestation API for validation consensus, and triggers mint receipts on the destination Messenger contract.
• Circle Gateway (x402 Nanopayments) — Simulated/Planned: Tracks AI model execution fees for each inference call in lib/agent/gateway-payments.ts. The codebase contains hooks to deduct USDC internally for every Groq API request, awaiting live production endpoints to route actual on-chain fee payments.
• Modular Wallets (ERC-4337 & Social Auth) — Fully Deployed & Functional: Provisioned dynamically for users using Privy social logins and Circle's Web3 Services (W3S). In lib/tx-helper.ts, transactions submitted by Circle embedded wallets are routed via custom EIP-1193 providers and sponsored gaslessly via paymasters.
• Groq AI — Fully Deployed & Functional: Powers the agent's real-time treasury analysis engine in lib/agent/treasury-agent.ts. The agent script calls the Groq SDK using the Groq AI Engine to evaluate current balances and autonomously execute or queue rebalancing decisions.
• ERC-8004 Identity Registry — Fully Deployed & Functional: The SynArcAgent.sol contract implements the IERC8004Registry interface. Upon deployment, the agent calls the registry contract at 0x8004A818BFB912233c491871b3d84c89A494BD9e to register its identity, capabilities, and IPFS metadata on-chain.

---

Web3 Integration

• Authentication & Embedded Wallets: Privy
• Ethereum Provider Interface: Wagmi 2
• Low-Level Client Library: Viem 2