NEP-141 (NEAR)

Что такое NEP-141?

NEP-141 — основной стандарт взаимозаменяемых токенов для смарт-контрактов в блокчейне NEAR.В криптоиндустрии взаимозаменяемый токен — это токен, единицы которого можно заменить другими единицами того же токена.Токен NEP-141 может представлять стабильный актив, токен управления, токен вознаграждения или полезности, обернутый актив, игровую валюту, токен ликвидности, криптоактив, похожий на баллы, или токен ликвидного стейкинга в NEAR.

В официальном руководстве NEAR по стандарту взаимозаменяемых токенов NEP-141 описан как основа для контрактов взаимозаменяемых токенов в NEAR.

NEP-141 определяет общий интерфейс, который должен реализовать контракт, чтобы считаться контрактом взаимозаменяемого токена.Интерфейс включает методы проверки общего предложения и баланса аккаунта, перевода токенов, перевода токенов контракту с callback и обработки результата вызова при переводе.NEP-141 — не то же самое, что нативный токен NEAR.Нативный токен NEAR входит в базовый протокол и используется для оплаты газа, стейкинга, хранения данных и работы сети.Токены NEP-141 выпускаются и учитываются внутри смарт-контрактов, которые ведут балансы аккаунтов пользователей.

Почему NEP-141 важен

NEP-141 важен, поскольку взаимозаменяемым токенам необходимо предсказуемо работать в кошельках, децентрализованных приложениях, протоколах DeFi, играх, аналитических инструментах и смарт-контрактах.Без общего стандарта в каждом токен-контракте могли бы использоваться разные названия методов, форматы балансов, правила переводов и способы интеграции.Это затруднило бы отображение балансов в кошельках и прием токенов приложениями.NEP-141 дает разработчикам и пользователям общий язык для работы с балансами и переводами токенов в NEAR.Для пользователей это означает, что токен NEP-141 могут распознавать приложения, поддерживающие стандарт.Разработчикам стандарт позволяет интегрировать токен-контракт с другими контрактами с помощью известных методов, а не отдельной логики для каждого токена.Проектам он упрощает запуск токенов, поскольку можно использовать существующий интерфейс.Для экосистемы NEAR он помогает улучшить взаимодействие между токенами, кошельками, контрактами ликвидного стейкинга, продуктами DeFi, играми, системами вознаграждений и платежными процессами.Этот стандарт важен, поскольку совместимость может быть не менее значима, чем предложение токена или брендинг.

Как работает NEP-141

NEP-141 работает через смарт-контракт, который хранит балансы токенов и предоставляет стандартные методы.Баланс токена NEP-141 пользователя записывается в контракте токена, а не непосредственно в аккаунте пользователя.Контракт ведет учет балансов, предложения, переводов и callback от получателей.

Кошелек или приложение может вызвать

, чтобы проверить количество токенов на аккаунте.

Кошелек или приложение может вызвать

, чтобы проверить общее предложение токена.

Пользователь может вызвать

, чтобы отправить токены на другой аккаунт NEAR.

Пользователь может вызвать

, чтобы отправить токены контракту и запустить логику этого контракта-получателя.

Контракт-получатель может вернуть неиспользованные токены в рамках процесса вызова при переводе.Такая конструкция соответствует асинхронной модели смарт-контрактов NEAR, в которой контракты часто взаимодействуют посредством вызовов между контрактами, а не через один синхронный процесс транзакции.

NEP-141 и нативный токен NEAR

Токены NEP-141 и нативный токен NEAR — разные виды активов.Нативный токен NEAR встроен в протокол NEAR и используется для комиссий за транзакции, стейкинга, хранения данных аккаунта и вознаграждений валидаторов.Токен NEP-141 выпускается смарт-контрактом и учитывается во внутреннем реестре этого контракта.Пользователь может хранить нативные токены NEAR и NEP-141 на одном аккаунте NEAR, но системы учета у них разные.Баланс нативного NEAR является частью баланса аккаунта на уровне протокола.Баланс NEP-141 отслеживает контракт токена.Это различие важно: пользователю может понадобиться небольшое количество нативного NEAR для оплаты газа или депозита за хранение, даже если ему нужно только перевести токен NEP-141.Чтобы хранить полученный токен NEP-141, пользователю также может понадобиться зарегистрировать хранилище в контракте токена.Понимание этого различия помогает избежать неудачных транзакций и путаницы с отображением балансов.

NEP-141 и NEP-171

NEP-141 — стандарт взаимозаменяемых токенов, а NEP-171 — стандарт невзаимозаменяемых токенов в NEAR.Единицу токена NEP-141 можно заменить другой единицей того же токена.NFT NEP-171 уникален и обычно имеет собственный ID токена, метаданные и запись о владельце.Например, в игре может использоваться токен NEP-141 как внутриигровая валюта, а NFT NEP-171 — как уникальные игровые предметы.Приложение DeFi может использовать токены NEP-141 для ликвидности или вознаграждений.В арт-проекте NFT NEP-171 могут представлять уникальные цифровые коллекционные предметы.Это различие влияет на отображение в кошельке, поведение на рынке, метаданные, ценообразование, хранение и логику переводов.Не следует рассматривать токен NEP-141 как NFT: он не представляет уникальный предмет.Разработчикам следует выбирать NEP-141, если активу нужны взаимозаменяемые балансы, и NEP-171, если нужны записи о владении уникальными объектами.

