Ship dApps, tools, and public goods on Maharlikas

Install CLI

Use the CLI to scaffold projects, manage keys, and talk to the network.

# install
npm i -g maha-cli

# verify
maha --version

# connect to public testnet
maha config set network testnet

# get test tokens (soon)
maha faucet <your_address>

Hello, Contract

Scaffold a Rust contract, run tests, and deploy.

# scaffold
maha new hello-contract
cd hello-contract

# build & test
maha build
maha test

# deploy
maha deploy --network testnet --key ~/.maha/keys/dev.json

JavaScript SDK

High-level helpers for JSON-RPC, key mgmt, and tx building.

import { Client } from "@maha/sdk";

const c = new Client({ rpc: "https://test-rpc.maharlikas.ph" });
const block = await c.getBlock("latest");
console.log(block.number);

Rust Crates

Contracts, serialization, and crypto utilities.

[dependencies]
maha-contract = "0.1"
maha-crypto = "0.1"

Dev Tools

• Explorer — inspect blocks/txns/logs
• Localnet — spin up a local single-node
• Key/Wallet — create, import, and sign
• Faucet — test tokens (soon)

Mainnet (planned)

• Chain: maha-mainnet
• RPC: https://rpc.maharlikas.ph
• WS: wss://rpc.maharlikas.ph/ws

Testnet (public)

• Chain: maha-testnet
• RPC: https://test-rpc.maharlikas.ph
• WS: wss://test-rpc.maharlikas.ph/ws

Faucet & explorer

• Faucet: (soon)
• Explorer: /explorer
• Docs: /docs

Devnet / Localnet

• Chain: maha-devnet
• RPC: http://127.0.0.1:8899
• WS: ws://127.0.0.1:8899/ws

For local testing and CI pipelines.

Checklist

• Threat model + abuse cases
• Rate limit RPC & endpoints
• Keys: hardware or secure enclave
• Use audited libs and pinned deps
• Formal reviews for critical paths

Testing & audits

Write property tests, fuzz critical functions, and consider external audits for mainnet deployments.

Read: /docs#security