Kim Seogyu
Blockchain

Interact with the Move VM

Aptos Framework entry function 중심으로 전송, 계정 생성, 모듈 배포 흐름을 정리합니다.

Published 2025년 12월 27일1 min read163 words

Interact with the Move VM

Aptos에서 트랜잭션은 결국 Move VM이 실행합니다. 중요한 점은 "체인 기본 동작"도 프레임워크 모듈의 함수 호출로 표현된다는 것입니다.

핵심 인터랙션 3가지

  1. 네트워크 코인 전송
  2. 새 계정 생성
  3. Move 모듈 배포

1) 코인 전송

대표 예시는 0x1::coin::transfer입니다.

  • 타입 인자: 0x1::aptos_coin::AptosCoin
  • 인자: 수신자 주소, 수량
  • 송신자: payload에 넣지 않고 서명 계정에서 결정

핵심은 Coin<T>가 제네릭이라 타입 인자를 정확히 전달해야 한다는 점입니다.

2) 계정 생성

0x1::aptos_account::create_account를 호출합니다.

실무에서는 주소만 보는 게 아니라 인증키 파생 규칙까지 맞춰야 계정 관련 실패를 줄일 수 있습니다.

3) 모듈 배포

모듈 바이트코드의 주소와 실제 송신자 주소가 일치해야 배포가 승인됩니다.

  • module 0x...::MyModule의 주소
  • 트랜잭션 송신자 주소

이 둘이 다르면 배포 실패입니다.

실무에서 자주 막히는 지점

  • 모듈 주소 alias 설정(Move.toml) 불일치
  • 타입 인자 누락/오입력
  • 테스트 계정과 배포 계정 혼용

운영 체크리스트

  1. 배포 전 Move.toml 주소 매핑을 고정합니다.
  2. entry function payload를 템플릿화해 재사용합니다.
  3. 모듈 배포/호출 계정을 환경별(dev/stage/prod)로 분리합니다.
Share

Related Articles

Comments

이 블로그는 제가 알고 있는 것들을 잊지 않기 위해 기록하는 공간입니다.
직접 작성한 글도 있고, AI의 도움을 받아 정리한 글도 있습니다.
정확하지 않은 내용이 있을 수 있으니 참고용으로 봐주세요.

© 2026 Seogyu Kim