Основные методы NEP-141

Основной интерфейс NEP-141 включает несколько важных методов.

Метод

возвращает общее предложение токена.

Метод

возвращает баланс токена на конкретном аккаунте.

Метод

переводит указанное количество токенов от вызывающего аккаунта другому аккаунту.

Метод

переводит токены контракту-получателю и вызывает логику этого контракта.

Метод получателя

позволяет контракту-получателю принять токены и вернуть неиспользованное количество.

Метод

завершает процесс вызова при переводе после ответа контракта-получателя.

В официальной спецификации NEP-141 эти методы определены как основной интерфейс взаимозаменяемого токена.

Эти методы лежат в основе переводов токенов, платежей контрактам, депозитов в DeFi, игровых платежей и рабочих процессов приложений на базе токенов в NEAR.

ft_total_supply

Метод

возвращает общее количество базовых единиц токена, выпущенных контрактом.

Этот метод предназначен только для чтения и не меняет состояние контракта.Приложения могут использовать его для отображения общего предложения, расчета рыночных показателей, проверки эмиссии токена или отслеживания выпуска и сжигания токенов.Результат обычно возвращается в виде строки, поскольку количество токенов может быть очень большим.Разработчикам не следует обрабатывать количество токенов как обычные числа с плавающей точкой: ошибки точности могут привести к серьезным ошибкам учета.Пользователям следует понимать, что общее предложение само по себе не показывает предложение в обращении, заблокированное предложение, баланс казначейства, вестинг или реальный рыночный спрос.Токен с большим общим предложением все равно может быть полезным, если его десятичная точность и спрос имеют смысл.Токен с небольшим общим предложением все равно может быть рискованным из-за концентрации владения или низкой ликвидности.Общее предложение — лишь один из факторов анализа токена.

ft_balance_of

Метод

возвращает баланс токена на указанном аккаунте NEAR.

Этот метод предназначен только для чтения и широко используется кошельками, обозревателями, приложениями DeFi, играми, панелями мониторинга и портфельными инструментами.Баланс возвращается в минимальных базовых единицах токена.Отображаемое пользователю значение зависит от количества десятичных знаков токена в метаданных.Например, токен с 24 десятичными знаками может отображаться меньшим числом в привычном формате, чем предполагает необработанное значение в базовых единицах.Приложениям следует форматировать балансы по метаданным токена, а не угадывать количество десятичных знаков.Пользователям также следует учитывать, что данные в кошельке могут обновляться с задержкой или кэшироваться.Если баланс в кошельке отображается неверно, следует проверить состояние контракта и историю транзакций через надежные инструменты.Правильное отображение баланса зависит и от метода NEP-141 для получения баланса, и от корректной обработки метаданных.

ft_transfer

Метод

отправляет указанное количество токенов с аккаунта вызывающего пользователя аккаунту-получателю.

Это основной метод перевода токенов между аккаунтами NEAR для NEP-141.Метод может включать необязательное поле memo.Поле memo может пояснять назначение перевода: например, содержать ссылку на платеж, внутреннюю заметку или сообщение для конкретного приложения.

В документации NEAR указано, что при вызове

необходимо приложить ровно 1 yoctoNEAR.

Этот небольшой прикрепленный депозит помогает подтвердить, что чувствительное действие подписано полнофункциональным ключом.Перед отправкой перевода пользователям всегда следует проверять аккаунт получателя.Перевод токенов обычно трудно или невозможно отменить, если токены отправлены не на тот аккаунт.В интерфейсе перевода проекта следует четко показывать токен, сумму, получателя, газ и memo до подписи.

ft_transfer_call

Метод

отправляет токены контракту-получателю и вызывает метод этого контракта в рамках одного общего процесса.

Это одна из важнейших частей NEP-141, поскольку метод поддерживает использование токенов между контрактами.

Пользователь может применить

, чтобы внести токены в контракт DeFi, оплатить сервисный контракт, присоединиться к игровому контракту, застейкать токены, перевести их через мост или запустить логику приложения.

Метод включает поля

, , необязательное поле и поле .

Поле

позволяет отправителю передать контракту-получателю инструкции для конкретного приложения.

Чтобы обработать поступившие токены, контракт-получатель должен реализовать

.

Если получатель использует не все токены, он может вернуть неиспользованное количество, чтобы отправитель получил возмещение.Во многих сценариях приложений такая конструкция избавляет от необходимости выполнять отдельные транзакции для разрешения и оплаты.Использовать вызовы при переводе следует только с надежными контрактами: именно логика контракта-получателя определяет обработку переведенных токенов.

ft_on_transfer

Метод

реализуют контракты, которые должны принимать токены NEP-141 через .

Метод получает аккаунт отправителя, количество токенов и сообщение, переданные при вызове перевода.Затем контракт-получатель решает, что делать с токенами.Например, он может зачислить депозит пользователя, купить предмет, записать платеж, выпустить токен-квитанцию, открыть позицию в стейкинге или отклонить перевод.Метод возвращает количество токенов, которые контракт-получатель не использовал.Неиспользованное количество может быть возвращено в рамках процесса разрешения результата.Эта схема позволяет контрактам безопасно принимать взаимозаменяемые токены и выполнять прикладную логику в ответ.Разработчикам следует тщательно реализовать этот метод: неверные возвращаемые значения могут привести к неправильному возмещению или путанице с балансами.Пользователям следует понимать, что отправка токенов контракту отличается от отправки обычному аккаунту.

