Monstar

[merx88]

Monad Blitz - 자동 매칭 캐릭터 배틀 AI 게임

MONstar는 사용자가 프롬프트 작성을 통해 자신의 캐릭터를 설정하고 해당 캐릭터를 Battle Pool(콜로세움)에 넣고 다른 무작위 플레이어와 싸우게 하고, 결과에 따라 해당 Battle Pool에 맞는 배당을 얻고 잃게 되는 AI 자동 전투 게임이다.

게임 규칙

캐릭터 생성

• 사용자는 캐릭터 이름과 캐릭터 프롬프트를 입력한다.
• 작성한 값이 맞는지 확인 후 캐릭터 NFT 민팅한다.

캐릭터 Vault

• 사용자는 캐릭터 NFT에 할당된 볼트에 원하는 액수만큼 예치한다.

콜로세움 입장

• 사용자는 원하는 판돈을 설정하고 그 판돈에 맞는 콜로세움에 입장한다.

전투 시작

• 사용자의 캐릭터 NFT는 설정한 판돈을 걸고 콜로세움에 있는 무작위 캐릭터 NFT와 전투를 진행한다.
• 승부에서 승리하면 해당 판돈 만큼 얻으며, 패배한다면 판돈 만큼 잃는다.
• 해당 승부는 스케쥴러의 시간에 따라 반복된다.

전투 후

• 만약 볼트의 잔고가 소진되면 자동으로 콜로세움에서 퇴출된다.
• 볼트의 잔약은 남아있고 만약 콜로세움에서 나오고 싶다면 퇴장 버튼을 눌러 퇴장가능하다.

📋 USER scenario

1. 사용자는 자신의 프롬프트와 이미지를 통해 캐릭터 NFT를 생성한다.
2. 사용자는 자신의 캐릭터 NFT를 자신이 원하는 배당을 주는 Battle Pool(콜로세움)에 넣는다. (온체인)
3. Battle Pool 에서는 무작위로 상대방 캐릭터와 매칭이 진행된다. (온체인)
4. 사용자의 캐릭터와 무작위 플레이어의 캐릭터가 매칭이 된다면 정해진 AI 배틀 룰에 따라 승패를 가른다. (오프체인)
5. 해당 승패에 따라 승리 플레이어는 콜로세움 배당에 맞는 모나드 코인을 벌게 되며, 패배 플레이어는 배당에 맞는 모나드 코인을 잃게 된다. (온체인)
6. 해당 배틀 결과는 온체인에 저장된다.

🏗️ 아키텍처

스마트 컨트랙트
contracts/
├── MONCharacter.sol
├── MONCharacterVault.sol
└── MONColosseum.sol

MONCharacter.sol

• 캐릭터 민팅

MONCharacterVault.sol

• 볼트에 입출금 및 정산

MONColosseum.sol

• 콜로세움 판돈설정
• 라운드 시작
• 결과 온체인 기록

🔧 기술 스택

네트워크: Monad Testnet
RPC URL: https://testnet-rpc.monad.xyz
Chain ID: 10143 (0x279F)
Explorer: https://testnet.monadexplorer.com/
wallet solution: privy
fullstack : nextJs, typescript
CSS: tailwind

📋 컨트랙트 인터페이스

MONCharacter 주요 함수

// 캐릭터 NFT 민트
function mint(string calldata metadataURI) external returns (uint256 tokenId)

// 캐릭터 NFT ID 조회
 function tokenIdOf(address owner) external view returns (uint256)

MONCharacterVault 주요 함수

// 캐릭터 NFT Vault에 입금
function deposit() external payable

// 캐릭터 NFT Vault에서 출금
function withdraw(uint256 amount) external nonReentrant

// 캐릭터 배틀 후 정산
function settle(uint256 winnerNftId,uint256 loserNftId,uint256 amount) external onlyColosseum returns (uint256)

MONColosseum 주요 함수

