NEP-141: NEAR 네트워크의 토큰 표준

주요 결과
• NEP-141은 NEAR의 공식 FT 표준으로, 전송 및 스토리지 관리 기능을 통합합니다.
• 비동기 모델과 환불 의미론은 안전한 크로스 컨트랙트 상호 작용을 제공합니다.
• 스토리지 및 메타데이터 표준을 준수하여 인덱서와의 통합을 용이하게 합니다.
• NEAR의 생태계에서 NEP-141을 준수하는 토큰은 원활한 상호 운용성을 보장합니다.
• 2025년까지 NEAR는 체인 추상화 및 사용자 온보딩을 발전시킬 예정입니다.
대체 가능한 토큰(Fungible Tokens, FT)은 스테이블코인, DeFi LP 지분, 인센티브 포인트, 결제 시스템에 이르기까지 대부분의 웹3 경험의 근간을 이룹니다. NEAR에서는 대체 가능한 토큰이 NEP-141을 통해 구현됩니다. NEP-141은 계약이 네트워크 전반에 걸쳐 토큰을 발행하고, 전송하고, 잔액을 관리하는 방식을 정의하는 표준 토큰 사양입니다. 이 가이드에서는 NEP-141이 무엇인지, 익숙한 이더리움 표준과 어떻게 다른지, 그리고 2025년에 개발자와 사용자가 알아야 할 사항에 대해 설명합니다.
NEP-141이란 무엇인가요?
NEP-141은 NEAR의 대체 가능한 토큰(FT) 표준입니다. 이 표준은 모든 FT 계약이 구현해야 하는 최소한의 인터페이스와 동작을 명시하며, 다음을 포함합니다:
- 핵심 전송 메서드
- 스토리지 관리
- 토큰 메타데이터
- 크로스 컨트랙트 전송 의미론 및 환불
공식 사양은 NEAR 개선 제안(NEAR Improvement Proposals) 저장소에 게시되어 있으며, 구현자를 위한 가장 정확한 정보 출처입니다. NEAR GitHub에서 표준 및 관련 사양을 확인하세요:
- NEP-141 대체 가능한 토큰 표준 (메서드, 콜백, 해결 로직) — FungibleToken.md
- 토큰 메타데이터 (이름, 심볼, 소수점, 아이콘 등) — FungibleTokenMetadata.md
- 스토리지 관리 (계정 등록 및 보증금) — Storage.md
- 이벤트/로깅 규칙 — Events.md
NEAR 및 현재 로드맵에 대한 맥락은 공식 사이트 및 블로그를 확인하세요:
NEP-141이 중요한 이유
- 지갑 및 dApp 전반의 일관된 통합: 표준 준수는 토큰이 NEAR Explorer와 같은 탐색기부터 Ref Finance와 같은 DeFi 앱까지 어디에서나 "그냥 작동"하도록 보장합니다.
- 예측 가능한 크로스 컨트랙트 호출 동작: NEAR의 비동기 모델은 크로스 컨트랙트 전송을 강력하지만 까다롭게 만듭니다. NEP-141은 콜백 및 환불 의미론을 표준화합니다.
- 스토리지 인식 계정 관리: NEAR는 계정이 사용하는 스토리지에 대한 비용을 지불하도록 요구합니다. NEP-141은 스토리지 보증금 및 잔액 등록을 통합하여 계약이 안전하고 효율적으로 유지되도록 합니다.
- 생태계 상호 운용성: 표준 기반 토큰은 브릿지, 인덱서 및 도구와의 깔끔한 통합을 가능하게 합니다. 예를 들어, Rainbow Bridge 또는 Rust 계약 라이브러리입니다.
ERC-20과의 차이점
NEP-141과 ERC-20은 개념적으로 일치하지만 중요한 아키텍처적 차이가 있습니다:
- 비동기 호출 및 환불: NEAR의 크로스 컨트랙트 호출은 비동기적입니다. NEP-141의
ft_transfer_call
은 수신자의ft_on_transfer
를 호출한 다음 "해결(resolve)" 콜백을 호출하여 사용되지 않은 토큰을 발신자에게 환불할 수 있도록 합니다. 이는 ERC-20의 일반적인 동기적 흐름과 대조됩니다. 표준의 "해결" 메커니즘을 확인하세요 — FungibleToken.md. - 기본적으로 "approve/transferFrom" 패턴 없음: NEP-141은 전역 허용 시스템보다는
ft_transfer_call
및 명시적인 수신자 로직에 의존합니다. 이는 승인 기반 공격 표면을 줄이고 NEAR의 약속 기반 실행 모델과 더 잘 일치합니다. - 스토리지 보증금: 사용자는 종종 스토리지 비용을 충당하기 위해 소량의 NEAR을 예치하여 토큰 계약에 계정을 "등록"해야 합니다. 이는 스토리지 표준 — Storage.md에 공식화되어 있습니다.
- 이벤트 로깅: NEAR는 EVM 이벤트 대신 표준 로그 형식을 사용합니다. 이벤트 표준은 인덱서가 구문 분석할 수 있는 구조화된 로그를 내보내는 방법을 설명합니다 — Events.md.
이러한 차이점은 개발자 편의성과 사용자 안전을 유지하면서 확장 가능하고 비동기적인 실행 및 낮은 수수료에 대한 NEAR의 설계 초점을 반영합니다.
NEP-141 인터페이스 개요
일반적인 사용자 대면 메서드:
ft_transfer(receiver_id, amount, memo?)
: 다른 계정으로 토큰 전송.ft_transfer_call(receiver_id, amount, memo?, msg)
: 토큰을 전송하고 수신자의 계약 로직을 호출합니다. 사용되지 않은 토큰은 환불됩니다.ft_balance_of(account_id)
: 잔액 조회.ft_total_supply()
: 총 공급량 조회.ft_metadata()
: 메타데이터 (이름, 심볼, 소수점, 아이콘, 참조 해시) 읽기.- 스토리지 관련:
storage_deposit
,storage_balance_of
,storage_withdraw
(스토리지 표준에서).
수신자 계약 요구 사항:
ft_on_transfer(sender_id, amount, msg) -> String
: 수신자가 사용하지 않은 토큰의 양을 반환합니다 (발신자에게 환불될 예정). 토큰 계약은 나중에 자체 해결자(resolver)를 호출하여 전송을 완료하고 환불을 처리합니다.
Rust로 개발하는 경우, 공식 라이브러리를 사용하세요:
- near-sdk (계약 프레임워크) — docs.rs/near-sdk
- near-contract-standards (기성 FT 구현) — docs.rs/near-contract-standards
Rust (near-contract-standards)의 최소 FT 패턴
아래는 간소화된 코드 스케치입니다. 프로덕션 계약은 near_contract_standards::fungible_token
을 사용하고 스토리지 및 이벤트 표준을 구현해야 합니다.
use near_contract_standards::fungible_token::FungibleToken;
use near_contract_standards::fungible_token::metadata::{FungibleTokenMetadata, FT_METADATA_SPEC};
use near_sdk::{near_bindgen, AccountId, PanicOnDefault, BorshDeserialize, BorshSerialize};
#[near_bindgen]
#[derive(BorshDeserialize, BorshSerialize, PanicOnDefault)]
pub struct Token {
pub ft: FungibleToken,
pub metadata: FungibleTokenMetadata,
}
#[near_bindgen]
impl Token {
#[init]
pub fn new(owner_id: AccountId, total_supply: near_sdk::json_types::U128) -> Self {
let mut this = Self {
ft: FungibleToken::new(b"t".to_vec()),
metadata: FungibleTokenMetadata {
spec: FT_METADATA_SPEC.to_string(),
name: "Example Token".to_string(),
symbol: "EXT".to_string(),
icon: None,
reference: None,
reference_hash: None,
decimals: 24,
},
};
this.ft.internal_register_account(&owner_id);
this.ft.internal_deposit(&owner_id, total_supply.0);
this
}
// `ft`에 위임하여 NEP-141 메서드 노출 (전송, 전송_호출, 잔액_조회 등)
}
사용자가 계정을 등록하고 스토리지 사용량을 정확하게 추적할 수 있도록 스토리지 관리 도우미를 사용하세요. 인덱서를 위해 이벤트 표준에 따라 구조화된 로그를 구현하세요.
토큰 계약 모범 사례
- 적절한 스토리지 보증금 강제: 상태 비대화 및 엣지 케이스 방지를 위해 새 계정으로의 전송 및 발행 전에
storage_deposit
을 요구하세요 — Storage.md. - 메타데이터 및 이벤트 표준 준수: 완전한 메타데이터와 구조화된 로그는 검색 가능성과 분석을 개선합니다 — FungibleTokenMetadata.md, Events.md.
ft_transfer_call
신중하게 사용: 수신자 로직을 신뢰할 수 없는 것으로 취급하세요. 금액을 검증하고, 해결자를 통해 환불을 처리하고, 안전하지 않은 가정을 피하세요 — FungibleToken.md.- 잔액을 128비트 정수와 일관된 소수점으로 유지: NEAR는 일반적으로 24개의 소수점을 사용합니다. 메타데이터에 선택 사항을 명확하게 문서화하세요.
- 사람이 읽을 수 있고 기계가 구문 분석할 수 있는 로그 발행: 인덱서와 분석은 표준화된 로그에 의존합니다. 자체 형식을 만들지 마세요.
- 명확한 관리자 메서드와 접근 제어 제공: 발행, 일시 중지 및 업그레이드는 투명하고 감사 가능해야 합니다.
2025년 생태계 영향
NEP-141은 주요 스테이블코인을 포함한 NEAR의 다양한 자산을 지원합니다. 예를 들어, Tether는 NEAR에 USDT를 통합하여 DeFi 사용자를 위한 결제 옵션과 유동성을 개선했습니다 — Tether launches USDT on NEAR. 토큰은 Rainbow Bridge와 같은 브릿지를 통해 생태계 전반으로 흐르고, Ref Finance와 같은 거래소에서 거래됩니다.
프로토콜 측면에서는 NEAR가 Chain Signatures와 같은 이니셔티브를 통해 체인 추상화 및 멀티체인 사용자 경험을 계속 발전시키고 있습니다. 이는 크로스체인 상호 작용 및 키 관리를 간소화하는 것을 목표로 합니다. 공식 블로그 — NEAR Blog 및 체인 추상화에 대한 심층 분석 — Chain Signatures에서 진행 중인 릴리스 및 기술 업데이트를 팔로우할 수 있습니다.
빌더의 경우, 이는 NEP-141 토큰이 NEAR 생태계의 개발 스택을 통해 크로스체인 흐름, 모바일 친화적인 온보딩 및 프론트엔드 상호 운용성에 점점 더 많이 참여한다는 것을 의미합니다. 지금 표준을 준수하면 이러한 기능이 확장됨에 따라 자산 호환성이 유지됩니다.
지갑 및 dApp 통합 팁
- UI에서 스토리지 흐름 처리: 첫 전송 또는 스왑 전에 사용자에게
storage_deposit
으로 등록하도록 안내합니다. ft_transfer
와ft_transfer_call
모두 지원: 많은 dApp이 원자적 작업 및 환불을 위해 후자를 사용합니다.- 메타데이터를 깔끔하게 표시: 소수점을 사용하여 잔액을 올바르게 형식화합니다. 가능한 경우 아이콘 및 참조 해시를 표시합니다.
- 표준화된 로그 구문 분석: NEP-141 이벤트를 구문 분석하여 알림, 분석 및 기록 보기를 지원합니다.
사용자는 NEAR Explorer를 통해 토큰 잔액 및 전송을 추적할 수 있으며, dApp은 NEAR NEPs 저장소 — NEPs on GitHub의 공식 사양을 사용하여 계약을 검사하거나 배포를 확인할 수 있습니다.
수탁 및 보안
NEAR의 낮은 수수료와 빠른 최종성은 빈번한 전송에 편리하지만, 수탁은 여전히 중요합니다. 상당한 양의 NEP-141 토큰을 보유하거나 DeFi와 상호 작용하는 경우, 거래 검증 및 피싱 위험 감소를 위해 키를 오프라인 하드웨어 지갑으로 이동하는 것을 고려하세요. OneKey는 온디바이스 확인 및 멀티체인 지원을 제공하여 중요한 작업 중에 의도된 ft_transfer
또는 ft_transfer_call
매개변수를 승인하고 있는지 확인하는 데 도움이 됩니다. 활동적인 NEAR 사용자의 경우, 하드웨어 지갑과 합리적인 계정 권한 및 감사된 dApp을 페어링하면 공격 표면을 크게 줄일 수 있습니다.
주요 요점
- NEP-141은 NEAR의 공식 FT 표준으로, 전송, 스토리지 보증금, 메타데이터 및 이벤트 로깅을 상호 운용 가능한 인터페이스로 결합합니다 — FungibleToken.md.
- 비동기 모델 및 환불 의미론은 승인 기반 패턴보다 안전한 크로스 컨트랙트 상호 작용을 제공합니다.
- 스토리지 및 메타데이터 표준을 구현하고 인덱서를 위해 구조화된 로그를 발행하세요.
- NEP-141을 준수하는 토큰은 NEAR의 성장하는 생태계 — Rainbow Bridge, Ref Finance, NEAR Explorer의 브릿지, 지갑 및 DeFi 앱 전반에 원활하게 통합됩니다.
- NEAR가 2025년에 체인 추상화 및 사용자 온보딩을 발전시킴에 따라 표준 준수는 토큰이 휴대 가능하고 미래에도 사용할 수 있도록 보장합니다 — NEAR Blog, Chain Signatures.
새로운 자산을 발행하거나 기존 NEP-141 토큰을 보유하는 경우, 표준을 청사진으로 삼고 그 위에 강력한 보안과 명확한 사용자 경험을 구축하세요.