ft_resolve_transfer

Метод

завершает процесс вызова при переводе после ответа контракта-получателя.

Он используется как callback, чтобы определить, следует ли вернуть отправителю неиспользованное количество токенов.Это важно, поскольку вызовы контрактов NEAR выполняются асинхронно.Контракт токена не может считать, что контракт-получатель успешно использовал все токены, пока не получит результат callback.Если контракт-получатель отклоняет перевод или сообщает о неиспользованных токенах, контракт токена может вернуть соответствующее количество согласно логике стандарта.Этот метод помогает сделать процессы взаимодействия токенов и контрактов безопаснее и более совместимыми.До запуска контрактов в рабочей среде разработчикам следует проверить неудачные вызовы получателя, частичные возвраты и особые случаи.Пользователям следует учитывать, что результат вызова при переводе может быть сложнее, чем результат обычного перевода между кошельками.Хороший интерфейс приложения должен показывать, успешно ли выполнен вызов при переводе, завершился ли он ошибкой или были ли возвращены неиспользованные токены.

NEP-141 и метаданные NEP-148

NEP-148 — стандарт метаданных, используемый вместе с взаимозаменяемыми токенами NEP-141.

В официальном стандарте метаданных NEP-148 определены метод

и поля метаданных взаимозаменяемых токенов.

Важные поля метаданных:

, , , , , и .

Поле

обычно указывает версию метаданных, поддерживаемую контрактом.

Поле

содержит удобное для чтения название токена.

Поле

содержит краткий символ токена для отображения.

Поле

показывает кошелькам и приложениям, как преобразовать необработанный баланс в базовых единицах в привычный для пользователя формат.

Поля

и могут указывать на дополнительные метаданные вне блокчейна и помогать выявлять незаметную подмену.

NEP-141 обеспечивает логику токена, а NEP-148 помогает кошелькам и приложениям правильно его отображать.

Пример метаданных NEP-148

Объект метаданных NEP-148 для токена NEP-141 может выглядеть так:В этом примере показано, как метаданные помогают приложениям отображать название и символ токена, значок, ссылку на файл и точность десятичного представления.

Значение

особенно важно: пользователи обычно ожидают увидеть баланс в привычном формате, а не необработанные базовые единицы.

Поле

помогает кошелькам показывать визуальный образ токена.

Поле

может содержать ссылку на дополнительные сведения о токене.

Поле

помогает проверить, не изменился ли связанный файл метаданных неожиданным образом.

Проектам следует поддерживать метаданные в актуальном состоянии: неверные данные могут ввести пользователей в заблуждение относительно идентификатора токена, отображения предложения или бренда.

NEP-141 и управление хранилищем NEP-145

NEP-145 — стандарт управления хранилищем, обычно используемый с токенами NEP-141.

Официальный стандарт управления хранилищем NEP-145 определяет методы регистрации аккаунтов и управления депозитами за хранение.

Хранение важно, поскольку контракты NEAR должны оплачивать постоянные данные, записываемые в блокчейн.При создании записи о балансе нового аккаунта в контракте токена используется место в хранилище.Многие контракты токенов NEP-141 требуют внести депозит за хранение, прежде чем аккаунт сможет хранить токен.

Метод

может зарегистрировать аккаунт и зарезервировать место в хранилище.

Метод

позволяет проверить, зарегистрировано ли хранилище аккаунта.

Метод

может удалить регистрацию хранилища аккаунта при выполнении определенных условий.

Эта модель защищает контракты токенов от неограниченных расходов на хранение данных всех пользователей.

Депозиты за хранение токенов NEP-141

Депозит за хранение — это небольшое количество нативного NEAR, прикрепляемое для оплаты постоянного хранения данных контракта.Для токенов NEP-141 депозит за хранение часто необходим до получения токена или взаимодействия с ним.Это может удивить пользователей, привыкших к сетям, где балансы токенов могут появляться без отдельной регистрации хранилища.Такой депозит не является ценой покупки токена.Обычно он резервируется для покрытия объема данных аккаунта в контракте токена.Некоторые контракты позволяют вернуть неиспользованный депозит за хранение, если при нулевом балансе отменить регистрацию.Перед переводом, депозитом или операцией DeFi пользователям следует проверить, зарегистрирован ли аккаунт.Приложения должны сообщать о требованиях к хранилищу до того, как пользователь подпишет транзакцию.Понятное описание хранения помогает избежать неудачных переводов и недоразумений.

NEP-141 и события NEP-297

NEP-297 задает стандартный формат событий, создаваемых контрактами NEAR.

Официальный стандарт событий NEP-297 поддерживает структурированные логи, которые могут считывать индексаторы и приложения.

В документации NEAR указано, что стандартные события взаимозаменяемых токенов включают

, и .

События помогают кошелькам, обозревателям, аналитическим инструментам и индексаторам отслеживать активность токена.Например, индексатор может считывать события переводов токена, чтобы обновлять балансы и историю транзакций.Панель DeFi может использовать события для отслеживания депозитов, выводов или потоков вознаграждений.Проект может использовать данные событий для создания уведомлений или систем учета.Стандартные названия событий упрощают интеграцию: инструментам не нужно разрабатывать собственную обработку для каждого контракта токена.События улучшают наблюдаемость, но при проверке точного баланса пользователям все равно следует проверять состояние контракта.