// 콜로세움 생성 (판돈 설정)
function createNewColosseum(uint256 buyIn) external onlyGameMaster

// 콜로세움 압장
function enterColosseum(uint256 nftId, uint256 colosseumId) external

// 콜로세움 퇴장
function exitColosseum(uint256 nftId, uint256 colosseumId) external

// 라운드 시작
function triggerRound(uint256 colosseumId) external onlyGameMaster

// 캐릭터 배틀 후 정산
function submitBattleResults(uint256 colosseumId,uint256 roundId,
uint256[] calldata winners,uint256[] calldata losers) external onlyGameMaster nonReentrant

📊 Future Task

• 체인링크 VRF, Function, Automation 지원시 적용
• 가스비 최적화
• 컨트랙트 보안 오딧

[socket-security]

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff	Package	Supply Chain Security	Vulnerability	Quality	Maintenance	License
	npm/​husky@​9.1.7
	npm/​@​changesets/​changelog-github@​0.5.1
	npm/​@​changesets/​read@​0.6.5
	npm/​@​openzeppelin/​docs-utils@​0.1.5
	npm/​@​openzeppelin/​upgrades-core@​1.44.0
	npm/​lodash.startcase@​4.4.0
	npm/​@​openzeppelin/​upgrade-safe-transpiler@​0.3.33
	npm/​graphlib@​2.1.8
	npm/​solidity-ast@​0.4.60
	npm/​hardhat-ignore-warnings@​0.2.12
	npm/​@​changesets/​pre@​2.0.2
	npm/​hardhat-gas-reporter@​2.2.3
	npm/​@​nomicfoundation/​hardhat-chai-matchers@​2.0.8
	npm/​solidity-docgen@​0.6.0-beta.36
	npm/​glob@​11.0.2
	npm/​@​nomicfoundation/​hardhat-network-helpers@​1.0.12
	npm/​hardhat-exposed@​0.3.19
	npm/​micromatch@​4.0.8
	npm/​rimraf@​6.0.1
	npm/​solhint@​5.0.5
	npm/​ethers@​6.14.0
	npm/​solidity-coverage@​0.8.15
	npm/​@​openzeppelin/​merkle-tree@​1.0.8
	npm/​globals@​16.0.0
	npm/​yargs@​17.7.2
	npm/​p-limit@​6.2.0
	npm/​eslint-config-prettier@​10.1.2
	npm/​hardhat@​2.24.0
	npm/​semver@​7.7.1
	npm/​@​changesets/​cli@​2.29.2
	npm/​@​eslint/​compat@​1.2.9
	npm/​prettier@​3.5.3
See 9 more rows in the dashboard

View full report

[socket-security]

Warning

Review the following alerts detected in dependencies.

According to your organization's Security Policy, it is recommended to resolve "Warn" alerts. Learn more about Socket for GitHub.

Action	Severity	Alert  (click "▶" to expand/collapse)
Warn		Obfuscated code: npm safer-buffer is 94.0% likely obfuscated Confidence: 0.94 Location: Package overview From: blitz-seoul-contracts/lib/openzeppelin-contracts-upgradeable/lib/openzeppelin-contracts/package-lock.json → npm/@changesets/cli@2.29.2 → npm/hardhat@2.24.0 → npm/safer-buffer@2.1.2 ℹ Read more on: This package | This alert | What is obfuscated code? Next steps: Take a moment to review the security alert above. Review the linked package source code to understand the potential risk. Ensure the package is not malicious before proceeding. If you're unsure how to proceed, reach out to your security team or ask the Socket team for help at support@socket.dev. Suggestion: Packages should not obfuscate their code. Consider not using packages with obfuscated code. Mark the package as acceptable risk. To ignore this alert only in this pull request, reply with the comment @SocketSecurity ignore npm/safer-buffer@2.1.2. You can also ignore all packages with @SocketSecurity ignore-all. To ignore an alert for all future pull requests, use Socket's Dashboard to change the triage state of this alert.

View full report