> For the complete documentation index, see [llms.txt](https://shiro.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://shiro.gitbook.io/docs/smart-contracts-and-interactions/overview-of-shiro-smart-contracts.md).

# Overview of Shiro Smart Contracts

Shiro utilizes smart contracts to automate, secure, and decentralize various aspects of the gameplay and token economics within its Solana-based platform. These contracts are central to ensuring that all transactions, from token transfers to gameplay interactions, are executed transparently and without the need for a trusted third party.

### Design Principles

The smart contracts for Shiro are developed with a few key principles in mind:

* **Security:** The utmost priority is given to making the contracts secure against attacks and vulnerabilities.
* **Efficiency**: Optimizing for low cost and high throughput, essential on the Solana blockchain where speed and scalability are significant.
* **Upgradability**: Ensuring that parts of the contract can be upgraded in response to gameplay changes, technological advancements, or security updates without disrupting the user experience.

### Contract Architecture

The smart contract architecture in Shiro consists of several modules, each handling distinct aspects of the game:

* **Token Management:** Handles all operations related to the $SHIRO tokens such as issuance, transfers, and staking.
* **Game Logic:** Encodes the rules of the game, interactions within the game environment, and player actions.
* **Asset Registry:** Keeps track of the ownership and attributes of digital assets, whether they are collectibles or consumables within the game.