Количество токенов NEP-141 и десятичные знаки

Количество токенов NEP-141 обычно обрабатывается в виде длинных целочисленных строк.Это позволяет избежать ошибок точности с плавающей точкой в смарт-контрактах и приложениях.

Метаданные

указывают интерфейсам, как преобразовать необработанные базовые единицы в удобное для чтения значение.

Например, у токена с 24 десятичными знаками один целый токен может отображаться как очень большое целое число в базовых единицах.Разработчикам следует хранить и рассчитывать балансы в базовых единицах.Кошелькам следует отображать балансы с учетом десятичных знаков из метаданных токена.При чтении необработанных данных транзакции пользователям следует учитывать, что исходное количество может выглядеть намного больше отображаемого баланса.Неверная обработка десятичных знаков может привести к ошибкам переводов, отображения цены и учета.Точность — одна из важнейших технических особенностей приложений взаимозаменяемых токенов.

NEP-141 и DeFi

Токены NEP-141 широко используются в приложениях DeFi на NEAR.Контракт DeFi может принимать токены NEP-141 для депозитов, обменов, кредитования, займов, вознаграждений, позиций ликвидности, залога или участия в управлении.

Метод

особенно полезен для DeFi: он позволяет перевести токены и запустить логику контракта в рамках одного процесса.

Например, пользователь может отправить токены в контракт пула и указать в сообщении, какое действие он хочет выполнить.После этого контракт-получатель может обработать депозит и при необходимости вернуть неиспользованные токены.Работа с DeFi создает дополнительные риски, помимо самого стандарта токена.Пользователи могут столкнуться с риском смарт-контрактов, ликвидности, волатильности цены, ликвидации, оракулов и токеномики.Совместимость с NEP-141 упрощает интеграцию, но не гарантирует безопасность стратегии DeFi.Перед внесением средств пользователям следует разобраться и в токене, и в протоколе.

NEP-141 и ликвидный стейкинг

Контракты ликвидного стейкинга в NEAR могут выпускать токены стандарта NEP-141.В документации NEAR объясняется, что контракт ликвидного стейкинга может выпустить токен NEP-141, который работает как другие взаимозаменяемые токены сети.В этой модели пользователь вносит нативные токены NEAR в контракт стейкинга и получает ликвидный токен, представляющий его позицию в стейкинге.Часто такой токен можно переводить или использовать в поддерживаемых приложениях DeFi.Курс ликвидного токена к базовым застейканным токенам NEAR может со временем меняться по мере накопления вознаграждений за стейкинг.Не следует считать токен ликвидного стейкинга тем же самым, что нативный NEAR.Он сопряжен с риском смарт-контракта, ликвидности, рыночной цены и правил погашения.При первом взаимодействии с контрактом ликвидного токена стейкинга может также потребоваться депозит за хранение.NEP-141 обеспечивает совместимость ликвидного токена, но не устраняет риски стейкинга или смарт-контракта.

NEP-141 и игры

Игры в NEAR могут использовать токены NEP-141 как внутриигровую валюту, вознаграждения, очки энергии, материалы для создания предметов, активы управления или платежные токены.В игре токены NEP-141 могут использоваться вместе с NFT: взаимозаменяемый токен служит для расходов, а NFT представляет уникальные предметы.Например, в игре токен NEP-141 может использоваться для оплаты покупок на маркетплейсе, а NFT NEP-171 — для персонажей или снаряжения.Такая модель с двумя типами токенов может обеспечить гибкую игровую экономику.Однако игровые токены могут обесцениваться из-за инфляции, если выдавать слишком много вознаграждений при недостаточном спросе.Разработчикам следует тщательно продумать механизмы использования и изъятия токенов, контроль предложения, правила вознаграждений и полезность.Игрокам следует выяснить, используется ли токен в действующей игре или его функции только обещаны на будущее.Игровой токен NEP-141 может соответствовать стандарту технически, но потерять ценность из-за неудачно спроектированной игровой экономики.Стандарты помогают интеграции, но долгосрочный спрос поддерживает качество игры.

NEP-141 и DAO

DAO и проекты сообществ могут использовать токены NEP-141 для управления, голосования, вознаграждений, работы казначейства или функций, связанных с членством.Токен управления может позволять владельцам голосовать по предложениям или выражать мнение сообщества.Сам контракт токена может только учитывать балансы и переводы.Логика управления обычно находится в отдельных контрактах или приложениях, которые считывают балансы токена.Пользователям следует выяснить, дает ли владение токеном реальные полномочия управления или лишь символическое влияние.При голосовании с учетом баланса крупные владельцы могут иметь больше голосов, чем мелкие.Проектам следует четко раскрывать распределение токенов, балансы казначейства, графики вестинга и правила голосования.Токен управления не следует оценивать только по его символу или активности сообщества.Фактические права управления зависят от всей конструкции системы управления, а не только от стандарта NEP-141.

NEP-141 и обернутые активы

