Bucket API 4EVERLAND для децентрализованного хранилища объектов

За последние несколько лет наблюдается значительный рост использования децентрализованных хранилищ. Одна из крупнейших децентрализованных сетей хранения, Filecoin и Arweave, принесли значительные инновации в виде надежных фреймворков, которые используют децентрализованную инфраструктуру для хранения и управления данными. Одной из таких сред является корзина 4EVERLAND, которая позволяет загружать и закреплять файлы в IPFS и Arweave.

Как работает 4EVERLAND Bucket?

Ведро 4EVERLAND — это децентрализованная инфраструктура хранения объектов, которая позволяет пользователям загружать изображения, видео и другие поддерживаемые файлы в децентрализованные сети хранения, такие как IPFS. Загружая файл в корзину 4EVERLAND, вы получаете хэш IPFS, который можно использовать для проверки децентрализованного хранения данных. У вас также есть возможность загружать файлы через Arweave, который предлагает постоянное хранилище. 4EVERLAND Bucket можно использовать двумя способами:

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

2. Интеграция API 4EVERLAND Buckets API совместим с Amazon S3, сервисом хранения объектов, предоставляемым Amazon. Процесс настройки API-интерфейса 4EVERLAND Buckets очень похож на процесс настройки Amazon S3, но конечные точки будут указывать на API-интерфейс 4EVERLAND.

Как только вы загрузите файл, его можно будет увидеть на панели инструментов 4EVERLAND. Некоторые из вещей, которые вы можете делать с 4EVERLANDs S3 API:

• Получение ведра

• Файл загружен

• Список файлов в ведре

• Получение хеша IPFS

Как использовать Bucket API 4EVERLAND?

API корзины 4EVERLAND прост в использовании, и его можно использовать на платформах, таких как React, для развертывания одностраничного приложения или для загрузки изображений или файлов во внешний интерфейс.

Для начала. вам нужно будет установить зависимости. Для этого вам нужно иметь npm в вашей среде разработки. Ниже приведены команды для установки AWS SDK:

установка npm @aws-sdk/client-s3

После установки мы перейдем к определению конечной точки для нашего API. 4EVERLAND использует https://endpoint.4everland.co в качестве конечной точки. Нам также потребуются наши токены аутентификации, которые можно получить на панели инструментов 4EVERLAND, как показано на изображении ниже.

Как только вы получите свой токен, мы приступим к начальной настройке вашей системы хранения s3.

const AWS = требуется ('aws-sdk');

const As3 = новый AWS.s3({

apiVersion: '2022-04-25',

accessKeyID: 'Укажите APIKeyздесь',

secretAccessKey: 'specifySecretHere',

конечная точка: «https://endpoint.4everland.co»,

регион: 'сша-север-1',

s3ForcePathStyle: правда

После настройки вы можете перейти к вызову таких команд, как ListObjects, для игры с клиентом S3.

Если вы хотите загрузить файл в свою корзину, вы можете использовать команду putObject, и конфигурация будет выглядеть следующим образом:

Загрузка файла в корзину 4EVERLAND

константа FileUpload = {

Ведро: «тестирование»,

ключ: «Главная/хакатон»,

Тип содержимого: «изображение»,

Тело: hackathonFile,

ACL: «Общедоступный»,

постоянный запрос = s3.putObject(FileUpload);

request.on('заголовок'), (statusCode, заголовки) => {

const ipfsHash = headers['4everland-hash'];

}).Отправить();

В приведенном выше фрагменте кода мы создали запрос на загрузку файла в мою корзину 4EVERLAND, которая «тестируется». Мы также использовали команду putObject для загрузки файла в Bucket из моей локальной среды.

Отрезанный также включает запрос на получение хэша IPFS объекта. Когда вы загружаете файл в корзину 4EVERLAND, 4EVERLAND вставляет хэш IPFS в http-заголовок файла.

После загрузки файлов у вас есть возможность синхронизировать контент с Arweave (AR) через корзину 4EVERLNAD. Эта опция недоступна через интерфейс командной строки, но ее можно сделать через панель инструментов. Все, что вам нужно сделать, это перейти в «Корзины»> «Нажмите на корзину, которую вы хотите синхронизировать с файлами AR»> «Синхронизировать содержимое с AR». После синхронизации контента вы получите доступ к хэшу AR, чтобы убедиться, что информация хранится в Arweave.

Получение файлов из корзины 4EVERLAND

С помощью S3 SDK вы также можете получить сегменты, в которых хранятся файлы.

константный список файлов = {

Ведро: "тестирование",

s3.listObjectsV2 (тестирование, функция (ошибка, список) {

если (ошибка) {

console.log("Ошибка, проверьте еще раз!", err);

} еще {

console.log("Объекты отображаются правильно", список);

Помимо извлечения файлов, вы также можете перечислить ведра, в которых хранятся ваши файлы. Ниже приведен простой пример того, как это можно сделать с помощью команды listBuckets:

s3.listBuckets (функция (ошибка, список) {

если (ошибка) {

console.log("ошибка при выводе списка сегментов", err);

} еще {

console.log("данные указаны правильно", список);

Еще один вариант перечисления объектов — через [AWS CLI] (https://aws.amazon.com/cli/). В интерфейсе командной строки запустите «aws configure», чтобы определить ключи доступа и секретный ключ. Оттуда вы можете перечислить объекты, запустив:

aws --endpoint-url https://endpoint.4everland.co s3 ls s3://testing

Ограничения

Есть несколько ограничений на использование S3, которые были отмечены в [документации 4EVERLAND] (https://docs.4everland.org/bucket-api/#limits-of-s3-api/). Некоторые ограничения, такие как длина имен корзин, могут быть смягчены с помощью панели инструментов корзин, которая обеспечивает большую гибкость.

Есть много других вариантов использования корзин 4EVERLAND на основе команд s3, перечисленных в Документации.

Вывод

API корзин 4EVERLAND — отличная альтернатива для пользователей, привыкших к корзинам Amazon AS3. Используя API, ваши объекты хранятся в децентрализованном хранилище, защищенном от цензуры и очень надежном. 4EVERLAND также позволяет синхронизировать ваши файлы с Arweave, который обеспечивает постоянное хранение файлов.