OpenViSTAI · Agents · Blockchain · Crypto
Submit a project
Menu
Smart Contracts

Circles Contracts

Circles Contracts is an open-source JavaScript/npm package of Ethereum smart contracts for the Circles UBI system, a decentralized Universal Basic Income platform based on personal currencies. Its Token contracts support owner-directed UBI minting and transitive transfers, while its Hub manages system variables, trust connections and related exchanges.

Explore the practical guide ↓

Independent OpenViST project profile, based on linked sources.

Circles Contracts — OpenViST project profile in Smart Contracts.
OpenViST project illustration. See the linked sources for product details.
Understand the project

Practical overview

When it fits

Use it when building Ethereum applications that need Circles token deployment, trust-graph connections or transitive token transfers.

Who it is for

  • Developers building clients that invoke Circles Hub signup, trust or transitive transaction methods.
  • Teams creating personal-currency UBI systems or trust-graph-based token exchange applications.

Documented uses

  • Deploy a Circles token through the Hub's signup method.
  • Create trust connections between accounts within a Hub.
  • Support transitive transfers among tokens deployed by the same Hub.
  • Develop and run the repository's contract tests on a local blockchain.
Before you choose

Requirements & limits

The project is publicly available on GitHub and identifies its license as AGPL-3.0. The documented package installation requires Node.js version 14.

  • Transitive transfers are limited to tokens associated with the same Hub.
  • The Hub's system parameters are immutable, and it has no owner.
  • Testing uses Truffle, Mocha and Chai with Ganache CLI and a local blockchain.
  • The repository is JavaScript-based and licensed under AGPL-3.0.

Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.

Source-based practical guide

Install Circles Contracts for Node.js development

Install the npm package and its development dependencies.

Before you start

  • Node.js version 14

Steps

  1. Install the package with the command below.

    Documented command
    npm i @circles/circles-contracts

  2. In a development checkout, run the command below to install the required dependencies.

    Documented command
    npm install

Expected outcome

The package is installed, and a development checkout has its dependencies installed.

Guide limitations

  • These steps cover installation only; they do not configure a production network or deploy contracts.
Documentation 1 ↗
Source-based practical guide

Run the repository's contract tests

Rebuild the contracts and tests, then run the project's JavaScript test suite.

Before you start

  • Node.js version 14
  • A development checkout with dependencies installed

Steps

  1. Run the command below to install required dependencies.

    Documented command
    npm install

  2. Run the command below to rebuild the contracts and tests and execute the tests in the test directory.

    Documented command
    npm test

Expected outcome

The documented test suite runs against a local blockchain started by Ganache CLI, unless one is already running.

Guide limitations

  • The described test setup uses a local chain and does not document production deployment.
Documentation 1 ↗
Evidence and transparency

Sources & review

Official repository ↗
Source record details
Source availability
Active
Sources checked
9 October 2026
Original website title
CirclesUBI/circles-contracts · Official homepage title · retained in its source language
How we review sourcesSuggest a correction