Обернутые активы могут использовать NEP-141 для представления активов из других сетей или систем в приложениях NEAR.Обернутый токен обычно зависит от моста, кастодиана, системы выпуска и сжигания или механизма подтверждения, связывающего его с исходным активом.NEP-141 позволяет обернутому токену работать в NEAR как обычному взаимозаменяемому токену.Однако стандарт токена не подтверждает, что обернутый актив полностью обеспечен резервами.Пользователям следует разобраться в устройстве моста или кастодиального хранения, лежащего в основе любого обернутого актива.Следует проверять правила погашения, системы подтверждения, комиссии, ограничения, ликвидность и безопасность контрактов.Обернутый токен NEP-141 может быть полезен для межсетевой ликвидности, но создает дополнительные предположения о доверии и технической реализации.Приложениям следует четко обозначать обернутые активы, чтобы пользователи не путали их с нативными.Обеспечение и погашение не менее важны, чем совместимость токена.

NEP-141 и кошельки

Кошельки используют методы и метаданные NEP-141 для отображения балансов и инструментов перевода токенов.

Кошелек может вызвать

, чтобы показать баланс, и , чтобы отобразить название, символ, значок и десятичные знаки токена.

Кошелек также может помочь пользователю зарегистрировать хранилище перед получением токена.Если токен не отображается, возможно, кошелек еще не проиндексировал его, аккаунт не зарегистрирован, метаданные отсутствуют или контракт токена не поддерживается.Перед тем как доверять отображаемым активам, пользователям следует проверить имена аккаунтов контрактов токенов.Мошеннические токены могут копировать названия, символы и значки легитимных активов.Отображение токена в кошельке не является доказательством его подлинности.Для проверки токенов следует использовать официальные источники проекта, имена аккаунтов контрактов и историю транзакций.Хороший интерфейс кошелька помогает увидеть и идентификатор токена, и контракт, который его выпускает.

NEP-141 и листинги токенов

Отображение токена в приложении часто зависит от метаданных, проверки аккаунта контракта, ликвидности и признания сообщества.Токен NEP-141 может существовать в блокчейне, даже если он не отображается в кошельке, портфельном трекере, интерфейсе DeFi или аналитическом сервисе.Листинг сам по себе не означает, что токен безопасен или ценен.Отсутствие листинга не означает автоматически, что токен недействителен.Приложения могут применять собственные фильтры для ограничения спама, копирования символов, вредоносных контрактов и некачественных активов.Проектам следует публиковать официальные имена аккаунтов контрактов и метаданные, чтобы пользователи могли проверить подлинность токена.Если у токена знакомый символ, но незнакомый аккаунт контракта, пользователям следует проявлять осторожность.Идентификатор токена определяется аккаунтом контракта и проверенными источниками проекта, а не только тикером.Четкая проверка токенов снижает риск подделок.

NEP-141 и безопасность

Безопасность NEP-141 зависит от реализации контракта, разрешений аккаунтов, интеграции приложений и поведения пользователей.Токен может соответствовать NEP-141, но при этом иметь рискованные правила выпуска, слабые полномочия администратора, небезопасную логику получателя, плохое управление хранилищем или вводящие в заблуждение метаданные.Перед переводом, внесением или обменом токенов пользователям следует проверять имена аккаунтов контрактов.Следует остерегаться поддельных символов токенов, фишинговых страниц, вредоносных приложений и ссылок на получение токенов из личных сообщений.

В руководстве FTC по мошенничеству с криптовалютами рекомендуется проявлять осторожность в отношении поддельных криптовозможностей, подмены личности и обещаний высокой доходности.

Ни один легитимный контракт токена или аккаунт поддержки не должен запрашивать сид-фразу, фразу восстановления или приватный ключ.До запуска разработчикам следует протестировать переводы, вызовы при переводе, регистрацию хранилища, выпуск, сжигание и особые случаи.При необходимости проектам следует раскрывать сведения о ключах администратора, правилах обновления, полномочиях на выпуск, функциях приостановки и балансах казначейства.Безопасность относится ко всей системе, а не только к соответствию стандарту.

NEP-141 и потеря токенов

Пользователи могут потерять токены, если отправят их не на тот аккаунт, выберут неверный контракт, забудут зарегистрировать хранилище или взаимодействуют с небезопасным приложением.В отличие от централизованного баланса аккаунта, перевод токена в блокчейне может быть необратимым.Перед отправкой токенов NEP-141 следует проверить аккаунт получателя.

Перед использованием

также следует убедиться, что контракт действительно умеет принимать токены.

Отправка токенов контракту, который не предназначен для их обработки, может привести к непонятным или необратимым последствиям.Приложениям следует четко сообщать требования к получателю до подписи пользователем.При первом взаимодействии с новым контрактом пользователям следует проверить его на небольшой сумме.Следует держать достаточно нативных токенов NEAR для газа и операций с хранилищем.Внимательная проверка транзакции — самый простой способ снизить риск потери токенов.

NEP-141 и налоги

Операции с токенами NEP-141 могут вызывать вопросы о налоговой отчетности в зависимости от страны проживания и личных обстоятельств пользователя.

На официальной странице IRS о цифровых активах указано, что об операциях с цифровыми активами может требоваться отчитываться и что доход от цифровых активов может облагаться налогом.

