Vilna Widget

Vilna Widget - это браузерное расширение-кошелёк, которое интегрируется напрямую с личным кабинетом Vilna. Оно позволяет хранить приватные ключи локально в браузере и подписывать транзакции одним кликом - без передачи ключей на серверы Vilna или третьим сторонам.

Widget будет браузерным расширением для Chrome, Firefox и Opera. После выпуска и установки оно будет работать как локальный кошелёк, подключённый к вашему личному кабинету Vilna.

• Локальное хранение ключей - ваши приватные ключи хранятся в браузере и никогда не покидают ваше устройство
• Интеграция с личным кабинетом - адреса, добавленные в Widget, автоматически появляются в личном кабинете Vilna с полной информацией о балансах
• Подписание одним кликом - инициируйте транзакции из личного кабинета, подтверждайте их во всплывающем окне Widget
• Мультичейн - поддержка сетей Ethereum, BNB Smart Chain и TRON (основная сеть и тестовая сеть)

Widget хранит ваши приватные ключи в браузере, позволяя подписывать транзакции без переключения на отдельный кошелёк. Поддерживает HD-кошельки (создание или импорт через мнемоническую сид-фразу) и управление адресами в сетях Ethereum, BSC и TRON из одного расширения. Подробности о защите ключей см. в разделе Модель безопасности ниже.

1. Установите Vilna Widget из магазина расширений вашего браузера.
2. Создайте или импортируйте кошелёк. Сгенерируйте новый HD-кошелёк или импортируйте существующий с помощью мнемонической сид-фразы.
3. Ваши адреса появятся в Widget и станут доступны в личном кабинете Vilna с полной информацией о балансах.
4. Инициируйте транзакцию из личного кабинета Vilna, когда вам нужно отправить средства.
5. Проверьте детали. Появится всплывающее окно Widget с указанием получателя, суммы, сети и предполагаемой комиссии.
6. Подтвердите. Widget подписывает транзакцию локально, используя ваш приватный ключ.
7. Отправка в сеть. Widget отправляет подписанную транзакцию в блокчейн с вашего устройства.
8. Отслеживайте статус. Наблюдайте за транзакцией в реальном времени с помощью инструментов индексации и мониторинга Vilna.

Ваш приватный ключ используется только на шаге 6, внутри расширения, на вашем устройстве. Он никогда никуда не передаётся.

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

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

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

Если вы создаёте веб-приложение, которому необходимо программно взаимодействовать с Widget, используйте npm-пакет @vilna-io/storage-client:

npm install @vilna-io/storage-client

import { connect } from "@vilna-io/storage-client";

const client = await connect();

// Check supported networks
const networks = await client.getSupportedNetworks();

// Send a transaction (triggers Widget popup for user confirmation)
const result = await client.sendTransaction({
  chainId: "eip155:1",
  address: "0xYourAddress...",
  derivationPath: "m/44'/60'/0'/0/0",
  transaction: {
    to: "0xRecipient...",
    value: "1000000000000000000", // 1 ETH in Wei
  },
});

Библиотека storage-client обеспечивает взаимодействие между вашим веб-приложением и расширением Widget. См. документацию storage-client для полного справочника API.

Widget спроектирован так, чтобы работать как кошельки вроде MetaMask: ключи остаются на вашем устройстве, и ничего не подписывается без вас. Это целевые гарантии, которые мы сверим с выпущенным кодом до выдачи клиентам.

• Приватные ключи хранятся в зашифрованном виде в собственном хранилище расширения, изолированном от веб-страниц.
• Ключ расшифровывается в памяти только в момент подписи, а расшифрованные данные никогда не записываются в хранилище и никуда не передаются.
• Каждая подпись требует вашего явного подтверждения в окне Widget. Ничего не подписывается автоматически.
• Ключи никогда не покидают ваше устройство. Они не попадают на серверы Vilna и не передаются по сети; в блокчейн уходит только подписанная транзакция.
• Применяется Content Security Policy для защиты от атак внедрения.

Widget пока недоступен. Эти шаги будут применимы после его выпуска для Chrome, Firefox и Opera.

1. Установите расширение Vilna Widget для вашего браузера.
2. Создайте новый HD-кошелёк или импортируйте существующий с помощью сид-фразы.
3. Подключитесь к личному кабинету Vilna - ваши адреса и балансы появятся автоматически.
4. Начинайте управлять активами и подписывать транзакции.

По вопросам и для получения поддержки обращайтесь на support@vilna.io.