Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 12 additions & 3 deletions docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -76,13 +76,22 @@ Koinos is a next-generation blockchain platform designed to be **truly accessibl

[:octicons-arrow-right-24: Integrate trading](exchanges/index.md)

- :fontawesome-solid-book:{ .lg .middle } __References & Resources__
- :fontawesome-solid-book:{ .lg .middle } __References__

---

API references, troubleshooting guides, community links, and additional resources to support your Koinos development journey.
Look up API, SDK, contract, and troubleshooting reference material.

[:octicons-arrow-right-24: Browse resources](references/index.md)
[:octicons-arrow-right-24: Open references](references/index.md)

- :fontawesome-solid-compass:{ .lg .middle } __Resources__

---

Find verified wallets, explorers, ecosystem applications, developer tools,
contract standards, and community links.

[:octicons-arrow-right-24: Browse resources](resources/index.md)

</div>

Expand Down
79 changes: 79 additions & 0 deletions docs/resources/community-and-learning.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,79 @@
# Community and learning

Use these links to ask questions, follow project updates, learn from examples,
and contribute corrections. Public chat and third-party content can be wrong or
outdated; verify technical advice against current versioned documentation and
source code.

## Official project sources

- [Koinos website](https://koinos.io/) — project information and official
links.
- [Koinos documentation](https://docs.koinos.io/) — published guides and
references.
- [Koinos GitHub organization](https://github.com/koinos) — source repositories,
releases, and issue trackers.
- [Koinos Docs repository](https://github.com/koinos/koinos-docs) —
documentation source and contribution history.

## Discussion channels

- [Koinos Telegram](https://telegram.koinos.io/) — public community discussion.
- [Koinos Discord](https://discord.koinos.io/) — community and developer
discussion.
- [Koinos on X](https://x.com/koinosnetwork) — project announcements and links.

No moderator or contributor should ask for a recovery phrase, WIF, or private
key. Do not treat a direct message as proof of identity. Reproduce technical
advice on a test account or test network before applying it to valuable assets
or production infrastructure.

## Articles, videos, and learning paths

- [Koinos YouTube](https://www.youtube.com/@koinosgroup) contains project
presentations and tutorials.
- [Koinos Network on Medium](https://medium.com/koinosnetwork) contains project
articles and announcements.
- [Getting Started](../getting-started/index.md) is the recommended path for new
users.
- [Interacting with Koinos](../interacting/index.md) covers wallet, API, and
transaction workflows.
- [Smart Contracts](../contracts/index.md) covers contract development.
- [Node Operators](../nodes/index.md) covers running node infrastructure.
- [Architecture](../architecture/index.md) explains protocol and service
design.

Older articles and videos may reference obsolete releases or networks. Check
the publication date and compare commands, endpoints, and package versions with
the current canonical repository before using them.

## Contribute or report stale documentation

For a small correction, open a pull request against
[koinos/koinos-docs](https://github.com/koinos/koinos-docs). For a broken link,
obsolete instruction, or uncertain technical claim, open a
[documentation issue](https://github.com/koinos/koinos-docs/issues/new) with:

- the affected page URL and section;
- the statement or link that appears stale;
- the current canonical source, tag, or commit;
- the date and network on which you verified the problem.

Check a repository's `CONTRIBUTING.md` and target branch before opening a pull
request.

## Propose a Resources entry

Open a documentation issue or pull request with enough evidence to verify the
entry:

1. Category and concise factual purpose.
2. Maintainer and whether it is official, community-maintained, or third-party.
3. Canonical site and source repository, when source is public.
4. Supported Koinos network or networks.
5. Current release, package, tag, or immutable commit for technical claims.
6. Verification date and known limitations.

An ecosystem directory or project name can be used for discovery, but it is not
enough evidence by itself. Entries that cannot be independently verified may be
left out until current canonical evidence is available.
83 changes: 45 additions & 38 deletions docs/resources/contract-standards.md
Original file line number Diff line number Diff line change
@@ -1,53 +1,60 @@
# Contract Standards
# Contract standards

Standard interfaces and patterns for Koinos smart contracts.
Koinos Contract Standards (KCSs) describe interfaces intended to improve
interoperability between contracts and applications. They are separate from
governance proposals.

## Overview
The titles and statuses below were checked on **2026-07-25** against commit
[`ef6f3d8`](https://github.com/koinos/koinos-contract-standards/commit/ef6f3d8edc75673842e927edba1232fe47df51e4)
of the canonical
[koinos/koinos-contract-standards](https://github.com/koinos/koinos-contract-standards)
repository.

Contract standards ensure interoperability between different applications and provide consistent interfaces for common functionality.
## Published standards

## Token Standards
### KCS-1 — Token Standard

### KCS-1: Fungible Tokens
- **Purpose**: Standard interface for fungible tokens
- **Functions**: transfer, balanceOf, totalSupply, approve, allowance
- **Usage**: Most tokens follow this standard for compatibility
- **Status:** Final.
- **Purpose:** defines a base interface for tokens on Koinos.
- **Sources:** [reviewed commit](https://github.com/koinos/koinos-contract-standards/blob/ef6f3d8edc75673842e927edba1232fe47df51e4/KCSs/kcs-1.md)
and [latest KCS-1](https://github.com/koinos/koinos-contract-standards/blob/master/KCSs/kcs-1.md).

### KCS-2: Non-Fungible Tokens (NFTs)
- **Purpose**: Standard interface for unique digital assets
- **Functions**: ownerOf, transferFrom, approve, tokenURI
- **Usage**: NFT collections and marketplaces
### KCS-2 — NFT Collection Standard

## DeFi Standards
- **Status:** Final.
- **Purpose:** defines a base interface for NFT collections.
- **Sources:** [reviewed commit](https://github.com/koinos/koinos-contract-standards/blob/ef6f3d8edc75673842e927edba1232fe47df51e4/KCSs/kcs-2.md)
and [latest KCS-2](https://github.com/koinos/koinos-contract-standards/blob/master/KCSs/kcs-2.md).

### KCS-3: Decentralized Exchange
- **Purpose**: Standard interface for DEX contracts
- **Functions**: addLiquidity, removeLiquidity, swap
- **Usage**: Trading platforms and aggregators
### KCS-3 — Token Standard that mimics ERC-20

### KCS-4: Staking Contracts
- **Purpose**: Standard interface for staking mechanisms
- **Functions**: stake, unstake, claimRewards, getStakeInfo
- **Usage**: Yield farming and staking platforms
- **Status:** Final.
- **Purpose:** defines an ERC-20-like token interface for Koinos.
- **Sources:** [reviewed commit](https://github.com/koinos/koinos-contract-standards/blob/ef6f3d8edc75673842e927edba1232fe47df51e4/KCSs/kcs-3.md)
and [latest KCS-3](https://github.com/koinos/koinos-contract-standards/blob/master/KCSs/kcs-3.md).

## Governance Standards
### KCS-4 — Token Standard that mimics ERC-20 and supports Koinos authority system

### KCS-5: Governance Tokens
- **Purpose**: Standard interface for governance participation
- **Functions**: propose, vote, execute, getVotingPower
- **Usage**: DAO and governance systems
- **Status:** Pending.
- **Purpose:** extends an ERC-20-like token interface with the Koinos authority
system.
- **Sources:** [reviewed commit](https://github.com/koinos/koinos-contract-standards/blob/ef6f3d8edc75673842e927edba1232fe47df51e4/KCSs/kcs-4.md)
and [latest KCS-4](https://github.com/koinos/koinos-contract-standards/blob/master/KCSs/kcs-4.md).

## Best Practices

1. **Follow established standards** for interoperability
2. **Implement proper interfaces** for contract interactions
3. **Use consistent naming** conventions
4. **Provide comprehensive documentation**
5. **Test compatibility** with existing tools

## Next Steps

See the main [Resources](index.md) overview for more development resources.
### KCS-5 — NFT Standard that mimics ERC-721 and supports Koinos authority system

- **Status:** Pending.
- **Purpose:** defines an ERC-721-like NFT interface with the Koinos authority
system.
- **Sources:** [reviewed commit](https://github.com/koinos/koinos-contract-standards/blob/ef6f3d8edc75673842e927edba1232fe47df51e4/KCSs/kcs-5.md)
and [latest KCS-5](https://github.com/koinos/koinos-contract-standards/blob/master/KCSs/kcs-5.md).

Use the immutable links above when reviewing the version summarized here. Check
the [latest KCS directory](https://github.com/koinos/koinos-contract-standards/tree/master/KCSs)
before implementing a standard because titles, statuses, and specifications can
change.

These summaries are only a directory. Read the complete standard, its status,
and its linked definitions before implementation. For contract development,
continue with [Smart Contracts](../contracts/index.md); for API details, see
[References](../references/index.md).
123 changes: 96 additions & 27 deletions docs/resources/ecosystem-platforms.md
Original file line number Diff line number Diff line change
@@ -1,43 +1,112 @@
# Ecosystem Platforms
# Ecosystem applications and services

Key platforms and applications in the Koinos ecosystem.
This page lists live applications, services, and node software whose purpose
and canonical destination were verified. Each entry identifies whether it is
community-maintained or third-party.

## Overview
Inclusion is not an endorsement, audit, or guarantee of availability. Before
connecting a wallet, verify the domain, selected network, contract, assets, and
operation. Never share a recovery phrase, WIF, or private key.

The Koinos ecosystem includes various platforms for trading, NFTs, and other decentralized applications.
## Exchange application

## Major Platforms
### KoinDX

### Kollection
- **Type**: NFT Marketplace
- **Description**: Primary NFT trading platform on Koinos
- **Features**: NFT minting, trading, collections
[KoinDX](https://koindx.com/) is a decentralized-exchange application for
swapping Koinos tokens. Follow the application's current interface and
documentation; this directory does not assess its contracts, prices, or
liquidity.

### KoinCity
- **Type**: Community Platform
- **Description**: Social platform for the Koinos community
- **Features**: Community discussions, news, updates
- **Maintainer:** KoinDX project.
- **Ownership:** third-party.

### KoinDX
- **Type**: Decentralized Exchange
- **Description**: DEX for trading Koinos tokens
- **Features**: Token swaps, liquidity pools, yield farming
## Bridge

### Vortex Bridge

[Vortex Bridge](https://vortexbridge.io/) provides a cross-chain bridge
interface that includes Koinos. Bridge use depends on third-party contracts and
multiple networks. Confirm the supported route and the current project
documentation before submitting a transfer.

- **Maintainer:** Vortex project.
- **Ownership:** third-party.

## Community applications

### Koin Krew

[Koin Krew](https://koincrew.com/) operates a Koinos community site and
[application portal](https://app.koincrew.com/) with token-tracking, NFT,
airdrop, and ownership-verification tools.

- **Maintainer:** Koin Krew project.
- **Ownership:** third-party.
- **Source:** no public source repository was verified.

Some features connect a wallet or interact with tokens. Confirm the destination,
contract, permissions, and transaction contents before using them. This
directory does not assess the listed tokens, NFTs, prices, or application
contracts.

## Block-production pools

These services provide interfaces for participating in pooled block production.
They are not part of the Koinos protocol or the official node software.

- [Fogata](https://fogata.io/) — pool discovery and participation interface
maintained by Julián González; related source is available in
[joticajulian/fogata](https://github.com/joticajulian/fogata). It is
third-party.
- [BurnKoin](https://burnkoin.com/) — block-production pool interface
maintained by the BurnKoin project/Luke Willis. The site links its
[pool contracts](https://github.com/lukemwillis/koinos-burn-pool) and
[web interface](https://github.com/lukemwillis/koinos-burn-pool-ui)
repositories. It is third-party.

This directory makes no claim about rewards, returns, uptime, performance, or
the safety of funds. For protocol-level block production and Proof of Burn, see
[Node Operators](../nodes/index.md) and
[Proof of Burn](../architecture/proof-of-burn.md).

## Node software and operator applications

The official Koinos reference node remains the
[microservice-based Koinos node](https://github.com/koinos/koinos). The
projects below are community-led, experimental alternatives. Follow the
[Node Operators](../nodes/index.md) documentation for the standard production
path.

## DeFi Applications
### Koinos One

- **Lending Protocols**: Decentralized lending and borrowing
- **Yield Farming**: Liquidity mining opportunities
- **Staking Platforms**: Token staking services
[Koinos One](https://github.com/koinos/koinos-one) is an experimental desktop
application for running and managing a local Koinos node. It uses Teleno as its
native node engine and currently targets macOS.

## Developer Tools
- **Maintainer:** community contributors led by Pablo García.
- **Ownership:** community-maintained; the repository is hosted in the Koinos
GitHub organization.
- **Current reviewed release:** [Koinos One v1.1.1](https://github.com/koinos/koinos-one/releases/tag/v1.1.1).

- **Block Explorers**: Blockchain data visualization
- **Wallet Services**: Custodial and non-custodial wallets
- **API Providers**: Blockchain data APIs
### Teleno

## Next Steps
[Teleno](https://github.com/koinos/teleno) is an experimental,
Koinos-compatible node implemented as a single native C++ binary. It is the
node engine used by Koinos One; it does not replace the official
microservice-based reference implementation.

See the main [Resources](index.md) overview for more ecosystem information.
- **Maintainer:** community contributors led by Pablo García.
- **Ownership:** community-maintained; the repository is hosted in the Koinos
GitHub organization.
- **Current reviewed release:** [Teleno node 1.1.0](https://github.com/koinos/teleno/releases/tag/teleno-node-v1.1.0).

Verify the selected network, release, configuration, data path, and key-handling
instructions in each project's own documentation before running either
experimental project.

## Request an entry or correction

The list intentionally omits projects whose current site, ownership, purpose, or
network compatibility could not be independently verified. See
[Community and learning](community-and-learning.md#propose-a-resources-entry)
for the evidence required to propose an addition.
Loading
Loading