> For the complete documentation index, see [llms.txt](https://earthlinc.gitbook.io/protocol/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://earthlinc.gitbook.io/protocol/build/contracts-and-reference-implementation.md).

# Contracts & reference implementation

*The substrate is constitutional. The addresses arrive when they're live.*

## The substrate

The protocol runs on a fixed, non-configurable foundation:

* **Network:** Polygon
* **Name:** `earthlinc.eth` (ENS)
* **Standards:** ERC-1155 (the station; the NaviStar) + ERC-721 (the Signet) + ERC-6551 (each Realm's token-bound account) · ERC-2771 (gasless transactions)

This substrate is **constitutional** in the Protocol Specification: changing it would be a protocol-level event, announced as such — never a quiet swap.

## The objects, at the contract level

* **minted station** — the station's permanent on-chain form; the chain entry of the protocol; mints carrying a mission record it immutably.
* **NaviStar** — ERC-1155, two layers: the immutable verified-fact layer, and the mutable pointer to the living page. **Plain editions** use standard ERC-1155 transfer subroutines with no programmatic restrictions — disposal and peer-to-peer transmission are a factual function of user-side key control. **C// (grounded) editions** carry a contract-layer block on marketplace/operator transfers (`Stations1155._beforeTokenTransfer`); peer-to-peer gift transfers remain free.
* **Realm** — Signet (ERC-721 key) → ERC-6551 account → the stars it holds. Control of the Signet is control of the Realm.
* **constellation** — the on-chain link joining every NaviStar Cast from one station.

## Interfaces

Two write paths and one read surface:

* **mint** — a station's on-chain birth; carrying a mission, the call routes its Drop (whole, to the anchor) and emits the corresponding events; plain, it is an ordinary commercial transaction.
* **Cast** — mints a NaviStar from a minted station to a recipient; repeatable; joins the constellation.
* **read** — station, NaviStar, Realm, Naviscape: fully open, no permission required.

## Published when live

Contract addresses, ABIs, event schemas, and the reference implementation are published here when they go live. Until then, this page describes interfaces, not addresses — anything you find elsewhere claiming to be an Earth LinC contract **is not ours**.

Want to be notified when the reference implementation publishes? **<support@earthlinc.earth>** — subject "building."

***

*A protocol anchored by YuCROWN Corporation · 501(c)(3) — anchored, never owned.*


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://earthlinc.gitbook.io/protocol/build/contracts-and-reference-implementation.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.