git404hub

what is vellum fr?

0xkinno/vellum — explained in plain English

Analysis updated 2026-05-18

0JavaScriptAudience · developerComplexity · 4/5LicenseSetup · hard

tl;dr

A tool for distributing tokens on Ethereum while keeping the payment amounts encrypted, so only each recipient can see their own share.

vibe map

mindmap
  root((vellum))
    What it does
      Confidential token distribution
      Encrypted amounts on-chain
      Recipient only decryption
    Tech stack
      JavaScript
      Zama Protocol
      Ethereum Sepolia
    Use cases
      Payroll and grants
      Private vesting
      Token wrapping
    Audience
      Developers
      Blockchain builders
    Modes
      Airdrop
      Vesting
      Disperse

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Distribute grants, payroll, or airdrops on-chain without revealing individual amounts.

VIBE 2

Run a token vesting schedule where unlock amounts stay private until claimed.

VIBE 3

Study a working example of fully homomorphic encryption applied to token transfers.

VIBE 4

Wrap an existing ERC-20 token into a confidential version for private distribution.

what's the stack?

JavaScriptSolidityEthereumZama Protocol

how it stacks up fr

0xkinno/vellum00kaku/gallery-slider-block1tsmejp/palworld-server-manager
Stars00
LanguageJavaScriptJavaScriptJavaScript
Last pushed2021-05-19
MaintenanceDormant
Setup difficultyhardeasymoderate
Complexity4/52/54/5
Audiencedevelopergeneralops devops

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · hard time til it works · 1h+

Requires an Ethereum wallet on the Sepolia test network and depends on the Zama relayer for encryption.

MIT license, free to use, modify, and share as long as the original copyright notice is kept.

in plain english

Vellum is a tool for distributing tokens on the blockchain while keeping the exact amounts private. On most public blockchains, anyone can see every payment amount, which means salaries, grants, and investor payouts are visible to competitors and to other recipients. Vellum keeps the fact that a payment happened public and verifiable, but encrypts the actual number using a technique called fully homomorphic encryption, so only the recipient can ever see how much they received. The project uses the Zama Protocol and a token standard called ERC-7984 to represent encrypted balances on Ethereum's Sepolia test network. When an operator sets up a distribution, the amounts are encrypted directly in the browser before anything is published on-chain, so the plain numbers never leave the operator's device. What gets published is a sealed value tied to a zero knowledge proof, and each recipient is individually granted permission to decrypt only their own line. Vellum supports three ways to distribute tokens. An airdrop lets recipients claim their allocation whenever they want. Vesting releases tokens on a schedule, including cliffs and gradual unlocks, calculated directly on the encrypted values. Disperse pushes every sealed amount out to recipients in one transaction, and they simply decrypt and confirm their own share afterward. All three modes run through the same underlying distributor contract and can work with any ERC-7984 token. The tool also lets an operator wrap other tokens into confidential versions with one click, handling the minting, approval, and wrapping steps automatically. It reads the underlying token and exchange rate directly from the blockchain rather than assuming them. The project is built with JavaScript, uses wallet connection libraries, and is fully deployed and testable on Sepolia, with a live demo app and example contract addresses provided.

prompts (copy fr)

prompt 1
Explain how Vellum encrypts token amounts in the browser before publishing them on-chain.
prompt 2
Walk me through the difference between Vellum's airdrop, vesting, and disperse distribution modes.
prompt 3
Help me understand how EIP-712 signing lets a recipient decrypt only their own allocation in Vellum.
prompt 4
Show me how Vellum wraps an existing token into a confidential ERC-7984 version.

Frequently asked questions

what is vellum fr?

A tool for distributing tokens on Ethereum while keeping the payment amounts encrypted, so only each recipient can see their own share.

What language is vellum written in?

Mainly JavaScript. The stack also includes JavaScript, Solidity, Ethereum.

What license does vellum use?

MIT license, free to use, modify, and share as long as the original copyright notice is kept.

How hard is vellum to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is vellum for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.