> For the complete documentation index, see [llms.txt](https://whitepaper.litho.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://whitepaper.litho.ai/docs/guides/consuming-releases.md).

# How to Consume Lithosphere Developer Preview Releases

Guide for developers pulling the public GitHub prerelease assets for the Lithosphere developer preview.

## What The Preview Ships

Each GitHub prerelease includes:

* `create-litho-app-<version>.tgz`
* `lithosphere-sdk-<version>.tgz`
* `lithosphere-contracts-v<version>.tar.gz`
* `lithosphere-contracts-v<version>.sha256`
* `checksums-v<version>.txt`
* `release-manifest-v<version>.json`

This repository's release does not include the standalone Lithic compiler. The active compiler preview is maintained in [`KaJLabs/Lithic`](https://github.com/KaJLabs/Lithic). Use only a release published from that canonical repository and verify its attached checksums. The compiler remains a bounded preview until the native semantics, conformance, security, and chain-integration gates are approved.

## Download Release Assets

```bash
gh release download --repo KaJLabs/lithosphere --pattern 'create-litho-app-*.tgz'
gh release download --repo KaJLabs/lithosphere --pattern 'lithosphere-sdk-*.tgz'
gh release download --repo KaJLabs/lithosphere --pattern 'lithosphere-contracts-*.tar.gz'
gh release download --repo KaJLabs/lithosphere --pattern 'checksums-v*.txt'
gh release download --repo KaJLabs/lithosphere --pattern 'release-manifest-v*.json'
```

## Verify Checksums

```bash
sha256sum -c checksums-v<version>.txt
```

The release manifest records the release version, commit SHA, Node.js version, pnpm version, and the generated asset names.

## Install The CLI

```bash
npm install -g ./create-litho-app-<version>.tgz
create-litho-app my-first-dapp --template contracts
```

## Install The SDK Tarball

```bash
mkdir lithosphere-sdk-consumer
cd lithosphere-sdk-consumer
pnpm init
pnpm add ../lithosphere-sdk-<version>.tgz
```

Use it with the published package name:

```typescript
import { createClient } from '@lithosphere/sdk';
```

## Contract Artifact Bundle

The contract bundle contains ABI, bytecode, metadata, and a small manifest:

```
lithosphere-contracts-v<version>/
  manifest.json
  abi/
  bytecode/
  metadata/
```

Example usage:

```typescript
import Lep100ABI from './abi/Lep100.abi.json';
import { ethers } from 'ethers';

const contract = new ethers.Contract(address, Lep100ABI, provider);
```

## Versioning Notes

* GitHub prereleases are the supported distribution channel for the preview.
* Expect prerelease tags such as `v0.1.0-alpha.1`.
* Public npm publishing is deferred until after preview hardening.