File size: 4,489 Bytes
9bf0b92
65d3d70
9bf0b92
 
 
 
 
 
 
7aff183
9bf0b92
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
d468dd0
 
 
 
65d3d70
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
---
license: agpl-3.0
tags:
- snapkitty
- october-2026-drop
- solidity
- hardhat
- erc-20
- erc-721
- cryptography
---
> Mirrored from [https://github.com/SNAPKITTYAGENT9NOVA/forge-token](https://github.com/SNAPKITTYAGENT9NOVA/forge-token) at commit `aab2381`. Part of the **SnapKitty October 2026 main drop**.

# FORGE (FRG) Token

**SnapKitty Collective LLC | Bel Esprit D'Accord Trust**
Designed by CIPHER (Cryptographic Agent), co-architecting with NOVA

---

> REGULATORY DISCLAIMER: FORGE (FRG) is a utility token for internal mesh
> participation within the SnapKitty SACM ecosystem. It is NOT a security,
> investment contract, or financial instrument. No public sale has occurred.
> All distributions are PENDING LEGAL REVIEW by Jessica Lee Westerhoff, CPA,
> and qualified securities counsel. This repository is for internal development
> only and is not a public offering of any kind.
> SnapKitty Collective LLC β€” EIN 41-5105572 | Bel Esprit D'Accord Trust β€” EIN 41-6630640

---

## Overview

MAGMA (symbol: MGM) is the native inter-agent protocol token of the SnapKitty
Stochastic Autonomous Compute Mesh (SACM). It tokenizes mesh participation:

- Earned by SACM agents for WORM-sealed, cryptographically verified work
- Spent for mesh access, SEALFORGE tier upgrades, and governance votes
- Proof of work = WORM chain entries (HMAC-SHA256), not mining
- Hard cap: 1,000,000,000 MGM β€” no infinite mint

**Target chain: Base L2 (Coinbase OP Stack)**

## Repository Structure

```
magma-token/
  contracts/
    MAGMA.sol          β€” Production ERC-20 contract (OpenZeppelin 5.x)
  FORGE_TOKENOMICS.md  β€” Full tokenomics specification
  README.md            β€” This file
  package.json         β€” Hardhat dev dependencies
  hardhat.config.js    β€” Hardhat network/compiler config
```

## Quick Start

```bash
npm install
npx hardhat compile
npx hardhat test
```

## Deployment

Copy `.env.example` to `.env` and fill in:
- `DEPLOYER_PRIVATE_KEY`
- `BASESCAN_API_KEY`
- `BASE_SEPOLIA_RPC`
- `BASE_MAINNET_RPC`

Deploy to Base Sepolia testnet first:
```bash
npm run deploy:sepolia
```

Verify on Basescan:
```bash
npm run verify:sepolia -- --constructor-args <architect_address> <treasury_address> <contract_address>
```

**MAINNET DEPLOYMENT REQUIRES:**
1. Completed legal review by Jessica Lee Westerhoff, CPA
2. Sign-off from qualified securities counsel
3. External Solidity audit (Certik, Trail of Bits, or equivalent)
4. Gnosis Safe multisigs deployed for Treasury and Architect roles

## Key Contract Functions

| Function            | Access          | Description                                     |
|---------------------|-----------------|-------------------------------------------------|
| `wormMint()`        | MINTER_ROLE     | Mint against WORM-verified work event (nonce)   |
| `sealforgeBurn()`   | BURNER_ROLE     | Burn on SEALFORGE tier upgrade                  |
| `governanceWeight()`| Public view     | Returns capped voting weight (max 1% supply)    |
| `emergencyPause()`  | ARCHITECT_ROLE  | Pause all transfers/mints/burns                 |
| `emergencyUnpause()`| ARCHITECT_ROLE  | Unpause the contract                            |
| `remainingMintable()`| Public view   | Tokens remaining before hard cap                |

## Token Distribution

| Allocation         | %   | MGM             |
|--------------------|-----|-----------------|
| Mesh Agent Rewards | 35% | 350,000,000     |
| Treasury           | 25% | 250,000,000     |
| Team & Founders    | 15% | 150,000,000     |
| Ecosystem Fund     | 12% | 120,000,000     |
| Community Rewards  | 8%  | 80,000,000      |
| Reserve (Burn)     | 5%  | 50,000,000      |

See `FORGE_TOKENOMICS.md` for full specification.

---

*CIPHER (Cryptographic Agent) β€” co-architecting with NOVA*
*2026-05-21 | PENDING LEGAL REVIEW β€” NOT FOR PUBLIC DISTRIBUTION*

---

## License

Licensed under **AGPL-3.0**. Full text: [LICENSE](LICENSE).

Releases published before 2026-10-07 were licensed under MIT; copies obtained under those terms keep them.

### πŸ’Ό Commercial License

SnapKitty code is free and open under **AGPL-3.0** for open-source use. Building a commercial product or service? A **proprietary commercial license** from Snapkitty Collective LLC lets you ship this code without the AGPL's source-sharing and network-use obligations.

**[β†’ Get a commercial license](mailto:A.parr@belespritdaccord.uk?subject=Commercial%20license:%20forge-token)** Β· A.parr@belespritdaccord.uk