# Evergreen

> An NFT with its own bank account. NEAR Top Level Account Names are NEP-171 tokens that are also real accounts, and they now expire after a one-year Lease. An Evergreen Name is owned by a Steward contract; the NFT stakes its own NEAR in its own name and pays its yearly Rent from the staking rewards only. The principal is never spent. Anyone can fund it, anyone can keep it renewing, and the owner can take it back (with its money and stake) at any time. Built at NEAR HACKATHON (Nov 2026), track "NFTs That Do Something".

Source: https://github.com/SachPlayZ/Evergreen (MIT). Start with README.md and AGENTS.md there.

## Verify it (Node 22+, pnpm; no Rust, keys or network accounts)

```bash
git clone --recursive https://github.com/SachPlayZ/Evergreen && cd Evergreen
pnpm install
pnpm test    # 9 scenarios against a local NEAR sandbox, ~3 min
pnpm demo    # whole story, PASS/FAIL per claim, exits non-zero on any FAIL, ~2.5 min
```

Look for: "alice.demo renewed itself 2 times with no payment from ana", "principal untouched", "bob.demo is Reclaimable: anyone can take it".

## Use it on your own Name (NEAR testnet, free)

In a browser: https://app.evergreennfts.space (connect Meteor or another testnet wallet; rent, make Evergreen, manage). Read-only view of any account: /app?account=<you.testnet>.
For agents: https://evergreennfts.space/agents.md (constants, every method with args/deposit/gas, rules) and https://evergreennfts.space/api/names?owner=<you.testnet> (JSON state).
Evergreen is not the rental service: Names are leased from House of Stake's Top Level Accounts registry.

From a terminal:

```bash
# 0. a testnet account, funded by NEAR's faucet (key saved to ~/.near-credentials/testnet/you.testnet.json)
npx near-cli-rs account create-account sponsor-by-faucet-service you.testnet autogenerate-new-keypair save-to-legacy-keychain network-config testnet create
# 1. rent mybot.ev.sachindraz.testnet (open namespace, 0.01 NEAR, one-year Lease)
pnpm evergreen testnet rent mybot --account you.testnet
# 2. make it Evergreen: your own Steward, 3 NEAR staked with a real validator (~3.8 NEAR total)
pnpm evergreen testnet adopt mybot --account you.testnet --stake 3
# 3. the hosted keeper pokes it when Rent is due; check, top up, or take it back any time
pnpm evergreen testnet status mybot
pnpm evergreen testnet tip mybot 1 --account you.testnet
pnpm evergreen testnet exit mybot --account you.testnet
```

Tested from a brand-new faucet account: hello.ev.sachindraz.testnet. Not on mainnet yet: the Steward is unaudited.

## Live data (JSON, no JavaScript needed)

- [/api/demo](https://evergreennfts.space/api/demo): the hosted demo chain. alice.demo (Evergreen) and bob.demo (no Steward), 60-second Leases (demo-only; real Leases are 1 year).
- [/api/testnet](https://evergreennfts.space/api/testnet): a real Evergreen Name on NEAR testnet, one-year Lease, staked with a real validator. Steward: ev-evergreen-ev-sachindraz-testnet.sachindraz.testnet
- [/api/nft/evergreen.png](https://evergreennfts.space/api/nft/evergreen.png): live card of an Evergreen NFT (willow = share of the Lease left, Stake, renewals). Any Name: /api/nft/<label>.png
- [/api/mainnet](https://evergreennfts.space/api/mainnet): live census of Names rented on NEAR mainnet (registry.hos).

## Key files

- [Steward contract](https://github.com/SachPlayZ/Evergreen/blob/main/contracts/steward/src/lib.rs): new, unaudited. Public: new, stake, tip, poke (anyone), exit (Patron), get_status.
- [Tests](https://github.com/SachPlayZ/Evergreen/tree/main/packages/client/test): every claim is a scenario here.
- [Glossary](https://github.com/SachPlayZ/Evergreen/blob/main/GLOSSARY.md) and [ADRs](https://github.com/SachPlayZ/Evergreen/tree/main/docs/adr).

## What is real

- Real, unmodified: House of Stake Top Level Accounts contracts (registry, wallet, registrar), git submodule pinned at d85860a, wasm checksummed in CI.
- Demo-only: 60-second Leases and Grace on the hosted chain; a demo staking pool that pays rewards on demand.
- All code written during the hackathon (first commit 11 Nov 2026). Built with Claude Code.