https://github.com/iotaledger/iota-names
https://github.com/iotaledger/iota-names
Last synced: 6 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/iotaledger/iota-names
- Owner: iotaledger
- License: apache-2.0
- Created: 2025-02-04T07:45:40.000Z (over 1 year ago)
- Default Branch: develop
- Last Pushed: 2026-01-10T20:25:49.000Z (6 months ago)
- Last Synced: 2026-01-11T06:13:36.005Z (6 months ago)
- Language: TypeScript
- Size: 96.4 MB
- Stars: 3
- Watchers: 12
- Forks: 1
- Open Issues: 55
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
- Notice: NOTICE
Awesome Lists containing this project
README
> [!NOTE]\
> By using this service, you agree to the [Terms & Conditions](https://testnet.iotanames.com/terms-of-service).
# IOTA-Names
This repository holds the IOTA-Names contracts (both the core and all system packages).
## Packages
The [packages](./packages/) folder contains a list of all the packages that are being used
for IOTA-Names, as well as their tests.
## Scripts
The [scripts](./scripts/) folder is more like a "scratchpad" for different actions we want to build for various multi-sig operations.
### Local setup for testing
Prerequisites:
- IOTA binary with the "iota-names" feature: `cargo install --locked --bin iota --features=iota-names --path crates/iota` in https://github.com/iotaledger/iota
- pnpm https://pnpm.io
1. Start a local IOTA network in one terminal:
```bash
iota start --force-regenesis --with-faucet
```
2. In another terminal, create a new environment for the local network and switch to it:
```bash
iota client new-env --alias localnet --rpc http://127.0.0.1:9000 --graphql http://127.0.0.1:9125
iota client switch --env localnet
```
3. Request funds from the faucet:
```bash
iota client faucet
```
4. Install the dependencies:
```bash
pnpm i
```
5. Build and publish the packages:
```bash
cd scripts && pnpm ts-node init/init.ts localnet
```
6. Get environment variables for the IOTA CLI:
```bash
pnpm run envs localnet
```
Set the resulting environment variables in your terminal.
Done, IOTA-Names is now ready for use 🚀
Register your first name with:
```bash
iota name register first.iota
```
All in one:
```bash
docker start postgres || docker run -d --name postgres -e POSTGRES_PASSWORD=postgrespw -e POSTGRES_INITDB_ARGS="-U postgres" -p 5432:5432 postgres:15 -c max_connections=1000
# Run network in the background without logs
iota start --force-regenesis --with-faucet --faucet-amount 100000000000000 --with-indexer --with-graphql > /dev/null 2>&1 &
iota client new-env --alias localnet --rpc http://127.0.0.1:9000 --graphql http://127.0.0.1:9125
iota client switch --env localnet
# wait for the network to start
sleep 10
iota client faucet
# wait for the faucet tx
sleep 2
pnpm i
cd scripts && pnpm ts-node init/init.ts localnet
pnpm run envs localnet
cd ..
```
To stop the local network in the background, run: `kill %1` or `kill ` that was printed when it was started.