Покупка, продажа, обмен, получение, начисление вознаграждений, стейкинг, перевод через мост или использование токенов NEP-141 может иметь налоговые последствия в некоторых юрисдикциях.Получение вознаграждений в токенах может создавать налоговые вопросы, связанные с доходом.Обмен одного токена на другой может потребовать расчета прибыли или убытка.В некоторых странах использование токена для покупки NFT или оплаты услуги также может считаться отчуждением актива.Пользователям следует хранить хеши транзакций, даты, имена аккаунтов, количество токенов, справедливую рыночную стоимость, комиссии за газ, депозиты за хранение и выручку.Проектам следует учитывать выпуск токенов, операции казначейства, вознаграждения, стимулы за предоставление ликвидности и распределение токенов.Пользователям, активно совершающим операции с токенами, следует обратиться к квалифицированному налоговому специалисту.

NEP-141 и интеллектуальная собственность

Токены NEP-141 обычно представляют взаимозаменяемые балансы, но некоторые токены могут быть связаны с брендом, игрой, сообществом, произведением искусства или медиаэкосистемой.Владение токеном автоматически не дает авторских прав, прав на товарный знак или коммерческих прав на бренд или контент проекта.

В исследовании Бюро авторского права США и USPTO о NFT объясняется, что владение токеном и права интеллектуальной собственности могут быть разными вопросами в приложениях с NFT; это же предостережение применимо к заявлениям о правах на контент, связанный с токенами.

Проект может предоставить владельцам токенов доступ, участие в управлении, вознаграждения, скидки или другие права участия.Такие права следует описывать в условиях или документации проекта.Не следует считать, что владение токеном NEP-141 означает владение брендом, протоколом, произведением искусства, игровым персонажем или компанией.Юридические права зависят от конструкции токена, документов проекта и применимого законодательства.Четкое описание прав помогает избежать недоразумений.Владение токеном следует отделять от владения интеллектуальной собственностью, если условия прямо не связывают их.

NEP-141 и токеномика

Токеномика описывает экономическую модель токена NEP-141.К важным факторам токеномики относятся общее предложение, предложение в обращении, правила выпуска и сжигания, эмиссия, вознаграждения, вестинг, распределение казначейства, полезность, комиссии, управление и ликвидность.NEP-141 определяет поведение токена, но не оценивает качество токеномики.Токен может соответствовать стандарту, но иметь ограниченную полезность, высокую инфляцию, концентрированное владение или неясные условия разблокировки.Прежде чем считать токен NEP-141 ценным, пользователям следует оценить его токеномику.Разработчикам следует объяснять, может ли предложение увеличиться и кто контролирует выпуск.Проектам следует простым языком раскрывать распределение казначейства, графики вестинга и эмиссию вознаграждений.Продуманная токеномика связывает спрос на токен с реальной активностью экосистемы.Слабая токеномика часто опирается только на ажиотаж или краткосрочные стимулы.

NEP-141 и выпуск токенов

Выпуск (minting) означает создание новых единиц токена и увеличение предложения.NEP-141 определяет поведение переводов и балансов, но конкретный метод выпуска зависит от реализации контракта.Некоторые контракты выпускают фиксированное предложение при развертывании.В некоторых контрактах владелец, DAO или уполномоченная роль могут выпускать токены позднее.В некоторых контрактах токены выпускаются как вознаграждение за стейкинг, игру, предоставление ликвидности или активность протокола.Полномочия на выпуск — один из важнейших факторов риска контракта взаимозаменяемого токена.Если один аккаунт может выпускать неограниченное количество токенов, держатели сталкиваются с риском размывания долей.Проектам следует четко раскрывать полномочия на выпуск и правила предложения.При оценке токена пользователям не следует учитывать только текущее предложение, если возможен дальнейший выпуск.

NEP-141 и сжигание токенов

Сжигание означает удаление единиц токена из обращения согласно правилам контракта.Контракт токена может сжигать токены при погашении, оплате комиссий, создании игровых предметов, сокращении предложения, принятии решений по управлению, выходе из моста или выполнении механики протокола.

При надлежащей реализации стандартные события NEP-297 помогают индексаторам отслеживать операции

.

Сжигание может сократить предложение, но само по себе не делает токен ценным.По-прежнему важны спрос, полезность, ликвидность и распределение.Пользователям следует понимать причины сжигания и то, кто может его инициировать.Проектам следует объяснять, является ли сжигание окончательным и сокращает ли оно общее предложение.Механизм сжигания необходимо проверять и тестировать: ошибки в учете предложения могут подорвать доверие.Сжигание имеет смысл только тогда, когда пользователям понятна его экономическая причина.

NEP-141 и разрешения аккаунтов

В аккаунтах NEAR могут использоваться ключи доступа с разными разрешениями.Это важно для переводов токенов NEP-141: чувствительные операции должны подписываться аккаунтом с необходимыми полномочиями.Некоторые приложения могут запрашивать ключи с ограниченным доступом, чтобы упростить повторные операции.Ограниченный доступ может улучшить удобство, но пользователям следует понимать, какие действия разрешены ключу.Вредоносные или чрезмерно широкие разрешения могут создать риск для токенов.Перед их предоставлением следует проверять разрешения приложения.Неиспользуемые или старые ключи доступа следует удалять.Проектам следует запрашивать только те разрешения, которые нужны для конкретного приложения.Безопасность аккаунта — часть безопасности токенов в NEAR.

NEP-141 и вызовы между контрактами

Вызовы между контрактами занимают центральное место в проектировании приложений NEP-141.Асинхронная модель NEAR означает, что контракты взаимодействуют посредством обещаний и callback, а не через простой синхронный стек вызовов.

Шаблон

позволяет контракту токена и контракту-получателю согласовать доставку токенов и выполнение логики приложения.

