verifiable-ai-dao

Warning

The Shade Agent Framework is experimental and contains known critical vulnerabilities.

It must not be used in production or on mainnet and is intended solely for testing and non-critical use on testnet.

No representations or warranties are made regarding security, correctness, or fitness for any purpose. Use of this software is entirely at your own risk.

A production-ready version of the framework is currently in development.

This example is a DAO that blends NEAR smart contracts, yield-resume, Shade Agents, and verifiable AI all together.

When the user makes a makes a proposal to the DAO via a function call to the smart contract on NEAR, the contract halts its execution and files a new proposal in the contract, the Shade Agent indexes this proposal and calls NEAR AI's private/verifiable AI to make a decision on the proposal based on the DAO's manifesto, then submits the decision back to the contract when it resumes its execution and stores the proposal and decision in a list of finalized proposals.

This example shows:

• Using a NEAR smart contract with a Shade Agent.
• Having a Shade Agent fulfill a yield-resume request.
• A Shade Agent using verifiable AI.

This is the best way to add verifiable AI to a smart contract where the agent and LLM essentially becomes a part of the contract.

Please note that whilst the example uses NEAR AI's private/verifiable AI endpoints, the example does not yet actually verify the AI inside of the Shade Agent yet (this is TODO).

Agent - Smart Contract - Frontend

---

Prerequisites

• First, clone this repository

  git clone https://github.com/NearDeFi/verifiable-ai-dao
  cd verifiable-ai-dao

• Install NEAR and Shade Agent tooling:

  # Install the NEAR CLI
  curl --proto '=https' --tlsv1.2 -LsSf https://github.com/near/near-cli-rs/releases/latest/download/near-cli-rs-installer.sh | sh
  
  # Install the Shade Agent CLI
  npm i -g @neardefi/shade-agent-cli

• Create a NEAR testnet account and record the account name and seed phrase:

  export ACCOUNT_ID=example-name.testnet
  near account create-account sponsor-by-faucet-service $ACCOUNT_ID autogenerate-new-keypair save-to-keychain network-config testnet create

  replacing example-name.testnet with a unique account ID

• Set up Docker if you have not already:

  • Install Docker for Mac or Linux and create an account

  • Log in to Docker, using docker login for Mac or sudo docker login for Linux

• Set up a free Phala Cloud account at https://cloud.phala.network/register, then get an API key from https://cloud.phala.network/dashboard/tokens

• Get a NEAR AI API key at https://cloud.near.ai/dashboard/keys (you will need to fund your account)

---

Set up

• Rename the .env.development.local.example file name to .env.development.local and configure your environment variables

• Start up Docker:

  For Mac

  Simply open the Docker Desktop application or run:

  open -a Docker

  For Linux

  sudo systemctl start docker

• Install dependencies

  npm i

---

Local development

• Comment out the require approved code hash line so it works for local deployment

• Compile the contract

  For Mac

  cd contract
  docker run --rm -v "$(pwd)":/workspace pivortex/near-builder@sha256:cdffded38c6cff93a046171269268f99d517237fac800f58e5ad1bcd8d6e2418 cargo near build non-reproducible-wasm

  For Linux

  cd contract
  cargo near build non-reproducible-wasm

• Make sure the NEXT_PUBLIC_contractId prefix is set to ac-proxy. followed by your NEAR accountId

• In one terminal, run the Shade Agent CLI with the wasm flag to deploy a custom contract and the funding flag:

  shade-agent-cli --wasm contract/target/near/contract.wasm --funding 7 

  The CLI on Linux may prompt you to enter your sudo password.

• In another terminal, start your app:

  npm run dev

---

TEE Deployment

• Re-introduce the require approved code hash line so it requires the agent to be running in a TEE

• Compile the contract

  For Mac

  cd contract
  docker run --rm -v "$(pwd)":/workspace pivortex/near-builder@sha256:cdffded38c6cff93a046171269268f99d517237fac800f58e5ad1bcd8d6e2418 cargo near build non-reproducible-wasm

  For Linux

  cd contract
  cargo near build non-reproducible-wasm

• Change the NEXT_PUBLIC_contractId prefix to ac-sandbox. followed by your NEAR accountId.

• Run the Shade Agent CLI with the wasm flag to deploy a custom contract and the funding flag

  shade-agent-cli --wasm contract/target/near/contract.wasm --funding 7

  The CLI on Linux may prompt you to enter your sudo password.

---

Interacting with the protocol

• Set the manifesto in the contract

  near contract call-function as-transaction <contractId> set_manifesto json-args '{"manifesto_text": "This DAO only approves gaming related proposals and rejects everything else"}' prepaid-gas '100.0 Tgas' attached-deposit '0 NEAR' sign-as <accountId> network-config testnet sign-with-seed-phrase '<seed phrase>' --seed-phrase-hd-path 'm/44'\''/397'\''/0'\''' send

  Replacing the (ac-sandbox.NEAR_ACCOUNT_ID), (NEAR_ACCOUNT_ID), , and optionally the manifesto text.

• Set your contractId in the frontend's config.js file

• Start the frontend

cd frontend
npm i
npm run dev