eShares Developer Documentation
Everything you need to understand, integrate, and build on the eShares tokenization platform.
Getting Started
eShares is a tokenized equity management platform that converts ownership rights into programmable ERC-20 tokens. The platform handles everything from domain registration and equity configuration to token minting, vesting enforcement, and governance.
Prerequisites
- • Node.js 18+ and npm/yarn
- • Web3 wallet (MetaMask, Coinbase Wallet, or Trust Wallet)
- • Base or BNB Chain RPC endpoint (for mainnet deployments)
- • eShares API key (obtain from dashboard)
# Install the SDK
npm install @eshares/sdk
# Initialize
npx eshares init --domain yourdomain.com
# Deploy contracts
npx eshares deploy --network polygon
# Mint tokens
npx eshares mint --supply 1000000 --symbol ESH
User Types
The eShares platform supports five distinct user roles with varying access levels.
| Role | Access Level | Permissions |
|---|---|---|
| Super Admin | Highest | Full platform control, contract deployment, system configuration |
| Domain Owner | High | Manage domain equity, configure tiers, approve contributors |
| Contributor | Standard | Submit contributions, earn tokens, participate in governance |
| Investor | Standard | View portfolio, trade tokens, vote on proposals |
| Viewer | Limited | Read-only access to public equity data and governance records |
Equity Pies (Default Distribution)
Every domain starts with a default equity distribution that can be customized.
40%
Founders
Core team members with vesting schedules
25%
Contributors
Employees, contractors, and active contributors
20%
Investors
Angel, seed, and institutional investors
10%
Advisors
Strategic advisors with milestone-based vesting
5%
Reserve
Treasury reserve for future allocations
Contribution Flow
How contributions are submitted, validated, and rewarded with ESH tokens.
Contributor submits work (code, content, design, etc.) via the eShares dashboard or API.
Domain owner or AgentDAO reviews and validates the contribution.
Approved contributions are scored based on type, impact, and tier.
ESH tokens are allocated from the contributor pool based on the score.
Tokens are distributed to the contributor's wallet, subject to any vesting schedule.
Smart Contracts
Five core contracts power the eShares tokenization engine.
Stores asset metadata, valuations, contributor records, and equity configurations.
Registers domain identities and links real-world assets to on-chain records.
The equity token — minted, distributed, and traded as the unit of ownership.
Manages time-based and milestone-based token release schedules.
Enables cross-chain token transfers between Base and BNB Chain.
ESH Token Logic
Token Specification
Standard
ERC-20
Symbol
ESH
Decimals
18
Default Supply
1,000,000 ESH per domain
Mintable
Yes (by domain owner)
Burnable
Yes (with governance approval)
Each domain mints its own ESH token supply. Tokens represent proportional equity in the domain or entity. Transfer restrictions, vesting locks, and compliance checks are enforced at the contract level — meaning tokens cannot be transferred to non-compliant addresses or before vesting conditions are met.
Compliance & Governance
Compliance
- ✓ KYC/AML verification on all token holders
- ✓ Accredited investor checks for regulated offerings
- ✓ Jurisdiction-specific transfer restrictions
- ✓ Automated reporting and audit trails
Governance
- ✓ Token-weighted voting on proposals
- ✓ Configurable quorum and approval thresholds
- ✓ On-chain proposal submission and execution
- ✓ Delegation and proxy voting support
API Endpoints
RESTful API for integrating eShares into your applications.
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/domains | List all registered domains |
| GET | /api/v1/domains/:id/equity | Get equity structure for a domain |
| POST | /api/v1/contributions | Submit a new contribution |
| GET | /api/v1/tokens/:address/balance | Get token balance for an address |
| POST | /api/v1/governance/proposals | Create a governance proposal |
| GET | /api/v1/governance/proposals/:id | Get proposal details and vote status |
| POST | /api/v1/vesting/schedules | Create a vesting schedule |
| GET | /api/v1/audit/logs | Retrieve audit log entries |
Example Use Cases
A 3-person startup tokenizes their cap table on day one, distributing ESH tokens to founders with 4-year vesting and 1-year cliff.
A domain investor tokenizes a portfolio of 50 premium domains, enabling fractional ownership and secondary trading for each asset.
A 200-member DAO uses eShares governance contracts to manage proposals, voting, and treasury allocations with on-chain enforcement.
A 500-person company manages employee stock option plans across 3 jurisdictions with automated compliance and real-time dashboards.
Audit, Logs & Security
Every action on the eShares platform generates an immutable audit log entry. From token transfers and vesting releases to governance votes and compliance checks — everything is recorded on-chain and accessible via the API.
256-bit
AES Encryption
Multi-sig
Contract Admin
SOC 2
Compliance Ready
Ready to integrate?
Start building on eShares today with our SDK, APIs, and open-source smart contracts.