Это поддерживает депозиты, платежи, стейкинг, игры, мосты, кредитование и другие процессы смарт-контрактов.Разработчикам необходимо тщательно обрабатывать результаты callback: контракты-получатели могут завершить работу с ошибкой, отклонить токены или вернуть неиспользованное количество.Пользователям следует понимать, что депозит в контракт — не то же самое, что перевод на кошелек.После отправки токенов контракту их дальнейшая обработка определяется логикой получателя.Перед подписью приложения должны показывать пользователям аккаунт контракта-получателя и сообщение с действием.Взаимодействие между контрактами дает широкие возможности, но требует тщательного проектирования интерфейсов.

NEP-141 и индексаторы

Индексаторы считывают данные блокчейна и упорядочивают их для приложений.Для токенов NEP-141 индексаторы могут отслеживать переводы, выпуск, сжигание, балансы, держателей, метаданные контрактов и события DeFi.Стандартные логи событий упрощают эту работу: инструменты могут обрабатывать известные названия событий.Кошельки, обозреватели, налоговые инструменты, аналитические панели и портфельные трекеры могут зависеть от индексированных данных токенов.При этом индексированные данные могут поступать с задержкой, кэшироваться, быть неполными или неверными.Когда важен точный баланс, приложениям следует проверять не только результаты индексатора, но и состояние контракта.Пользователям следует помнить, что баланс на экране обычно представляет собой слой отображения данных контракта и индексатора.Хорошие индексаторы повышают удобство работы с токенами, но не заменяют контракт токена как источник истины.Разработчикам следует учитывать совместимость с индексаторами при проектировании событий и метаданных.

Как проверить токен NEP-141

Сначала найдите аккаунт контракта токена в официальном источнике проекта.Проверяйте аккаунт контракта токена, а не только его символ.

Вызовите или просмотрите

, чтобы проверить название, символ, десятичные знаки и версию спецификации.

Вызовите или просмотрите

, чтобы узнать текущее общее предложение.

Вызовите или просмотрите

, чтобы проверить баланс аккаунта.

Узнайте, нужно ли аккаунту вызвать

, прежде чем получать или использовать токен.

Изучите токеномику, полномочия на выпуск, правила сжигания, балансы казначейства и документацию проекта.Проверьте реальную полезность, ликвидность и действующие интеграции токена.Проверенный аккаунт контракта важнее знакомого названия или привлекательного значка.

Рекомендации пользователям NEP-141

Перед отправкой, получением, обменом или внесением токенов проверяйте аккаунт контракта.Держите достаточно нативных токенов NEAR для оплаты газа и депозитов за хранение.Регистрируйте хранилище, если этого требует приложение.Перед подписью переводов или вызовов при переводе изучайте запросы кошелька.Перед первым взаимодействием с новым контрактом проверяйте его на небольшой сумме.Остерегайтесь токенов, продвигаемых через личные сообщения, срочные призывы или обещания гарантированной прибыли.Проверяйте метаданные и десятичные знаки токена, прежде чем доверять отображаемому балансу.Разбирайтесь в различиях между нативным NEAR и токенами NEP-141.Ведите учет для налоговой отчетности, бухгалтерии и личного контроля.Считайте взаимодействие с токеном необратимым, если контракт явно не предусматривает возврат.

Рекомендации разработчикам NEP-141

Корректно реализуйте основной интерфейс NEP-141.Также реализуйте метаданные NEP-148, чтобы кошельки могли правильно отображать токен.Используйте управление хранилищем NEP-145, чтобы не допустить злоупотребления расходами на хранение.Создавайте стандартные события NEP-297 для переводов, выпуска и сжигания.

Тщательно обрабатывайте особые случаи

и .

Тестируйте возвраты, неудачные вызовы получателя, нулевые и небольшие суммы, регистрацию хранилища и несанкционированные действия.Документируйте полномочия на выпуск и сжигание, права на обновление, ключи владельца, функции приостановки и работу казначейства.Не допускайте скрытых административных полномочий, которые могут стать неожиданностью для пользователей.Хороший контракт NEP-141 должен быть совместимым, безопасным, прозрачным и простым для интеграции в приложения.

Распространенные ошибки при работе с NEP-141

Одна из распространенных ошибок — считать, что токены NEP-141 хранятся непосредственно в аккаунте пользователя.Другая ошибка — забывать, что балансы внутри контракта учитывает сам контракт токена.Третья — отправлять токены до того, как получатель зарегистрировал хранилище.Четвертая — путать нативный NEAR с токеном NEP-141.Пятая — доверять символу токена, не проверив аккаунт контракта.Шестая — игнорировать десятичные знаки и неправильно читать необработанное количество токенов.

Седьмая — использовать

с неизвестным контрактом-получателем.

Восьмая — считать соответствие стандарту гарантией безопасной токеномики.Девятая — не учитывать полномочия на выпуск или разрешения на обновление.Десятая — не вести налоговый учет и историю транзакций.

Распространенные заблуждения о NEP-141

