Описание работы программного обеспечения «Информационная система – сеть транзакций с правами и объектами
интеллектуальной собственности IPChain»
1 ОПИСАНИЕ
«Информационная система – сеть транзакций с правами и объектами интеллектуальной собственности IPChain» (далее Сеть IPChain) создана и работает в соответствии с функциональными и техническими требованиями к общественной сетевой платформе управления правами на результаты интеллектуальной деятельности и средства индивидуализации в цифровой среде, утверждённые Министерством науки и высшего образования Российской федерации, Министерством культуры Российской Федерации и Министерством цифрового развития, связи и массовых коммуникаций Российской Федерации.
Сеть IPChain построена на основе стека программных продуктов (базового программного обеспечения) HyperLedger Fabric - распределённый реестр транзакций, использует в том числе следующие программные продукты:
HyperLedger Fabric позволяет создать реестр (базу данных), распределённый между всеми участниками сети. Информация об изменении записей в базе данных помещается в блоки, генерируемые в единицу времени или по достижении предельного количества записей в одном блоке. Каждый блок содержит хеш запись, полученную с учётом информации о предыдущем блоке, в том числе его содержании. Наличие хеш записей соединяет блоки в единую, неразрывную и неизменную цепочку блоков - технология блокчейн.
Содержание исходной информации о транзакциях в блоках обеспечивает её неизменность и гарантирует сохранность. Информация после размещения больше никогда не может быть утеряна или изменена. Это принципиальное отличие платформы HyperLedger Fabric от децентрализованных систем на основе протоколов Bitcoin, Ethereum и аналогов, которые в блокчейне содержат только хеш от записей в сторонней базе данных, который не позволяет их (записи в базе данных) восстановить в случае изменения или утраты.
Информация для администраторов подключаемых организаций размещена в разделе: tech.ipchain.ru
Информация для разработчиков размещена в разделе: developer.ipchain.ru
«Информационная система – сеть транзакций с правами и объектами интеллектуальной собственности IPChain» (далее Сеть IPChain) создана и работает в соответствии с функциональными и техническими требованиями к общественной сетевой платформе управления правами на результаты интеллектуальной деятельности и средства индивидуализации в цифровой среде, утверждённые Министерством науки и высшего образования Российской федерации, Министерством культуры Российской Федерации и Министерством цифрового развития, связи и массовых коммуникаций Российской Федерации.
Сеть IPChain построена на основе стека программных продуктов (базового программного обеспечения) HyperLedger Fabric - распределённый реестр транзакций, использует в том числе следующие программные продукты:
- CouchDB - база данных содержащая транзакции с правами и актуальное состояние объектов в распределенном реестре;
- Kafka - брокер сообщений, используется для сервиса организации очереди регистрации транзакций и записи в блоки;
- ZooKeeper - содержит конфигурацию и актуальное состояние узлов сервиса очереди.
HyperLedger Fabric позволяет создать реестр (базу данных), распределённый между всеми участниками сети. Информация об изменении записей в базе данных помещается в блоки, генерируемые в единицу времени или по достижении предельного количества записей в одном блоке. Каждый блок содержит хеш запись, полученную с учётом информации о предыдущем блоке, в том числе его содержании. Наличие хеш записей соединяет блоки в единую, неразрывную и неизменную цепочку блоков - технология блокчейн.
Содержание исходной информации о транзакциях в блоках обеспечивает её неизменность и гарантирует сохранность. Информация после размещения больше никогда не может быть утеряна или изменена. Это принципиальное отличие платформы HyperLedger Fabric от децентрализованных систем на основе протоколов Bitcoin, Ethereum и аналогов, которые в блокчейне содержат только хеш от записей в сторонней базе данных, который не позволяет их (записи в базе данных) восстановить в случае изменения или утраты.
Информация для администраторов подключаемых организаций размещена в разделе: tech.ipchain.ru
Информация для разработчиков размещена в разделе: developer.ipchain.ru
2 СЕТЬ ТРАНЗАКЦИЙ
Институт интеллектуальной собственности является ядром современной глобальной экономики – появление новых результатов интеллектуальной, творческой деятельности, их правовая охрана предшествуют производству товаров и созданию новых услуг. В стоимости большинства из них – продуктов, которые обеспечивают качество нашей жизни и наши возможности, – доля нематериальной составляющей уже достигает восьмидесяти и более процентов. Благодаря развитию технологий интеллектуальная собственность обретает новый масштаб и значимость.
Основа интеллектуальной собственности – право автора, изобретателя использовать результаты своей творческой деятельности. Доступность скоростных цифровых сетей связи, возможность получить и использовать любой объект в любой точке мира – от прослушивания музыки и просмотра фильма до производства мебели, одежды и даже автомобиля – не позволяют автору контролировать оборот принадлежащего ему результата. Традиционному институту патентования все сложнее справиться с экспоненциально растущей сложностью объектов. Обычные договоры с трудом позволяют урегулировать отношения в многообразных цепочках сделок и моделях использования интеллектуального продукта.
Но вызовы, брошенные системе интеллектуального права цифровыми технологиями, создают не только проблемы – они являются источником новых возможностей: сегодня технологии, рожденные правом, развивают право. Возможности цифрового моделирования и конструирования, распределенные реестры и «умные контракты» являются удивительными инструментами, способными сформировать рынок интеллектуальных продуктов и услуг на совсем близком горизонте.
Для создания и использования самых современных технических решений, своевременного и адекватного ответа на технологические вызовы создана децентрализованная сеть транзакций с правами и объектами интеллектуальной собственности IPCHAIN.
Сеть позволяет быстро закреплять и удобно распоряжаться правами, обеспечивать выплату справедливого вознаграждения, гарантируя всем участникам рынка прозрачность, безопасность и невероятную скорость взаимодействия, создавая уникальное цифровое пространство доверия.
2.1 СЕТЬ ТРАНЗАКЦИЙ С ПРАВАМИ И ОБЪЕКТАМИ ИНТЕЛЛЕКТУАЛЬНОЙ СОБСТВЕННОСТИ
Для создания и использования самых современных технических решений для развития и эффективного использования института интеллектуального права создана децентрализованная сеть (распределенный реестр) IPCHAIN, в которой фиксируются транзакции с правами и объектами интеллектуальной собственности.
Информация сети IPCHAIN о правах и объектах интеллектуальной собственности, а также атомарные транзакции, которые фиксируются распределенным реестром IPCHAIN, – наиболее значимые и отражающие ключевые факты для всех участников сферы виды публичных информационных записей.
Транзакции в сети информируют о…:
2.2 ЦИФРОВОЕ ПРОСТРАНСТВО ДОВЕРИЯ
Децентрализованная сеть IPCHAIN создает уникальные возможности для реализации интеллектуальных прав, в полной мере отвечающие вызовам эпохи «цифровизации».
Для авторов – возможность быстрого закрепления прав и приоритета, а в случае результатов, ориентированных на промышленное применение, – поэтапной экспертизы в профессиональных организациях и выхода на получение патента.
Для научных и образовательных организаций – свободу вовлечения результатов как в некоммерческий оборот для научных и образовательных целей, так и в коммерческий, помогая эффективно выстраивать систему управления правами, в первую очередь – формирование эффективных механизмов выплаты справедливого вознаграждения.
Для институтов инновационного развития – создание новых продуктов и услуг по управлению интеллектуальной собственностью на общей цифровой платформе, упрощение взаимодействия с государством при учете результатов, государственной регистрации прав, досудебном и судебном урегулировании споров.
Для организаций по коллективному управлению правами – обеспечение прозрачности использования объектов для правообладателей, и свободный обмен информацией между реестрами объектов и данных об их использовании.
Децентрализованная сеть IPCHAIN формирует единое цифровое пространство доверия, позволяющее всем участникам сети владеть актуальной информацией о созданных объектах, отслеживая эволюцию их правовой охраны и цепочек сделок независимо от того, в каких режимах происходит лицензирование объектов, и сложности таких цепочек.
Сеть обеспечивает недостижимые ранее гарантии и существенно снижает риски при сделках с объектами за счет открытости информации о спорах и конфликтах – как урегулированных, так и находящихся в процессе урегулирования.
Сеть является платформой для развития самых разных сервисов в сфере интеллектуальной собственности, делает рынок услуг прозрачным. Информация, позволяющая сделать вывод о качестве услуг, от подачи патентов до разрешения конфликтов, может быть получена из узла-инспектора сети.
Наконец, децентрализованная сеть IPCHAIN и сеть репозитариев позволяют хранить и вводить в оборот объекты самой разной природы, в том числе созданные с помощью «искусственного интеллекта».
При этом все операции и возможности развития, которые предоставляет децентрализованная сеть транзакций IPCHAIN, в полной мере соответствуют нормам национального права, международных договоров и соглашений, предоставляя возможность их точной имплементации в цифровой среде.
Институт интеллектуальной собственности является ядром современной глобальной экономики – появление новых результатов интеллектуальной, творческой деятельности, их правовая охрана предшествуют производству товаров и созданию новых услуг. В стоимости большинства из них – продуктов, которые обеспечивают качество нашей жизни и наши возможности, – доля нематериальной составляющей уже достигает восьмидесяти и более процентов. Благодаря развитию технологий интеллектуальная собственность обретает новый масштаб и значимость.
Основа интеллектуальной собственности – право автора, изобретателя использовать результаты своей творческой деятельности. Доступность скоростных цифровых сетей связи, возможность получить и использовать любой объект в любой точке мира – от прослушивания музыки и просмотра фильма до производства мебели, одежды и даже автомобиля – не позволяют автору контролировать оборот принадлежащего ему результата. Традиционному институту патентования все сложнее справиться с экспоненциально растущей сложностью объектов. Обычные договоры с трудом позволяют урегулировать отношения в многообразных цепочках сделок и моделях использования интеллектуального продукта.
Но вызовы, брошенные системе интеллектуального права цифровыми технологиями, создают не только проблемы – они являются источником новых возможностей: сегодня технологии, рожденные правом, развивают право. Возможности цифрового моделирования и конструирования, распределенные реестры и «умные контракты» являются удивительными инструментами, способными сформировать рынок интеллектуальных продуктов и услуг на совсем близком горизонте.
Для создания и использования самых современных технических решений, своевременного и адекватного ответа на технологические вызовы создана децентрализованная сеть транзакций с правами и объектами интеллектуальной собственности IPCHAIN.
Сеть позволяет быстро закреплять и удобно распоряжаться правами, обеспечивать выплату справедливого вознаграждения, гарантируя всем участникам рынка прозрачность, безопасность и невероятную скорость взаимодействия, создавая уникальное цифровое пространство доверия.
2.1 СЕТЬ ТРАНЗАКЦИЙ С ПРАВАМИ И ОБЪЕКТАМИ ИНТЕЛЛЕКТУАЛЬНОЙ СОБСТВЕННОСТИ
Для создания и использования самых современных технических решений для развития и эффективного использования института интеллектуального права создана децентрализованная сеть (распределенный реестр) IPCHAIN, в которой фиксируются транзакции с правами и объектами интеллектуальной собственности.
Информация сети IPCHAIN о правах и объектах интеллектуальной собственности, а также атомарные транзакции, которые фиксируются распределенным реестром IPCHAIN, – наиболее значимые и отражающие ключевые факты для всех участников сферы виды публичных информационных записей.
Транзакции в сети информируют о…:
- Creazione - создании нового объекта, способе его создания и использованных объектах;
- Accesso - режиме доступности объекта, правообладателе объекта;
- Garanzia - выполнении действий, создающих дополнительные гарантии права при использовании объекта, в первую очередь – различные виды обязательной и добровольной экспертизы
- Valore - возникновение стоимости объекта, информация о его оценке или использовании в финансовой отчетности;
- kOnflitto - возникновении спора (конфликта) или его разрешения;
- Transazione - начале или завершении сделки с правами.
2.2 ЦИФРОВОЕ ПРОСТРАНСТВО ДОВЕРИЯ
Децентрализованная сеть IPCHAIN создает уникальные возможности для реализации интеллектуальных прав, в полной мере отвечающие вызовам эпохи «цифровизации».
Для авторов – возможность быстрого закрепления прав и приоритета, а в случае результатов, ориентированных на промышленное применение, – поэтапной экспертизы в профессиональных организациях и выхода на получение патента.
Для научных и образовательных организаций – свободу вовлечения результатов как в некоммерческий оборот для научных и образовательных целей, так и в коммерческий, помогая эффективно выстраивать систему управления правами, в первую очередь – формирование эффективных механизмов выплаты справедливого вознаграждения.
Для институтов инновационного развития – создание новых продуктов и услуг по управлению интеллектуальной собственностью на общей цифровой платформе, упрощение взаимодействия с государством при учете результатов, государственной регистрации прав, досудебном и судебном урегулировании споров.
Для организаций по коллективному управлению правами – обеспечение прозрачности использования объектов для правообладателей, и свободный обмен информацией между реестрами объектов и данных об их использовании.
Децентрализованная сеть IPCHAIN формирует единое цифровое пространство доверия, позволяющее всем участникам сети владеть актуальной информацией о созданных объектах, отслеживая эволюцию их правовой охраны и цепочек сделок независимо от того, в каких режимах происходит лицензирование объектов, и сложности таких цепочек.
Сеть обеспечивает недостижимые ранее гарантии и существенно снижает риски при сделках с объектами за счет открытости информации о спорах и конфликтах – как урегулированных, так и находящихся в процессе урегулирования.
Сеть является платформой для развития самых разных сервисов в сфере интеллектуальной собственности, делает рынок услуг прозрачным. Информация, позволяющая сделать вывод о качестве услуг, от подачи патентов до разрешения конфликтов, может быть получена из узла-инспектора сети.
Наконец, децентрализованная сеть IPCHAIN и сеть репозитариев позволяют хранить и вводить в оборот объекты самой разной природы, в том числе созданные с помощью «искусственного интеллекта».
При этом все операции и возможности развития, которые предоставляет децентрализованная сеть транзакций IPCHAIN, в полной мере соответствуют нормам национального права, международных договоров и соглашений, предоставляя возможность их точной имплементации в цифровой среде.
3 ОПИСАНИЕ REST-СЕРВИСА (API, GATEWAY) ДЛЯ РАБОТЫ С СЕТЬЮ IPCHAIN
Описание методов API и структур данных размещено публично в разделе для разработчиков: https://developer.ipchain.ru
Описание методов API в машино-читаемом виде (формат swagger 2.0, YAML) размещено по адресу: https://developer.ipchain.ru/api.yml
Swagger specification for IPCHAIN API содержит набор методов и описания цифровых моделей данных для регистрации атомарных транзакций в распределённом реестре транзакций с объектами и правами интеллектуальной собственности (далее объектами и правами), а так же чтения информации из реестра.
3.1 ТЕРМИНЫ И ОПРЕДЕЛЕНИЯ
1. Объект интеллектуальной собственности (object) - созданный непосредственно творческим, интеллектуальным трудом, включая синтезированный (полученный, переработанный) с применением различных программ и алгоритмов, результат, имеющий ценность для научных, информационных, образовательных, социальных или экономических процессов, в том числе признаваемый в качестве результата интеллектуальной деятельности или средства индивидуализации.
2. Транзакция (транзакция с правами и объектами интеллектуальной собственности) (transaction) - описание в цифровой (машиночитаемой) форме (структура транзакций, обязательные атрибуты приведены в разделе Models), содержащееся в блоках транзакций наиболее значимых для всех участников сети (рынка интеллектуальной собственности) видов публичных информационных записей, отражающих ключевые факты в отношении объектов и прав на них, которые принимаются участниками сети в качестве инварианта и не выражаются в последовательности других операций, и отражающих факт:
3. транзакция (tx) - структура данных, содержащая неспецифичную, специфичную и системную информацию о транзакции, являющаяся самостоятельной логической единицей, хранящиеся в распределенном реестре, который ведется операторами сети.
4. Неспецифичная информация - минимально необходимая, но достаточная информация, описывающая транзакцию, объем и формат которой установлен организатором сети.
5. Специфичная информация - дополнительная информация, описывающая транзакцию, характерную для конкретного вида объектов и операций с ним и (или) обусловленная особенностями деятельности оператора сети, объем и формат которой определяется оператором сети самостоятельно.
6. Системная информация - информация, сгенерированная реестром в процессе регистрации транзакции, содержащая дату и время регистрации транзакции, информацию о пользователе, выполнившим запрос о регистрации транзакции и т.д.
7. Цепочка (последовательность) блоков транзакций - структура данных, позволяющая выстроить в одну цепочку блоки транзакцй, формируемая таким образом, чтобы не допустить подмены или искажения информации, содержащейся в них, а также даты и времени формирования блоков. Каждый новый блок осуществляет подтверждение транзакций, информацию о которых содержит и дополнительное подтверждение транзакций в предыдущем блоке цепочки.
8. Распределённый реестр транзакций - распределенная между узлами сети база данных, содержащая блоки транзакций, формируемая как непрерывно растущая цепочка блоков с записями обо всех транзакциях. Копия базы и (или) ее фрагментов одновременно хранится на множестве узлов национальной сети и синхронизируется операторами сети согласно установленным организатором сети правилам построения цепочки блоков.
9. Узел сети - программно-аппаратный комплекс, функционирование которого обеспечивает оператор сети, и содержащий программное обеспечение для формирования транзакций и поддержания работоспособности распределенного реестра транзакций и взаимодействующий посредством сети передачи данных с другими аналогичными узлами в соответствии с правилами, установленными организатором сети.
10. Программа для ЭВМ «Информационная система – сеть транзакций с правами и объектами интеллектуальной собственности IPChain» - совокупность программно-аппаратных решений, развёрнутых операторами сети и обеспечивающих функционирование распределенного реестра транзакций и взаимодействие между такими операторами.
11. Участник сети (оператор сети, оператор распределённой базы данных транзакций) физическое или юридическое лицо, имеющее учетную запись в распределенном реестре транзакций и поддерживающий постоянно работающий один или несколько узлов сети, с размещенным программным обеспечением, выполняющим, в том числе функции создания новых блоков транзакций и (или) проверку блоков, сформированных другими узлами сети, согласование закрытия блока с другими узлами сети, передачу изменений между узлами сети и хранение полной истории транзакций.
12. Пользователь сети - лицо, создавшее сервис, обеспечивающий работу и (или) оказание услуг, связанных с объектами интеллектуальной собственности и правами на них и (или) использовавший такие сервисы, а также получающие информацию о транзакциях из сети за счет использования программного обеспечения узлов сети.
13. tx - запись в распределённом реестре, содержащая информацию о транзакции.
Описание методов API и структур данных размещено публично в разделе для разработчиков: https://developer.ipchain.ru
Описание методов API в машино-читаемом виде (формат swagger 2.0, YAML) размещено по адресу: https://developer.ipchain.ru/api.yml
Swagger specification for IPCHAIN API содержит набор методов и описания цифровых моделей данных для регистрации атомарных транзакций в распределённом реестре транзакций с объектами и правами интеллектуальной собственности (далее объектами и правами), а так же чтения информации из реестра.
3.1 ТЕРМИНЫ И ОПРЕДЕЛЕНИЯ
1. Объект интеллектуальной собственности (object) - созданный непосредственно творческим, интеллектуальным трудом, включая синтезированный (полученный, переработанный) с применением различных программ и алгоритмов, результат, имеющий ценность для научных, информационных, образовательных, социальных или экономических процессов, в том числе признаваемый в качестве результата интеллектуальной деятельности или средства индивидуализации.
2. Транзакция (транзакция с правами и объектами интеллектуальной собственности) (transaction) - описание в цифровой (машиночитаемой) форме (структура транзакций, обязательные атрибуты приведены в разделе Models), содержащееся в блоках транзакций наиболее значимых для всех участников сети (рынка интеллектуальной собственности) видов публичных информационных записей, отражающих ключевые факты в отношении объектов и прав на них, которые принимаются участниками сети в качестве инварианта и не выражаются в последовательности других операций, и отражающих факт:
- создания и (или) депонирования в цифровой форме в одном из репозитариев участников сети нового объекта, в том числе с указанием особенностей его создания - переработкой, объединением (коллекционированием), частичной модификацией (С-транзакция);
- изменения способа и (или) условий доступа к объекту, включая размещение или перемещение в (между) репозитариями, предоставления, включая выдачу национального или иного патента или прекращения правовой охраны изменении владельца исключительных прав, объявлении открытых и (или) безвозмездных лицензий, ограничениях и изъятиях из исключительных прав возникающие в связи с нормами законодательства и (или) решениями органов государственной власти (А-транзакция);
- выполнения действий, создающих дополнительные гарантии при использовании объекта, в первую очередь - различные виды обязательной и добровольной экспертизы (G-транзакция);
- определения стоимости прав на объект в том числе в результате инвентаризаций, рыночной оценки, хозяйственных операций, в том числе страховых и компенсационных выплат при различных способах использования (V-транзакция);
- заявления автором, правообладателем, пользователем или приобретателем, участником смарт контракта или третьей стороной о нарушении прав, а также начале или завершении рассмотрения таких споров в судах или независимыми посредниками (O-транзакция);
- осуществления любых сделок, в том числе в ходе реализации смарт контрактов с правами и (или) объектами интеллектуальной собственности, включая информацию о начале или завершении таких сделок (T-транзакция).
3. транзакция (tx) - структура данных, содержащая неспецифичную, специфичную и системную информацию о транзакции, являющаяся самостоятельной логической единицей, хранящиеся в распределенном реестре, который ведется операторами сети.
4. Неспецифичная информация - минимально необходимая, но достаточная информация, описывающая транзакцию, объем и формат которой установлен организатором сети.
5. Специфичная информация - дополнительная информация, описывающая транзакцию, характерную для конкретного вида объектов и операций с ним и (или) обусловленная особенностями деятельности оператора сети, объем и формат которой определяется оператором сети самостоятельно.
6. Системная информация - информация, сгенерированная реестром в процессе регистрации транзакции, содержащая дату и время регистрации транзакции, информацию о пользователе, выполнившим запрос о регистрации транзакции и т.д.
7. Цепочка (последовательность) блоков транзакций - структура данных, позволяющая выстроить в одну цепочку блоки транзакцй, формируемая таким образом, чтобы не допустить подмены или искажения информации, содержащейся в них, а также даты и времени формирования блоков. Каждый новый блок осуществляет подтверждение транзакций, информацию о которых содержит и дополнительное подтверждение транзакций в предыдущем блоке цепочки.
8. Распределённый реестр транзакций - распределенная между узлами сети база данных, содержащая блоки транзакций, формируемая как непрерывно растущая цепочка блоков с записями обо всех транзакциях. Копия базы и (или) ее фрагментов одновременно хранится на множестве узлов национальной сети и синхронизируется операторами сети согласно установленным организатором сети правилам построения цепочки блоков.
9. Узел сети - программно-аппаратный комплекс, функционирование которого обеспечивает оператор сети, и содержащий программное обеспечение для формирования транзакций и поддержания работоспособности распределенного реестра транзакций и взаимодействующий посредством сети передачи данных с другими аналогичными узлами в соответствии с правилами, установленными организатором сети.
10. Программа для ЭВМ «Информационная система – сеть транзакций с правами и объектами интеллектуальной собственности IPChain» - совокупность программно-аппаратных решений, развёрнутых операторами сети и обеспечивающих функционирование распределенного реестра транзакций и взаимодействие между такими операторами.
11. Участник сети (оператор сети, оператор распределённой базы данных транзакций) физическое или юридическое лицо, имеющее учетную запись в распределенном реестре транзакций и поддерживающий постоянно работающий один или несколько узлов сети, с размещенным программным обеспечением, выполняющим, в том числе функции создания новых блоков транзакций и (или) проверку блоков, сформированных другими узлами сети, согласование закрытия блока с другими узлами сети, передачу изменений между узлами сети и хранение полной истории транзакций.
12. Пользователь сети - лицо, создавшее сервис, обеспечивающий работу и (или) оказание услуг, связанных с объектами интеллектуальной собственности и правами на них и (или) использовавший такие сервисы, а также получающие информацию о транзакциях из сети за счет использования программного обеспечения узлов сети.
13. tx - запись в распределённом реестре, содержащая информацию о транзакции.
3.2 МЕТОДЫ REST-СЕРВИСА (API, GATEWAY)
POST
/{channelID}/transactions
Регистрация транзакции в распределённом реестре транзакций с объектами и правами.
Параметры:
Параметры:
- body (JSON) body (обязательный параметр) – структура данных транзакции в соответствии с моделями данных неспецифичной и специфичной информацией.
{
"type":"C",
"ccID":"C1",
"formatID": "C1",
"data": {
"crCodes": [ 1 ],
"created": "1846-01-01",
"nameIP": "Гори гори моя звезда",
"trOthAttr": {
"tran": [
"Gori gori moya zvezda"
]
},
"typeIP": "Текст песни”
}
}
- channelID (string) path (обязательный параметр) - Идентификатор канала, внутри которого необходимо выполнить chaincode для фиксации транзакции в реестре.
Ответ:
Код 200 – Регистрация транзакции выполнена успешно. Возвращаемые параметры:
body – структура данных, содержащая информацию о зарегистрированной транзакции.
Пример структуры данных, содержащий идентификатор зарегистрированной транзакции и метку времени:
{
"transactionID": "5c0de1e71043670733651a522a5c6f180a8e0935787c4e65b080f90ba59981a7",
"timestamp": "2018-11-01T21:14:57Z"
}Код 400 - Регистрация транзакции не выполнена.
Код 401 – Ошибка авторизации.
Код 401 – Ошибка авторизации.
GET /{channelID}/transactions/{transactionID}
Получение детальной информации о транзакции.
Параметры:
Ответ:
Код 200 – Транзакций найдена. Возвращает идентификатор транзакции, её содержимое, регистратора и метку времени, когда транзакция зарегистрирована. Пример структуры данных:
Параметры:
- transactionID (string) path (обязательный параметр) – идентификатор транзакции, зарегистрированной ранее в реестре.
- channelID (string) path (обязательный параметр) - Идентификатор канала, из которого необходимо запросить подробную информацию о транзакции.
Ответ:
Код 200 – Транзакций найдена. Возвращает идентификатор транзакции, её содержимое, регистратора и метку времени, когда транзакция зарегистрирована. Пример структуры данных:
{
"transactionID": "5c0de1e71043670733651a522a5c6f180a8e0935787c4e65b080f90ba59981a7",
"txContent": {
"type":"C",
"ccID":"C1",
"formatID": "C1",
"data": {
"crCodes": [ 1 ],
"created": "1846-01-01",
"nameIP": "Гори гори моя звезда",
"trOthAttr": {
"tran": [
"Gori gori moya zvezda"
]
},
"typeIP": "Текст песни”
}
},
"createdAt": "2018-11-01T21:14:57Z",
"createdBy": "IPCHAINMSP"
}Код 401 – Ошибка авторизации.
GET /{channelID}/objects/{objectID}/transactions
Получение реестра транзакций по объекту
Параметры:
Ответ:
Код 200 – Объект найден. Возвращает реестр транзакций по объекту. Пример структуры данных:
Параметры:
- objectID (string) path (обязательный параметр) - идентификатор объекта (транзакции С).
- channelID (string) path (обязательный параметр) – идентификатор канала, в котором зарегистрирован объект.
Ответ:
Код 200 – Объект найден. Возвращает реестр транзакций по объекту. Пример структуры данных:
{
"count": 1,
"transactionList": [
{
"transactionID": "5c0de1e71043670733651a522a5c6f180a8e0935787c4e65b080f90ba59981a7",
"type": "C",
"createdAt": "2018-11-01T21:14:57Z",
"createdBy": "IPCHAINMSP"
}
]
} Код 401 – Ошибка авторизации.
Код 404 – Под переданному идентификатору объекта (транзакции C) информация не найдена.
Код 404 – Под переданному идентификатору объекта (транзакции C) информация не найдена.
GET /objects/types
Получение справочника типов объектов.
Без параметров.
Ответ:
Код 200 – Справочник (массив) типов объектов возвращён. Пример структуры данных:
Без параметров.
Ответ:
Код 200 – Справочник (массив) типов объектов возвращён. Пример структуры данных:
[
"произведения науки, литературы и искусства",
"компьютерные программы (программы для ЭВМ)",
"базы данных",
"исполнения",
"фонограммы",
"сообщение в эфир или по кабелю радио- или телепередач (вещание организаций эфирного или кабельного вещания)",
"изобретения",
"полезные модели",
"промышленные образцы",
"селекционные достижения",
"топологии интегральных микросхем",
"секреты производства (ноу-хау)",
"фирменные наименования",
"товарные знаки и знаки обслуживания",
"наименования мест происхождения товаров",
"коммерческие обозначения",
"литературные произведения",
"драматические и музыкально-драматические произведения, сценарные произведения",
"хореографические произведения и пантомимы",
"музыкальные произведения с текстом или без текста",
"аудиовизуальные произведения",
"произведения живописи, скульптуры, графики, дизайна, графические рассказы, комиксы и другие произведения изобразительного искусства",
"произведения декоративно-прикладного и сценографического искусства",
"произведения архитектуры, градостроительства и садово-паркового искусства, в том числе в виде проектов, чертежей, изображений и макетов",
"фотографические произведения и произведения, полученные способами, аналогичными фотографии",
"географические и другие карты, планы, эскизы и пластические произведения, относящиеся к географии и к другим наукам",
"объекты связанные геномными исследованиями",
"трёхмерные цифровые модели",
"произвольный тип объекта"
] Код 401 – Ошибка авторизации.
Код 404 – Под переданному идентификатору объекта (транзакции C) информация не найдена.
Код 404 – Под переданному идентификатору объекта (транзакции C) информация не найдена.
4 МИНИМАЛЬНЫЕ ТЕХНИЧЕСКИЕ ТРЕБОВАНИЯ К АППАРАТНОМУ ОБЕСПЕЧЕНИЮ ДЛЯ РАЗВЁРТЫВАНИЯ УЗЛА И
REST-СЕРВИСА (API, GATEWAY)
4.1 ТРЕБОВАНИЯ К АППАРАТНОМУ ОБЕСПЕЧЕНИЮ УЗЛА
4.2 ТРЕБОВАНИЯ К СИСТЕМНОМУ И БАЗОВОМУ ПРОГРАММНОМУ ОБЕСПЕЧЕНИЮ УЗЛА
Системное программное обеспечение, для установки программы для Сети IPChain:
Сеть IPChain использует и построена на основе базового программного обеспечения Hyper Ledger Fabric (https://www.hyperledger.org/projects/fabric). Программное обеспечение является бесплатным, поставляется с открытым исходным кодом (Open Source), распространяется по лицензии Apache License 2.0.
4.3 ТРЕБОВАНИЯ К КАНАЛАМ СВЯЗИ УЗЛА
Канал связи должен обеспечивать скорость передачи данных не менее 100 Мбит/с до других узлов Сети IPChain.
4.1 ТРЕБОВАНИЯ К АППАРАТНОМУ ОБЕСПЕЧЕНИЮ УЗЛА
- Процессор: 1 CPU 8 ядер, производительностью не хуже оценки 6,9 по тестам, приведенным: https://www.cpubenchmark.net/high_end_cpus.html
- Оперативная память: не менее 32 Гб.
- Дисковая подсистема (примерно на 340 млн. транзакций с правами и объектами интеллектуальной собственности всех типов): объём не менее 3.84 ТБ SSD, RAID 1, скорость записи не менее 930Мб/с, скорость чтения не менее 1400Мб/с, внешняя скорость передачи данных не менее 1200Мб/с.
4.2 ТРЕБОВАНИЯ К СИСТЕМНОМУ И БАЗОВОМУ ПРОГРАММНОМУ ОБЕСПЕЧЕНИЮ УЗЛА
Системное программное обеспечение, для установки программы для Сети IPChain:
- Операционная система Linux, к примеру Ubuntu LTS 18.04.
- Система докеризации (развёртывания) Docker 18.03.
Сеть IPChain использует и построена на основе базового программного обеспечения Hyper Ledger Fabric (https://www.hyperledger.org/projects/fabric). Программное обеспечение является бесплатным, поставляется с открытым исходным кодом (Open Source), распространяется по лицензии Apache License 2.0.
4.3 ТРЕБОВАНИЯ К КАНАЛАМ СВЯЗИ УЗЛА
Канал связи должен обеспечивать скорость передачи данных не менее 100 Мбит/с до других узлов Сети IPChain.
5 УСТАНОВКА ПРОГРАММНОГО ОБЕСПЕЧЕНИЯ СЕТИ IPCHAIN
1
От ассоциации получаем данные для подключения к репозитариям содержащим данные для установки – образы docker-контейнеров и исходные коды chaincode-ов HyperLedger Fabric (контакт: admin@ipchain.ru):
2
Заходим repo.ipchain.ru с использованием <user_name> и <password>, прописываем публичный ssh ключ в свою учётную запись пользователя.
3
Получаем дистрибутив программного обеспечения развёртывания тестовой Сети IPChain, исходный код чейнкодов (chaincode) последней версии и docker-образ API-сервиса (gateway).
1
От ассоциации получаем данные для подключения к репозитариям содержащим данные для установки – образы docker-контейнеров и исходные коды chaincode-ов HyperLedger Fabric (контакт: admin@ipchain.ru):
- repo.ipchain.ru: <user_name> и <tmp_password>
- registry.ipchain.ru: <deploy_user> и <deploy_token>
2
Заходим repo.ipchain.ru с использованием <user_name> и <password>, прописываем публичный ssh ключ в свою учётную запись пользователя.
3
Получаем дистрибутив программного обеспечения развёртывания тестовой Сети IPChain, исходный код чейнкодов (chaincode) последней версии и docker-образ API-сервиса (gateway).
mkdir -p /opt/ipchain
cd /opt/ipchain/
git clone --branch master --depth 1 git@repo.ipchain.ru:ipchain/testnet.git ./testnet
git clone --branch master --depth 1 git@repo.ipchain.ru:ipchain/chaincode.git ./chaincode
source ./testnet/scripts/env-vars.sh
cd chaincode/
git checkout tags/${CHAINCODE_VERSION}
cd ../testnet/4
Устанавливаем docker и docker-compose (если не установлены)
Устанавливаем docker и docker-compose (если не установлены)
source prepare_node.sh5
Компилируем и запускаем контейнеры с программным обеспечением тестовой сети распределённого реестра
Компилируем и запускаем контейнеры с программным обеспечением тестовой сети распределённого реестра
/start.sh5.1 УСТАНОВКА ПРОГРАММНОГО ОБЕСПЕЧЕНИЯ СЕРВИСА API-СЕРВИСА (GATEWAY) ДЛЯ ПОДКЛЮЧЕНИЯ ВНЕШНИХ
ИНФОРМАЦИОННЫХ СИСТЕМ К СЕТИ IPCHAIN
6
Прописываем параметры (переменные окружения операционной системы) для получения образа контейнера API-сервиса (gateway)
6
Прописываем параметры (переменные окружения операционной системы) для получения образа контейнера API-сервиса (gateway)
DEPLOY_USER=<deploy_user>
DEPLOY_TOKEN=<deploy_token>
docker login -u $DEPLOY_USER -p $DEPLOY_TOKEN registry.ipchain.ru7
Запускаем API-сервис (gateway)
Запускаем API-сервис (gateway)
cd /opt/ipchain/testnet
docker-compose -f docker-compose-gateway.yml up -d8
Генерируем JWT (JSON Web Token) для подключения к API-сервису с правами на запись для gateway первой организации (Org1)
Генерируем JWT (JSON Web Token) для подключения к API-сервису с правами на запись для gateway первой организации (Org1)
docker exec gateway /app/gateway --generateToken --tokenRole writerДля генерации JWT для подключения с правами на чтение заменяем --tokenRole writer на
--tokenRole reader.
9
Получаем доступ к API-сервису: http://localhost:3000
10
Описание методов API и структур данных получаем в разделе для разработчиков: https://developer.ipchain.ru.
5.2 СБРОС СИТЕМЫ В НАЧАЛЬНОЕ СОСТОЯНИЕ
11
При необходимости, произвести полный сброс можно с помощью команды cleanup.sh. В процессе выполнения будут удалены все контейнеры и данные, находящиеся в них.
9
Получаем доступ к API-сервису: http://localhost:3000
10
Описание методов API и структур данных получаем в разделе для разработчиков: https://developer.ipchain.ru.
5.2 СБРОС СИТЕМЫ В НАЧАЛЬНОЕ СОСТОЯНИЕ
11
При необходимости, произвести полный сброс можно с помощью команды cleanup.sh. В процессе выполнения будут удалены все контейнеры и данные, находящиеся в них.
./cleanup.shОбъединённая последовательность перечисленных выше команд в виде скрипта:
#Перед выполнением необходимо прописать ssh ключ для доступа к repo.ipchain.ru (п.2 в инструкции «Последовательность развёртывания сети состоящей из узлов двух организаций и узла координатора сети»)
#IPChain network (HyperLedger Fabric)
mkdir -p /opt/ipchain
cd /opt/ipchain/
git clone --branch master --depth 1 git@repo.ipchain.ru:ipchain/testnet.git ./testnet
git clone --branch master --depth 1 git@repo.ipchain.ru:ipchain/chaincode.git ./chaincode
source ./testnet/scripts/env-vars.sh
cd chaincode/
git checkout tags/${CHAINCODE_VERSION}
cd ../testnet/
source prepare_node.sh
./start.sh
#IPCHain gateway
DEPLOY_USER=<deploy_user>
DEPLOY_TOKEN=<deploy_token>
docker login -u $DEPLOY_USER -p $DEPLOY_TOKEN registry.ipchain.ru
cd /opt/ipchain/testnet
docker-compose -f docker-compose-gateway.yml up
docker exec gateway /app/gateway --generateToken --tokenRole writer
#развернута тестовая сеть из 2х организаций (ORG1 и ORG2) и координатора сети (IPCHAIN), и API-сервис (gateway), доступный по адресу http://localhost:3000
#описание методов API и структур данных доступно в разделе для разработчиков: https://developer.ipchain.ru6 ПЕРСОНАЛ, ОБЕСПЕЧИВАЮЩИЙ ТЕХНИЧЕСКУЮ ПОДДЕРЖКУ И МОДЕРНИЗАЦИЮ
Специалисты, обеспечивающие техническую поддержку и модернизацию Системы, должны обладать следующими знаниями и навыками:
Для обеспечения технической поддержи и модернизации системы достаточно одного штатного специалиста.
Специалисты, обеспечивающие техническую поддержку и модернизацию Системы, должны обладать следующими знаниями и навыками:
- владение навыками администрирования кластеризованных-серверных платформ на уровне высококвалифицированного администратора;
- знание функциональных возможностей работы Hyper Ledger Fabric, особенностей работы кластера Apache Kaffka;
Для обеспечения технической поддержи и модернизации системы достаточно одного штатного специалиста.
7 ДОКУМЕНТАЦИЯ
Документация, содержащая описание функциональных характеристик и информация, необходимая для установки и эксплуатации
Документация, содержащая описание процессов, обеспечивающих поддержание жизненного цикла программного обеспечения, в том числе устранение неисправностей, выявленных в ходе эксплуатации программного обеспечения, совершенствование программного обеспечения, а также информация о персонале, необходимом для обеспечения такой поддержки.
Инструкция по установке программы для ЭВМ «Информационная система – сеть транзакций с правами и объектами интеллектуальной собственности IPChain»
Документация, содержащая описание функциональных характеристик и информация, необходимая для установки и эксплуатации
Документация, содержащая описание процессов, обеспечивающих поддержание жизненного цикла программного обеспечения, в том числе устранение неисправностей, выявленных в ходе эксплуатации программного обеспечения, совершенствование программного обеспечения, а также информация о персонале, необходимом для обеспечения такой поддержки.
Инструкция по установке программы для ЭВМ «Информационная система – сеть транзакций с правами и объектами интеллектуальной собственности IPChain»
© 2017—2019 IPCHAIN Association. Все права защищены.
Контакты
Контакты
- via@ipchain.ru
- +7(495) 710-99-48
- Техподдержка
- ipchain.ru