> For the complete documentation index, see [llms.txt](https://docs.os.codes/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.os.codes/core-architecture/arweave-integration.md).

# Arweave Integration

<figure><img src="/files/Fyby9G4Dm0A204rRwkhf" alt=""><figcaption></figcaption></figure>

### Why Arweave?

Arweave solves permanent storage through economic incentives rather than promises. One payment funds storage forever through an endowment model based on declining storage costs.

**Arweave Advantages:**

* True permanence
* One-time payment model
* Content addressing prevents tampering
* Geographic distribution
* Direct HTTP access

### How It Works

Code storage on Arweave follows a systematic process ensuring permanence and accessibility. Each step is optimized for efficiency and reliability.

**Storage Process:**

1. Code bundled with metadata
2. Private repos encrypted client-side
3. Bundle compressed for efficiency
4. Uploaded to Arweave network
5. Transaction ID stored on-chain
6. Content accessible via gateways

### Cost Structure

Arweave storage costs approximately $10 per GB forever - not monthly, but permanent. OpenSource covers these costs from treasury, making storage free for developers.

**Cost Benefits:**

* One-time payment for eternal storage
* Platform covers all costs
* No recurring fees
* Costs decrease over time
* Sustainable economic model

### Data Permanence

Arweave's Proof of Access consensus ensures data permanence through economic incentives. Miners must store random historical data to mine new blocks.

**Permanence Mechanisms:**

* Miners incentivized to store everything
* Data replicated across hundreds of nodes
* Geographic distribution prevents loss
* Economic guarantees, not promises