Распространенное заблуждение — считать NEP-141 тем же самым, что и нативный токен NEAR.На самом деле NEP-141 — стандарт взаимозаменяемых токенов на базе смарт-контрактов, а нативный NEAR — базовый актив сети.Еще одно заблуждение — считать безопасным любой токен NEP-141 только потому, что он соответствует стандарту.Даже токен, соответствующий стандарту, может быть связан с мошенничеством, низкой ликвидностью, слабой токеномикой или опасными полномочиями администратора.Третье заблуждение — считать метаданные доказательством подлинности.Метаданные можно скопировать, поэтому аккаунт контракта и официальные источники проекта важнее одного только символа или значка.Четвертое заблуждение — считать депозиты за хранение безвозвратно потерянными комиссиями.Некоторые контракты позволяют вернуть неиспользованный депозит за хранение, если отменить регистрацию при выполнении необходимых условий.

Пятое заблуждение — считать

обычным переводом.

Это перевод с одновременным запуском логики контракта-получателя, поэтому перед подписью пользователям следует разобраться в работе целевого контракта.

Кратко о NEP-141 (NEAR): SEO и AEO

NEP-141 — стандарт взаимозаменяемых токенов для смарт-контрактов в блокчейне NEAR.

Он определяет стандартные методы, такие как

, , , , и .

Токены NEP-141 учитываются в смарт-контрактах, а не непосредственно в аккаунтах пользователей.NEP-148 добавляет метаданные взаимозаменяемых токенов, например название, символ, значок, десятичные знаки, ссылку и хеш ссылки.NEP-145 отвечает за управление хранилищем, регистрацию аккаунтов и покрытие расходов на постоянное хранение данных в контрактах токенов.

NEP-297 поддерживает стандартные события, например

, и .

NEP-141 подходит для стабильных активов, служебных токенов, токенов управления, токенов ликвидного стейкинга, игровых валют, токенов вознаграждения, обернутых активов и токенов DeFi.Перед взаимодействием с токеном NEP-141 пользователям следует проверять аккаунт контракта, метаданные, регистрацию хранилища, токеномику, разрешения, налоги и безопасность.

FAQ

Что означает NEP-141?

NEP-141 — стандарт взаимозаменяемых токенов для смарт-контрактов в блокчейне NEAR.

NEP-141 — это то же самое, что нативный NEAR?

Нет. Нативный NEAR — базовый актив сети, а NEP-141 — стандарт токенов, выпускаемых смарт-контрактами.

Какие методы входят в NEP-141?

NEP-141 включает методы, такие как

, , , и .

Что такое

ft_transfer

?

— стандартный метод отправки указанного количества токенов NEP-141 с аккаунта вызывающего пользователя на другой аккаунт NEAR.

Что такое

ft_transfer_call

?

отправляет токены контракту-получателю и запускает логику этого контракта в рамках одного процесса перевода.

Зачем токенам NEP-141 нужны депозиты за хранение?

Депозиты за хранение помогают оплачивать постоянное хранение данных в блокчейне, когда контракты токенов записывают сведения о балансе аккаунта.

Что такое NEP-148?

NEP-148 — стандарт метаданных взаимозаменяемых токенов, определяющий такие поля, как название, символ, значок, десятичные знаки, ссылка и хеш ссылки.

Можно ли использовать токены NEP-141 в DeFi?

Да. Токены NEP-141 можно использовать для депозитов в DeFi, обменов, пулов ликвидности, стейкинга, вознаграждений, управления и других процессов смарт-контрактов.

Безопасны ли все токены NEP-141?

Нет. Совместимость с NEP-141 не гарантирует безопасность, ликвидность, справедливую токеномику, защищенность контрактов или добросовестность проекта.

Как проверить токен NEP-141?

Проверить токен NEP-141 можно по официальному аккаунту контракта, метаданным, общему предложению, методам проверки баланса, регистрации хранилища, токеномике и документации проекта.

Заключение

NEP-141 — основной стандарт взаимозаменяемых токенов в блокчейне NEAR.Он предоставляет контрактам токенов общий интерфейс для проверки предложения и балансов, переводов, вызовов при переводе и обработки их результатов.Стандарт помогает кошелькам, протоколам DeFi, играм, DAO, аналитическим инструментам и другим приложениям надежнее интегрировать взаимозаменяемые токены.NEP-141 наиболее эффективен в сочетании с метаданными NEP-148, управлением хранилищем NEP-145 и стандартными событиями NEP-297.Для пользователей особенно важны проверка аккаунта контракта, регистрация хранилища, десятичные знаки, газ в нативном NEAR и проверка запросов кошелька.Разработчикам особенно важно корректно реализовать интерфейс, обеспечить безопасную логику вызовов при переводе, подготовить понятные метаданные, надежно управлять хранилищем, использовать стандартные события и прозрачно описывать полномочия администратора.NEP-141 обеспечивает совместимость, но сам по себе не создает надежную токеномику, ликвидность, полезность или доверие.

В приложениях DeFi и играх NEP-141 поддерживает сложные процессы с помощью

, но безопасность контракта-получателя по-прежнему важна.

Токен NEP-141 может быть полезным, ликвидным и широко интегрированным, если он хорошо разработан и управляется.Токен NEP-141 также может быть рискованным из-за вводящих в заблуждение метаданных, слабой безопасности, неясных правил предложения, низкой ликвидности или небезопасных контрактов.Лучше всего понимать NEP-141 как техническую основу взаимозаменяемых токенов в NEAR, а не как гарантию их ценности или подлинности.При ответственном использовании NEP-141 помогает NEAR поддерживать платежи, DeFi, игры, вознаграждения, ликвидный стейкинг, управление и множество других сценариев применения криптотокенов.