estfor-contracts

KO | EN

gitlite — search

#react #ai #llm #go #android #rust #docker #java #cli #vue #awesome-list #pytorch #security #mcp

estfor-contracts

(★ 9)

Estfor Kingdom smart contracts

estfor-contracts Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Estfor Kingdom contracts

![EK_logomark-light_shadow_4K](https://github.com/user-attachments/assets/053d8e67-7e83-41ba-98cd-88d0b4bc3908)

[![Continuous integration](https://github.com/PaintSwap/estfor-contracts/actions/workflows/ci.yml/badge.svg)](https://github.com/PaintSwap/estfor-contracts/actions/workflows/ci.yml)

All the smart contract code for the Estfor Kingdom MMORPG game on the Sonic Blockchain.

Make sure `pnpm` is installed (or replace with equivalent npm instructions)

These contracts use hardhat and require solidity 0.8.20 at minimum.

Install dependencies:

```shell
pnpm install
```

To compile:

```shell
pnpm compile
```

To run the tests:

```shell
pnpm test
```

To deploy the contracts:

```shell
pnpm deploy
```

To verify the contracts on ftmscan:

```shell
pnpm verifyContracts
```

To check storage slot packing of the test file:

```shell
pnpm umlStorage
```

### Sonic mainnet deployed contract addresses:

Bridge [0x551944b340a17f277a97773355f463beefea7901](https://sonicscan.org/address/0x551944b340a17f277a97773355f463beefea7901)  
WorldActions [0x9e1275dd55e9623dc8f1673fc3c94cf1176a2816](https://sonicscan.org/address/0x9e1275dd55e9623dc8f1673fc3c94cf1176a2816)  
RandomnessBeacon [0x9b4ba31bf6031d9304c5d4487c3b30d58cef49a3](https://sonicscan.org/address/0x9b4ba31bf6031d9304c5d4487c3b30d58cef49a3)  
DailyRewardsScheduler [0x56ddffd7126b55883b603c4c5f33c639dfa424bc](https://sonicscan.org/address/0x56ddffd7126b55883b603c4c5f33c639dfa424bc)  
Treasury [0x50b64112cc5af4ff4f8e079143c5b19decddaf03](https://sonicscan.org/address/0x50b64112cc5af4ff4f8e079143c5b19decddaf03)  
Shop [0x80b78e431b6e52027debe297cd8ba614820a2f1b](https://sonicscan.org/address/0x80b78e431b6e52027debe297cd8ba614820a2f1b)  
RoyaltyReceiver [0x6c01e51d7254e5d3a3d844d2d56c35dd8abfa753](https://sonicscan.org/address/0x6c01e51d7254e5d3a3d844d2d56c35dd8abfa753)  
AdminAccess [0x3977a0e1a9f7564ce20cd88a22ae76d13386087a](https://sonicscan.org/address/0x3977a0e1a9f7564ce20cd88a22ae76d13386087a)  
ItemNFTLibrary [0xefba3016f46b06b98fae8a8b8f9df17567a824d3](https://sonicscan.org/address/0xefba3016f46b06b98fae8a8b8f9df17567a824d3)  
ItemNFT [0x8970c63da309d5359a579c2f53bfd64f72b7b706](https://sonicscan.org/address/0x8970c63da309d5359a579c2f53bfd64f72b7b706)  
Bazaar [0x0d6d3794c858b512716e77e05588d4f1fc264319](https://sonicscan.org/address/0x0d6d3794c858b512716e77e05588d4f1fc264319)  
EstforLibrary [0xe3223eaf0e260b54a8ce777ac9f4a972310370c0](https://sonicscan.org/address/0xe3223eaf0e260b54a8ce777ac9f4a972310370c0)  
PlayerNFT [0x076aeec336f5abbdf64ba8ddf96fc974b0463528](https://sonicscan.org/address/0x076aeec336f5abbdf64ba8ddf96fc974b0463528)  
Quests [0x193ecbc093f3bcf6ae6155c9f1bd7c963af6b8d2](https://sonicscan.org/address/0x193ecbc093f3bcf6ae6155c9f1bd7c963af6b8d2)  
Clans [0xbc6ed9e6cb54661ed9682c5055a6631d92e9e1d0](https://sonicscan.org/address/0xbc6ed9e6cb54661ed9682c5055a6631d92e9e1d0)  
WishingWell [0x1207d2f1dc47a9228f20e9d0ce5094ff08bcb00b](https://sonicscan.org/address/0x1207d2f1dc47a9228f20e9d0ce5094ff08bcb00b)  
Bank [0x144884e1b42ccc9c648adee9b5dc1479ce1c8fe3](https://sonicscan.org/address/0x144884e1b42ccc9c648adee9b5dc1479ce1c8fe3)  
PetNFTLibrary [0x30B11Fa95AeE89bA8B700343600E0B7DdF7d48f2](https://sonicscan.org/address/0x30B11Fa95AeE89bA8B700343600E0B7DdF7d48f2)  
PetNFT [0xe97f8165d9d8d6835abdf7a814ba55dd09b7b1ed](https://sonicscan.org/address/0xe97f8165d9d8d6835abdf7a814ba55dd09b7b1ed)  
PlayersLibrary [0x8548737b2579C2dA6458C5B0360DBb3a749BFdf2](https://sonicscan.org/address/0x8548737b2579C2dA6458C5B0360DBb3a749BFdf2)  
PlayersImplQueueActions [0x609a8ebad0f8837b6209b98e71ebe35c53c75fa2](https://sonicscan.org/address/0x609a8ebad0f8837b6209b98e71ebe35c53c75fa2)  
PlayersImplProcessActions [0x0a2f19d4729f0060fd9b113bfe7ff830fc0cc27c](https://sonicscan.org/address/0x0a2f19d4729f0060fd9b113bfe7ff830fc0cc27c)  
PlayersImplRewards [0x086e4e3dd7e30232d5c3cedae83fec8ee0f9ddb6](https://sonicscan.org/address/0x086e4e3dd7e30232d5c3cedae83fec8ee0f9ddb6)  
PlayersImplMisc [0x692ff62bf6434240b0107ab131e45c49c7a59c3f](https://sonicscan.org/address/0x692ff62bf6434240b0107ab131e45c49c7a59c3f)  
PlayersImplMisc1 [0x3b14d1e2407e0723a3c45b11ec654e0862cc53b9](https://sonicscan.org/address/0x3b14d1e2407e0723a3c45b11ec654e0862cc53b9)  
Players [0xefa670aad6d5921236e9655f346ca13a5c56481b](https://sonicscan.org/address/0xefa670aad6d5921236e9655f346ca13a5c56481b)  
PromotionsLibrary [0x201ffa5be3886d19ef2f18da877ff3b9e34d10c9](https://sonicscan.org/address/0x201ffa5be3886d19ef2f18da877ff3b9e34d10c9)  
Promotions [0xaf48a8a12f29e30b3831392aa2ee6344d07d188b](https://sonicscan.org/address/0xaf48a8a12f29e30b3831392aa2ee6344d07d188b)  
PassiveActions [0x72bb8faee4094d5a701faa26f9f442d32dfe53b6](https://sonicscan.org/address/0x72bb8faee4094d5a701faa26f9f442d32dfe53b6)  
InstantActions [0x765f7068c3cd210b52374498f3ce01617667aed0](https://sonicscan.org/address/0x765f7068c3cd210b52374498f3ce01617667aed0)  
InstantVRFActions [0x1ea4b1fa7f069b89eb8cceee30bfb24945e4d638](https://sonicscan.org/address/0x1ea4b1fa7f069b89eb8cceee30bfb24945e4d638)  
GenericInstantVRFActionStrategy [0x05cd907e6ad6cad21ab2a39e49c68b110be7189a](https://sonicscan.org/address/0x05cd907e6ad6cad21ab2a39e49c68b110be7189a)  
EggInstantVRFActionStrategy [0x231363f40693698df92354275e2bcc4cbe48aa56](https://sonicscan.org/address/0x231363f40693698df92354275e2bcc4cbe48aa56)  
BankRelay [0x0df55b940e993f8d3b06a64212962c3d0fef8cba](https://sonicscan.org/address/0x0df55b940e993f8d3b06a64212962c3d0fef8cba)  
PVPBattleground [0x679193f35e696651e125b2851ee7c4e44bf40a18](https://sonicscan.org/address/0x679193f35e696651e125b2851ee7c4e44bf40a18)  
Raids [0xec57b7988ee3344bcf4ce64e5d11f495df7cd951](https://sonicscan.org/address/0xec57b7988ee3344bcf4ce64e5d11f495df7cd951)  
ClanBattleLibrary [0x97be54a51ca91ca34377563d865e4e21a5637472](https://sonicscan.org/address/0x97be54a51ca91ca34377563d865e4e21a5637472)  
LockedBankVaultsLibrary [0x55b7fd81638b81806d1c89f7930383030621b2e5](https://sonicscan.org/address/0x55b7fd81638b81806d1c89f7930383030621b2e5)  
LockedBankVaults [0xfaa31b6ddb7e07cae5ff15475b3966d78d660240](https://sonicscan.org/address/0xfaa31b6ddb7e07cae5ff15475b3966d78d660240)  
Territories [0x5a6d80bb035318d2a24c1fdfd055032a15f11b12](https://sonicscan.org/address/0x5a6d80bb035318d2a24c1fdfd055032a15f11b12)  
CombatantsHelper [0xc754d621239b5830264f8c8e302c21ffe48625fc](https://sonicscan.org/address/0xc754d621239b5830264f8c8e302c21ffe48625fc)  
TerritoryTreasury [0x4b1da5984c89312f852c798154a171a5ddc07d43](https://sonicscan.org/address/0x4b1da5984c89312f852c798154a171a5ddc07d43)  
BankRegistry [0xf213febd3889c5bf18086356e7eff79e2a9fe391](https://sonicscan.org/address/0xf213febd3889c5bf18086356e7eff79e2a9fe391)  
BankFactory [0x76af5869f1b902f7a16c128a1daa7734819ec327](https://sonicscan.org/address/0x76af5869f1b902f7a16c128a1daa7734819ec327)  
ActivityPoints [0x84527c02bb28ce7c32ca4182ad0541a2a9a561d2](https://sonicscan.org/address/0x84527c02bb28ce7c32ca4182ad0541a2a9a561d2)  
Marketplace [0x7ba7b9193883e944645fc41d4a16c9516c6c5dc1](https://sonicscan.org/address/0x7ba7b9193883e944645fc41d4a16c9516c6c5dc1)  
Cosmetics [0xb30b177b6c8c21370a72d7cada5f627519c91432](https://sonicscan.org/address/0xb30b177b6c8c21370a72d7cada5f627519c91432)  
Global Events [0x6aca0ec5ad8158ab112f0fdf76e2c3ed6bfa11e2](https://sonicscan.org/address/0x6aca0ec5ad8158ab112f0fdf76e2c3ed6bfa11e2)  
Black Market Trader [0x4f9911214d811b5acdc4d1911067f614e81c808e](https://sonicscan.org/address/0x4f9911214d811b5acdc4d1911067f614e81c808e)  
Game Subsidisation Registry [0xdfe85d3a75f80eb7d07d6ead00de3e02a88aae30](https://sonicscan.org/address/0xdfe85d3a75f80eb7d07d6ead00de3e02a88aae30)  
Usage Based Session Module [0x144e54c35d3362f41dd39ade9ba709a2ee6a2af7](https://sonicscan.org/address/0x144e54c35d3362f41dd39ade9ba709a2ee6a2af7)  
PetNFTReroll [0x85b9e4e41998910d398553ba5690938094a56463](https://sonicscan.org/address/0x85b9e4e41998910d398553ba5690938094a56463)  
OrderbookV2 [0xf114eff305cdac968ff276494ec69379170ed570](https://sonicscan.org/address/0xf114eff305cdac968ff276494ec69379170ed570)

### Sonic mainnet beta deployed contract addresses:

Bridge [0x4a4988daecaad326aec386e70fb0e6e6af5bda1a](https://sonicscan.org/address/0x4a4988daecaad326aec386e70fb0e6e6af5bda1a)  
WorldActions [0x3a965bf890e5ac353603420cc8d4c821d1f8a765](https://sonicscan.org/address/0x3a965bf890e5ac353603420cc8d4c821d1f8a765)  
RandomnessBeacon [0x7695be7272f3d223a40fc3c0499053f81c17cb65](https://sonicscan.org/address/0x7695be7272f3d223a40fc3c0499053f81c17cb65)  
DailyRewardsScheduler [0x16ba02365efcb5dacc46fe743c46d37a93997575](https://sonicscan.org/address/0x16ba02365efcb5dacc46fe743c46d37a93997575)  
Treasury [0xdd744b66bb24a01a4ec62287f3d0d91fee37f8b1](https://sonicscan.org/address/0xdd744b66bb24a01a4ec62287f3d0d91fee37f8b1)  
Shop [0xb3778f2c24d94e3c7cfe608388bd35bba9401caa](https://sonicscan.org/address/0xb3778f2c24d94e3c7cfe608388bd35bba9401caa)  
RoyaltyReceiver [0x5fce65360e0acdfcec0153bda8c412a7631d47a2](https://sonicscan.org/address/0x5fce65360e0acdfcec0153bda8c412a7631d47a2)  
AdminAccess [0xc06b7bb82b6312c1c2c2de3e375f04d97e80de57](https://sonicscan.org/address/0xc06b7bb82b6312c1c2c2de3e375f04d97e80de57)  
ItemNFTLibrary [0x593f115a4d07b86cf507C01678220b9136fAfa13](https://sonicscan.org/address/0x593f115a4d07b86cf507C01678220b9136fAfa13)  
ItemNFT [0x8ee7d355f76fb5621ee89bca431ba0cd39fe14c5](https://sonicscan.org/address/0x8ee7d355f76fb5621ee89bca431ba0cd39fe14c5)  
Bazaar [0xae4bd229721ff40c07162c1720e060a2a5c89ff6](https://sonicscan.org/address/0xae4bd229721ff40c07162c1720e060a2a5c89ff6)  
EstforLibrary [0x96977118842d6f209f9442e76d7de04d393480d8](https://sonicscan.org/address/0x96977118842d6f209f9442e76d7de04d393480d8)  
PlayerNFT [0xbf5eed84c0cdff089c9dd6086ddf805d111ef35b](https://sonicscan.org/address/0xbf5eed84c0cdff089c9dd6086ddf805d111ef35b)  
Quests [0xd896af0dd1d3533d5d86d4be52df9546a97ddb4d](https://sonicscan.org/address/0xd896af0dd1d3533d5d86d4be52df9546a97ddb4d)  
Clans [0x84d9d334c5b64fcbcb17d6b853a0434818d052bb](https://sonicscan.org/address/0x84d9d334c5b64fcbcb17d6b853a0434818d052bb)  
WishingWell [0xb2570777de043adbc7bfcc4bfed747e2e44fbeea](https://sonicscan.org/address/0xb2570777de043adbc7bfcc4bfed747e2e44fbeea)  
Bank [0x72598e7d7a6652ebb29026f83512bce1455999f6](https://sonicscan.org/address/0x72598e7d7a6652ebb29026f83512bce1455999f6)  
PetNFTLibrary [0x2FFe92B4b38e9bc8b236ab610ac6073DCF2464a7](https://sonicscan.org/address/0x2FFe92B4b38e9bc8b236ab610ac6073DCF2464a7)  
PetNFT [0x7ca7f680517150c8e1ed5a6dd5db80cdc6934082](https://sonicscan.org/address/0x7ca7f680517150c8e1ed5a6dd5db80cdc6934082)  
PlayersLibrary [0xc9ceda474642e39f05c3e8fed75b3f45ed4ae210](https://sonicscan.org/address/0xc9ceda474642e39f05c3e8fed75b3f45ed4ae210)  
PlayersImplQueueActions [0x2d6be4704aedff55280a1102129f4737cfa79be8](https://sonicscan.org/address/0x2d6be4704aedff55280a1102129f4737cfa79be8)  
PlayersImplProcessActions [0x6b734d59932e69b29f27fe51d1377098b54dbaf7](https://sonicscan.org/address/0x6b734d59932e69b29f27fe51d1377098b54dbaf7)  
PlayersImplRewards [0x9f37122f03fd24b089d597f330c874638e29ff5b](https://sonicscan.org/address/0x9f37122f03fd24b089d597f330c874638e29ff5b)  
PlayersImplMisc [0x77cfa3f90d1b183e8e67350428d721313cbbc822](https://sonicscan.org/address/0x77cfa3f90d1b183e8e67350428d721313cbbc822)  
PlayersImplMisc1 [0x4d85d84a0d1ceabb592a4b8a4dbdbd96b77233ee](https://sonicscan.org/address/0x4d85d84a0d1ceabb592a4b8a4dbdbd96b77233ee)  
Players [0x4f60948bea953693b4dcd7ea414a2198c3646c97](https://sonicscan.org/address/0x4f60948bea953693b4dcd7ea414a2198c3646c97)  
PromotionsLibrary [0xaf79ca769a02381daca6f7736c51e3ad01ac571c](https://sonicscan.org/address/0xaf79ca769a02381daca6f7736c51e3ad01ac571c)  
Promotions [0xa4f0adf443b48b52827f8c1f56d2f2ab76ae43ab](https://sonicscan.org/address/0xa4f0adf443b48b52827f8c1f56d2f2ab76ae43ab)  
PassiveActions [0x0b577a40b8e69614bd2f6687349ba69c0d1f7113](https://sonicscan.org/address/0x0b577a40b8e69614bd2f6687349ba69c0d1f7113)  
InstantActions [0x76928633cfbf043bca1f6b8ffe634f4c63dbd90d](https://sonicscan.org/address/0x76928633cfbf043bca1f6b8ffe634f4c63dbd90d)  
InstantVRFActions [0x007247ab8fbae2b07f5adf3e70a141459c89264e](https://sonicscan.org/address/0x007247ab8fbae2b07f5adf3e70a141459c89264e)  
GenericInstantVRFActionStrategy [0x2e66bf22e21aee0986602dd2c7265a5470ec9962](https://sonicscan.org/address/0x2e66bf22e21aee0986602dd2c7265a5470ec9962)  
EggInstantVRFActionStrategy [0xd9deebc6ca8b75f8e4de7b4e96a4d8b7e2b3607e](https://sonicscan.org/address/0xd9deebc6ca8b75f8e4de7b4e96a4d8b7e2b3607e)  
BankRelay [0xd6cdc1d365e505f0546361782c4336c829c39568](https://sonicscan.org/address/0xd6cdc1d365e505f0546361782c4336c829c39568)  
PVPBattleground [0xe91a6cdac47dfd546578273253bff1fddc350764](https://sonicscan.org/address/0xe91a6cdac47dfd546578273253bff1fddc350764)  
Raids [0xbfd416e76519cf199dd95b82f6928b3a4b5ac995](https://sonicscan.org/address/0xbfd416e76519cf199dd95b82f6928b3a4b5ac995)  
ClanBattleLibrary [0x58e99f6ed3bfb9e9311d9297e48310c3c8aea178](https://sonicscan.org/address/0x58e99f6ed3bfb9e9311d9297e48310c3c8aea178)  
LockedBankVaultsLibrary [0x080ca5bb70759b993676a4dc88c2e36125d83661](https://sonicscan.org/address/0x080ca5bb70759b993676a4dc88c2e36125d83661)  
LockedBankVaults [0x9451943d38ac8cde8a2a8026adb8b28ac089b2cb](https://sonicscan.org/address/0x9451943d38ac8cde8a2a8026adb8b28ac089b2cb)  
Territories [0xa2ca7daad4b86819c455fafc704d727a23c5a513](https://sonicscan.org/address/0xa2ca7daad4b86819c455fafc704d727a23c5a513)  
CombatantsHelper [0x7fa2b4c19093e0777d72235ea28d302f53227fa0](https://sonicscan.org/address/0x7fa2b4c19093e0777d72235ea28d302f53227fa0)  
TerritoryTreasury [0x5d1429f842891ea0ed80e856762b48bc117ac2a8](https://sonicscan.org/address/0x5d1429f842891ea0ed80e856762b48bc117ac2a8)  
BankRegistry [0x7e7664ff2717889841c758ddfa7a1c6473a8a4d6](https://sonicscan.org/address/0x7e7664ff2717889841c758ddfa7a1c6473a8a4d6)  
BankFactory [0x5497f4b12092d2a8bff8a9e1640ef68e44613f8c](https://sonicscan.org/address/0x5497f4b12092d2a8bff8a9e1640ef68e44613f8c)  
ActivityPoints [0x7fdf947ada5b8979e8aa05c373e1a6ed7457348a](https://sonicscan.org/address/0x7fdf947ada5b8979e8aa05c373e1a6ed7457348a)  
Marketplace [0x3935866043766b86f30593bd17a787cc0105f7e0](https://sonicscan.org/address/0x3935866043766b86f30593bd17a787cc0105f7e0)  
Cosmetics [0x9ac94b923333406d1c8b390ab606f90d6526c187](https://sonicscan.org/address/0x9ac94b923333406d1c8b390ab606f90d6526c187)  
Global Events [0x8d61f3135a9f39b685b9765976e6a0f0572aeca5](https://sonicscan.org/address/0x8d61f3135a9f39b685b9765976e6a0f0572aeca5)  
Black Market Trader [0xac619719cdcf1fc03438c7b9aff737993feae851](https://sonicscan.org/address/0xac619719cdcf1fc03438c7b9aff737993feae851)  
Game Subsidisation Registry [0xe42d998ec0ec2c5d217c8b54c9522b4224d1bdb0](https://sonicscan.org/address/0xe42d998ec0ec2c5d217c8b54c9522b4224d1bdb0)  
Usage Based Session Module [0x71f7f7c98477de38e2f1a0217af0e1dc0fbf19e41](https://sonicscan.org/address/0x71f7f7c98477de38e2f1a0217af0e1dc0fbf19e41)  
PetNFTReroll [0x2885167EA2386c272C22977456c3d4d8f7a12ff7](https://sonicscan.org/address/0x2885167EA2386c272C22977456c3d4d8f7a12ff7)  
OrderbookV2 [0xe2fbd6923dccec4f212e0a040806d099f744f07b](https://sonicscan.org/address/0xe2fbd6923dccec4f212e0a040806d099f744f07b)

### Other addresses:

Brush [0xE51EE9868C1f0d6cd968A8B8C8376Dc2991BFE44](https://sonicscan.org/address/0xE51EE9868C1f0d6cd968A8B8C8376Dc2991BFE44)

### Obtain SAFE Api Key

[https://developer.safe.global/api-keys](https://developer.safe.global/api-keys)

estfor-contracts

estfor-contracts Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

estfor-contracts

estfor-contracts Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README