diff --git a/404.html b/404.html index 85ef208b..3af3da10 100644 --- a/404.html +++ b/404.html @@ -20,11 +20,11 @@ - +
ar.io Docs

404s suck! And we're sorry for this one.

Good thing the permaweb has no more 404s

- + diff --git a/arns/index.html b/arns/index.html index 7b92e72d..9aef5db2 100644 --- a/arns/index.html +++ b/arns/index.html @@ -20,11 +20,11 @@ - +
ar.io Docs

# Arweave Name System (ArNS)

# Overview

Arweave URLs and Transaction IDs are long, difficult to remember, and occasionally miscategorized as spam. The Arweave Name System (ArNS) aims to resolve these problems in a decentralized manner. ArNS is a censorship-resistant naming system stored on Arweave, purchased with IO tokens, enabled through AR.IO gateway domains, and used to connect friendly domain names to permaweb dApps, web pages, data, and identities.

It's like an open, permissionless address book for anything on the permaweb, powered by the aoComputer.

This system works similarly to traditional DNS services, where users can purchase a name in a registry and DNS Name servers resolve these names to IP addresses. The system shall be flexible and allow users to purchase names permanently or lease them for a defined period based on their use case. With ArNS, the registry is decentralized, permanent, and stored on Arweave (through the aoComputer). This means that apps and infrastructure cannot just read the latest state of the registry but can also check any point in time in the past, creating a “Wayback Machine” of permanent data.

Users can register a name, like ardrive, within the ArNS Registry. Before owning a name, they must create an Arweave Name Token (ANT), an aoCOmputer process and open-source protocol used by ArNS to track the ownership and control over the name. ANTs allow the owner to set a pointer to any type of permaweb data, like a page, dApp or file, via its Arweave Transaction ID.

Each AR.IO gateway acts as both a smart contract cache and an ArNS Name resolver. They will generate the latest state of both the ArNS Registry and its related ANTs and serve this information rapidly for apps and users. AR.IO gateways will also resolve that name as one of their own subdomains, e.g., https://ardrive.arweave.net and proxy all requests to the associated Arweave Transaction ID. This means that ANTs work across all AR.IO gateways that support them: https://ardrive.ar-io.dev, https://ardrive.g8way.io/, etc.

Users can easily reference these friendly names in their browsers, and other applications and infrastructure can build rich solutions on top of these ArNS primitives.

Arweave Name System Interactions

# Name Registry

The ArNS Registry is a list of all the registered names and their associated ANT AO process Ids. Registering a name requires spending IO tokens based upon the name length and purchase type. The system shall allow users to either lease a name on a yearly basis (maximum up to 5 years) or purchase that name permanently.

The registry uses the following key rules, embedded within the AR.IO AO process:

  • The genesis prices of names are set within the contract itself; these are the starting conditions.
  • Name prices vary based on name length, purchase type (lease vs buy), lease duration, and the current Demand Factor. See the Dynamic Pricing section for more details.
  • Name records in the registry each include a pointer to its Arweave Name Token Smart Contract process address, its lease end time, and undername allocation.
  • Anyone with available IO Tokens can extend any name’s active lease.
  • Anyone with available IO Tokens can purchase undername space for any name.
  • When a lease expires, there is a grace period where it can still be extended before anyone else can repurchase the name with a new ANT.

Once added, name records cannot be removed from the registry. A leased name’s associated ANT smart contract address cannot be changed until the lease has expired and a new one is purchased. Care must be taken by the owners of permanent name purchases to ensure that their ANT supports an evolve ability should it be desired to add or modify functionality in the future as these name purchases are permanently tied to the associated ANT. Owners of permanently purchased names must understand the consequences of private key loss, which results in not being able to update any data pointers for this name.

# Name Validation Rules

All names registered shall meet the following criteria:

  1. Valid names include only numbers 0-9, characters a-z and dashes.
  2. Dashes cannot be leading or trailing characters.
  3. Dashes cannot be used in single character domains.
  4. 1 character minimum, 51 characters maximum.
  5. Shall not be an invalid name predesignated to prevent unintentional use/abuse such as www.

# Arweave Name Token (ANT)

To establish ownership of a record in the ArNS Registry, each record contains both a friendly name and a reference to an Arweave Name Token, ANT. Name Tokens are unique aoComputer process tokens that give their owners the ability to update the Arweave Transaction IDs that their associated friendly names point to.

The ANT process is a standardized contract that contains the specific ArNS Record specification required by AR.IO gateways who resolve ArNS names and their Arweave Transaction IDs. It also contains other basic functionality to establish ownership and the ability to transfer ownership and update the Arweave Transaction ID.

Name Tokens have an owner, who can transfer the token and control all of its modifiable settings. These settings include modifying the time to live (ttl) for each name contained in the ANT, and other settings like the ANT Name, Ticker, and an ANT Controller. The controller can only manage the ANT and set and update records, name, and the ticker, but cannot transfer the ANT. Note that ANTs are initially created by an end user, in accordance with network standards, who then has to ability to transfer its ownership or assign a controller as they see fit.

Secondary markets could be created by ecosystem partners that facilitate the trade of Name Tokens. Additionally, tertiary markets could be created that support the leasing of these friendly names to other users. Such markets, if any, would be created by third parties unrelated to and outside of the scope of this paper or control of the Foundation.

The table below indicates some of the possible interactions with an ANT and who can perform them:

ANT Interactions
Type ANT Owner ANT Controller Any IO Token Holder
Transfer ANT ✔
Add / remove controllers ✔
Set records (pointers) ✔ ✔
Update records, name, ticker ✔ ✔
Extend / renew lease ✔ ✔ ✔
Increase undernames ✔ ✔ ✔
ANT Interactions

# Under_Names

ANT owners and controllers can configure multiple subdomains for their registered ArNS name known as “under_names” or more easily written “undernames”. These undernames are assigned individually at the time of registration or can be added on to any registered name at any time.

Undernames use an underscore “_” in place of a more typically used dot “.“ to separate the subdomain from the main ArNS domain.

This means users can trust dapp_ardrive just like you would trust ardrive since the owner of ardrive is the only one who can configure dapp_ardrive.

Some other features that undernames allow include:

  • Undernames are configured in the ANT that is referenced for a given name. ANT owners can add more undernames as subDomains in the ANT’s records object, each of which can point to a different Arweave Transaction ID.
  • Each registered name is provided with an allocation of 10 undernames by default. Additional undername space can be purchased individually and as needed.
  • Other users could never register a name that resembles an undername on ardrive since “_” is not allowed to be registered in the ArNS registry.
  • Another user can register dapp-ardrive but this is a separate ArNS domain altogether. In traditional DNS, it’s like the difference in trusting dapp-ardrive.io(suspicious!) over the legitimate dapp.ardrive.io
  • Undernames can go multiple levels deep, like version_dapp_ardrive but must not be longer than the total MAX_NAME_LENGTH of an ArNS name. The total amount of characters for a name string consisting of undernames and underscore separators is 63 characters.

Undernames give more versatility and utility to owning an ArNS name.

# Addressing Variable Market Conditions

The future market landscape is unpredictable, and the AR.IO Network smart contract is designed to be immutable, operating without governance or mechanisms for manual intervention. In addition, the traditional method of employing a pricing oracle to fix prices relative to a stable currency is not viable due to the infancy of the network as well as the inherent reliance on outside dependencies. Considering this, ArNS is designed to be self-contained and adaptive, ensuring that name prices always mirror network activity and market conditions.

To achieve this, ArNS incorporates a dynamic pricing model that utilizes a “Demand Factor” to adjust fees in line with ArNS purchase activity.

ArNS is designed to ensure that name valuations are always in sync with their true market worth, despite the unchangeable nature of the smart contract it operates on.

# Dynamic Pricing Model

The Arweave Name System (ArNS) introduces an adaptive pricing model for registering names within the AR.IO Network. The core objective is to strike a balance between market demand and pricing fairness, leveraging both static and dynamic pricing elements. The system differentiates prices based on character lengths of names and offers varied purchasing options such as leasing, permanent acquisition, and undernames.

A unique feature of the ArNS pricing mechanism is the integration of a Demand Factor (DF), a dynamic multiplier that adjusts name prices in response to market demand. The DF is determined by comparing the total revenue in IO tokens from the current period to a moving average of revenues from the preceding period window. Depending on whether revenue is above, below, or equal to this average, the DF can increase or decrease. These adjustments are contained within boundaries to prevent extreme pricing variations.

This comprehensive approach ensures that ArNS names are accessible and reasonably priced, adapting to market trends while maintaining an equitable and maintenance-free registration environment.

# Pricing Scenarios

There are several pricing models for leasing and purchasing names:

  • Leased Name: Allows a user to lease a name for a certain duration and have it available for use immediately by the lessee.

  • Permanent Name: Allows a user to purchase a name permanently and have it available for use immediately by the owner.

# Dynamic Pricing Mechanics

Names are initially priced according to the Genesis Registration Fee (GRF), as set in the AR.IO smart contract, with prices varying based on the length of the name. As the network's activity progresses, these fees give way to Base Registration Fees (BRF), which are modified by periodic step adjustments. The Demand Factor (DF) is a crucial component that dynamically scales prices, fluctuating with the network’s revenue trends.

Revenue in the network accumulates within the Protocol Balance through various streams, such as instant name leases or purchases, lease extensions, and under_name transactions. This cumulative revenue impacts the Demand Factor, which in turn influences the current name prices.

The DF is adjusted by comparing the recent period’s revenue against a Revenue Moving Average (RMA) from the preceding seven periods. Based on this comparison, the DF can either increase, to reflect greater demand, or decrease, in response to diminished revenue, all within predetermined limits to prevent drastic fluctuations in pricing

The pricing system articulates various fees:

  • The Adjusted Registration Fee (ARF) is the BRF modified by the DF.

  • The Annual Fee is set as a proportion of the ARF.

  • Instant Lease Registration and Permabuy prices are derived from the ARF, adding the calculated annual fees over the desired years.

The DF’s modifications are controlled by the network's recent performance against the RMA. An increase in revenue leads to a DF rise, signifying a thriving market demand, while a decrease indicates the opposite. This responsive adjustment mechanism ensures that the pricing model remains aligned with actual market activity.

Under_names are bundled with name registrations with additional ones available for purchase. The cost for extra under_names is a percentage of the current BRF, altered by the DF.

# Step Pricing Mechanics

The dynamic model shall utilize a “Step Pricing” concept that acts as a stabilizing mechanism to counteract swift and dramatic market shifts, ensuring registration costs remain aligned and predictable. Step pricing adjusts the Base Registration Fees when the Demand Factor reaches its minimum value for an extended period, updating the BRF to align with the current ARF, and resetting the DF to a neutral value. This allows for base prices to lower in extended droughts of low demand or high token value resulting in lower revenue generated to the protocol balance.

The below chart represents Step Pricing in action:

Step Pricing Action - Declining Demand
- + diff --git a/arweave/index.html b/arweave/index.html index ee2f29d7..9f85c55c 100644 --- a/arweave/index.html +++ b/arweave/index.html @@ -20,11 +20,11 @@ - +
ar.io Docs

# Arweave

# The Permanence Pie

The permanent data storage ecosystem can be thought of as a three-tiered arrangement of protocols, services, and applications – dubbed here as “The Permanence Pie”.

Diagram 1: The Shell of Permanence Pie

The base layer of that pie is the Arweave protocol and network, which is the backbone of the permanent data storage ecosystem. It provides the infrastructure for data to be stored on the network in a decentralized manner and incentivizes nodes to keep the data stored for long periods of time.

The second layer is made up of services that sit on top of the Arweave protocol and network. These services include gateways, data retrieval services, and computation that help to provide a seamless and functional experience for users, creators, and developers.

Finally, the top layer of the pie consists of applications that utilize the data stored on the Arweave network. This includes everything from simple applications that allow users to access and view their data to complex, decentralized applications that use the Arweave network as their backbone.

Each layer of the Permanence Pie is crucial to the overall success and growth of the permanent data storage ecosystem. The Arweave protocol and network provide the foundation for data storage, the services layer helps to facilitate data retrieval and usage, and the application layer brings the benefits of the ecosystem to users and developers alike.

# What Is Arweave

Arweave is a decentralized Layer 1 data storage protocol optimized for long-term permanent storage through its unique proof of access mechanism and tokenomic endowment model. It can be thought of as a global, permissionless hard drive.

The information stored on Arweave is immutable and globally replicated by miner nodes. Instead of a traditional blockchain ledger which links blocks of transactions together in linear sequence, Arweave arranges blocks in a web known as the blockweave. These miner nodes secure the blockweave by operating the Succinct Proof of Random Access (SPoRA) algorithm. SPoRA requires miners to prove that they have access to recall randomly selected bits of weave data in order to produce and share a block. If successful, miners are rewarded in Arweave’s native AR token. These token rewards are derived from transaction fees as well as the network’s storage endowment. The endowment is a protocol-controlled pool of tokens designed to fund the projected cost of storage for 200+ years.

Diagram 2: Arweave - The Base Storage Layer

Arweave is file type agnostic – any type of file ranging from simple text files to family photos to complex web applications and archival databases can be stored on the network. To upload data, users must pay an amount of AR proportional to the size of the files being uploaded. Arweave is unique when compared with other decentralized storage solutions in that users only pay once to upload their files, then that is it – the files will be stored in perpetuity without any additional upkeep or subscription fees paid by the user.

The Arweave protocol is designed to handle 1,000 base layer transactions per block with new blocks being mined roughly every two minutes. Each transaction may also store an unbounded number of signed, non-AR-transacting data items assembled into a bundle (i.e., a bundled data item). Since its launch in 2018, this scalable architecture has allowed the network's weave size (total data stored on the network) to grow to 140.8 TB with approximately 1.5 billion base layer transactions and bundled data items submitted from over 181k unique wallets. The Arweave protocol endowment has received 60.7k AR to cover the projected storage costs with a cost of storage 0.858 AR/GiB. *

* data as of November 20, 2023

# Gateways

Gateways act as the front door to the permaweb. They are infrastructure utilities that sit above the base storage layer and allow users to write, access, and query the information stored on Arweave. Gateways are specialized nodes responsible for data ingest (data "in") and data egress (data "out").

For access / egress, gateways allow for data retrieval, caching, and serving as well as indexing transactions into a database that can be easily queried at scale. With bundling functionality, gateways can act as services allowing users to write and seed new data the Arweave network.

These "in and out" functions are not performed by the Arweave mining nodes which are optimized for securing the Layer 1 blockweave and replicating information throughout the network through a mechanism known as Wildfire.

Diagram 3: Gateways - The Ingest and Access Component

By taking on these responsibilities, gateways allow low cost and maintenance free hosting of static and dynamic content for users, creators, and developers. But there are costs associated with operating a gateway and Arweave does not offer any tokenomic incentives to offset these expenses. As the permaweb grows, these costs can become very significant.

Arweave.net, the primary community gateway, has scaled to meet the needs of the entire Arweave ecosystem and stored the entire weave. Over the last 6 months, this gateway indexed and cached approximately 3.4 million base layer transactions and bundled data items per day, served 233 million requests for data and node information per day, and responded to 3.2 million GQL queries per day. *

Gateway use cases, and the types of administrators who operate them, can range from at-home projects hosted by hobbyists to larger decentralized platforms and dApps run by small teams, all the way up to scaled out environments capable of supporting enterprise offerings.

* data as of November 20, 2023

# aoComputer

AO is a global supercomputer built on Arweave. This actor-oriented machine is a single, unified computing environment, hosted on a heterogenous set of nodes in a distributed network. AO is designed to offer an environment in which an arbitrary number of parallel processes can be resident, coordinating through an open message passing layer. This message passing standard connects the machine's independently operating processes together into a 'web' -- in the same way that websites operate on independent servers but are conjoined into a cohesive, unified experience via hyperlinks.

Diagram 4: AO - The Supercomputer and Smart Contract Protocol

With AO, developers can create processes that act as smart contracts with token-like properties which can then be used to incorporate incentive structures into applications and infrastructure. The AR.IO Network leverages this technology for development of its network protocol and IO token.

# The Permaweb

The permaweb is the third and final layer of the permanence pie. The permaweb stands for the permanent web, a collection of all the webpages, apps, and files stored on top of the Arweave network and enlivened with the functionality of the AR.IO Network. For users and builders, the permaweb offers low-cost, zero maintenance, permanent hosting of their web apps, files, and web pages.

Diagram 5: The Permanence Pie

AR.IO is a global network, protocol, and currency built on top of Arweave that enables the permaweb.

# References and Further Reading

The following resources were used as reference material for this section and can provide the interested reader with additional information:

- + diff --git a/assets/js/28.94157a74.js b/assets/js/28.5034219a.js similarity index 99% rename from assets/js/28.94157a74.js rename to assets/js/28.5034219a.js index 57c5aa47..f7030c08 100644 --- a/assets/js/28.94157a74.js +++ b/assets/js/28.5034219a.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[28],{329:function(e,a,t){"use strict";t.r(a);var r=t(10),s=Object(r.a)({},(function(){var e=this,a=e._self._c;return a("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[a("h1",{attrs:{id:"arweave"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#arweave"}},[e._v("#")]),e._v(" Arweave")]),e._v(" "),a("h2",{attrs:{id:"the-permanence-pie"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#the-permanence-pie"}},[e._v("#")]),e._v(" The Permanence Pie")]),e._v(" "),a("p",[e._v("The permanent data storage ecosystem can be thought of as a three-tiered arrangement of protocols, services, and applications – dubbed here as “The Permanence Pie”.")]),e._v(" "),a("img",{staticClass:"amazingdiagram",attrs:{src:e.$withBase("/images/permanence-pie-1.png")}}),e._v(" "),a("div",{staticClass:"caption"},[e._v("Diagram 1: The Shell of Permanence Pie")]),e._v(" "),a("p",[e._v("The base layer of that pie is the Arweave protocol and network, which is the backbone of the permanent data storage ecosystem. It provides the infrastructure for data to be stored on the network in a decentralized manner and incentivizes nodes to keep the data stored for long periods of time.")]),e._v(" "),a("p",[e._v("The second layer is made up of services that sit on top of the Arweave protocol and network. These services include gateways, data retrieval services, and computation that help to provide a seamless and functional experience for users, creators, and developers.")]),e._v(" "),a("p",[e._v("Finally, the top layer of the pie consists of applications that utilize the data stored on the Arweave network. This includes everything from simple applications that allow users to access and view their data to complex, decentralized applications that use the Arweave network as their backbone.")]),e._v(" "),a("p",[e._v("Each layer of the Permanence Pie is crucial to the overall success and growth of the permanent data storage ecosystem. The Arweave protocol and network provide the foundation for data storage, the services layer helps to facilitate data retrieval and usage, and the application layer brings the benefits of the ecosystem to users and developers alike.")]),e._v(" "),a("h2",{attrs:{id:"what-is-arweave"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#what-is-arweave"}},[e._v("#")]),e._v(" What Is Arweave")]),e._v(" "),a("p",[e._v("Arweave is a decentralized Layer 1 data storage protocol optimized for long-term permanent storage through its unique proof of access mechanism and tokenomic endowment model. It can be thought of as a global, permissionless hard drive.")]),e._v(" "),a("p",[e._v("The information stored on Arweave is immutable and globally replicated by miner nodes. Instead of a traditional blockchain ledger which links blocks of transactions together in linear sequence, Arweave arranges blocks in a web known as the blockweave. These miner nodes secure the blockweave by operating the Succinct Proof of Random Access (SPoRA) algorithm. SPoRA requires miners to prove that they have access to recall randomly selected bits of weave data in order to produce and share a block. If successful, miners are rewarded in Arweave’s native AR token. These token rewards are derived from transaction fees as well as the network’s storage endowment. The endowment is a protocol-controlled pool of tokens designed to fund the projected cost of storage for 200+ years.")]),e._v(" "),a("img",{staticClass:"amazingdiagram",attrs:{src:e.$withBase("/images/permanence-pie-2.png")}}),e._v(" "),a("div",{staticClass:"caption"},[e._v("Diagram 2: Arweave - The Base Storage Layer")]),e._v(" "),a("p",[e._v("Arweave is file type agnostic – any type of file ranging from simple text files to family photos to complex web applications and archival databases can be stored on the network. To upload data, users must pay an amount of AR proportional to the size of the files being uploaded. Arweave is unique when compared with other decentralized storage solutions in that users only pay once to upload their files, then that is it – the files will be stored in perpetuity without any additional upkeep or subscription fees paid by the user.")]),e._v(" "),a("p",[e._v("The Arweave protocol is designed to handle 1,000 base layer transactions per block with new blocks being mined roughly every two minutes. Each transaction may also store an unbounded number of signed, non-AR-transacting data items assembled into a bundle (i.e., a bundled data item). Since its launch in 2018, this scalable architecture has allowed the network's weave size (total data stored on the network) to grow to 140.8 TB with approximately 1.5 billion base layer transactions and bundled data items submitted from over 181k unique wallets. The Arweave protocol endowment has received 60.7k AR to cover the projected storage costs with a cost of storage 0.858 AR/GiB. *")]),e._v(" "),a("p",[e._v("* data as of November 20, 2023")]),e._v(" "),a("h2",{attrs:{id:"gateways"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#gateways"}},[e._v("#")]),e._v(" Gateways")]),e._v(" "),a("p",[e._v('Gateways act as the front door to the permaweb. They are infrastructure utilities that sit above the base storage layer and allow users to write, access, and query the information stored on Arweave. Gateways are specialized nodes responsible for data ingest (data "in") and data egress (data "out").')]),e._v(" "),a("p",[e._v("For access / egress, gateways allow for data retrieval, caching, and serving as well as indexing transactions into a database that can be easily queried at scale. With bundling functionality, gateways can act as services allowing users to write and seed new data the Arweave network.")]),e._v(" "),a("p",[e._v('These "in and out" functions are not performed by the Arweave mining nodes which are optimized for securing the Layer 1 blockweave and replicating information throughout the network through a mechanism known as Wildfire.')]),e._v(" "),a("img",{staticClass:"amazingdiagram",attrs:{src:e.$withBase("/images/permanence-pie-3.png")}}),e._v(" "),a("div",{staticClass:"caption"},[e._v("Diagram 3: Gateways - The Ingest and Access Component")]),e._v(" "),a("p",[e._v("By taking on these responsibilities, gateways allow low cost and maintenance free hosting of static and dynamic content for users, creators, and developers. But there are costs associated with operating a gateway and Arweave does not offer any tokenomic incentives to offset these expenses. As the permaweb grows, these costs can become very significant.")]),e._v(" "),a("p",[e._v("Arweave.net, the primary community gateway, has scaled to meet the needs of the entire Arweave ecosystem and stored the entire weave. Over the last 6 months, this gateway indexed and cached approximately 3.4 million base layer transactions and bundled data items per day, served 233 million requests for data and node information per day, and responded to 3.2 million GQL queries per day. *")]),e._v(" "),a("p",[e._v("Gateway use cases, and the types of administrators who operate them, can range from at-home projects hosted by hobbyists to larger decentralized platforms and dApps run by small teams, all the way up to scaled out environments capable of supporting enterprise offerings.")]),e._v(" "),a("p",[e._v("* data as of November 20, 2023")]),e._v(" "),a("h2",{attrs:{id:"aocomputer"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#aocomputer"}},[e._v("#")]),e._v(" aoComputer")]),e._v(" "),a("p",[e._v("AO is a global supercomputer built on Arweave. This actor-oriented machine is a single, unified computing environment, hosted on a heterogenous set of nodes in a distributed network. AO is designed to offer an environment in which an arbitrary number of parallel processes can be resident, coordinating through an open message passing layer. This message passing standard connects the machine's independently operating processes together into a 'web' -- in the same way that websites operate on independent servers but are conjoined into a cohesive, unified experience via hyperlinks.")]),e._v(" "),a("img",{staticClass:"amazingdiagram",attrs:{src:e.$withBase("/images/aoPie/permanence-pie-4b.png")}}),e._v(" "),a("div",{staticClass:"caption"},[e._v("Diagram 4: AO - The Supercomputer and Smart Contract Protocol")]),e._v(" "),a("p",[e._v("With AO, developers can create processes that act as smart contracts with token-like properties which can then be used to incorporate incentive structures into applications and infrastructure. The AR.IO Network leverages this technology for development of its network protocol and IO token.")]),e._v(" "),a("h2",{attrs:{id:"the-permaweb"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#the-permaweb"}},[e._v("#")]),e._v(" The Permaweb")]),e._v(" "),a("p",[e._v("The permaweb is the third and final layer of the permanence pie. The permaweb stands for the permanent web, a collection of all the webpages, apps, and files stored on top of the Arweave network and enlivened with the functionality of the AR.IO Network. For users and builders, the permaweb offers low-cost, zero maintenance, permanent hosting of their web apps, files, and web pages.")]),e._v(" "),a("img",{staticClass:"amazingdiagram",attrs:{src:e.$withBase("/images/aoPie/permanence-pie-5b.png")}}),e._v(" "),a("div",{staticClass:"caption"},[e._v("Diagram 5: The Permanence Pie")]),e._v(" "),a("p",[e._v("AR.IO is a global network, protocol, and currency built on top of Arweave that enables the permaweb.")]),e._v(" "),a("h2",{attrs:{id:"references-and-further-reading"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#references-and-further-reading"}},[e._v("#")]),e._v(" References and Further Reading")]),e._v(" "),a("p",[e._v("The following resources were used as reference material for this section and can provide the interested reader with additional information:")]),e._v(" "),a("ul",[a("li",[a("p",[a("a",{attrs:{href:"https://arwiki.wiki/",target:"_blank",rel:"noopener noreferrer"}},[e._v("The ArWiki"),a("OutboundLink")],1)])]),e._v(" "),a("li",[a("p",[a("a",{attrs:{href:"https://github.com/ArweaveTeam",target:"_blank",rel:"noopener noreferrer"}},[e._v("Arweave GitHub repository"),a("OutboundLink")],1)])]),e._v(" "),a("li",[a("p",[a("a",{attrs:{href:"https://cookbook_ao.g8way.io/concepts/index.html",target:"_blank",rel:"noopener noreferrer"}},[e._v("aoComputer"),a("OutboundLink")],1)])])])])}),[],!1,null,null,null);a.default=s.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[28],{330:function(e,a,t){"use strict";t.r(a);var r=t(10),s=Object(r.a)({},(function(){var e=this,a=e._self._c;return a("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[a("h1",{attrs:{id:"arweave"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#arweave"}},[e._v("#")]),e._v(" Arweave")]),e._v(" "),a("h2",{attrs:{id:"the-permanence-pie"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#the-permanence-pie"}},[e._v("#")]),e._v(" The Permanence Pie")]),e._v(" "),a("p",[e._v("The permanent data storage ecosystem can be thought of as a three-tiered arrangement of protocols, services, and applications – dubbed here as “The Permanence Pie”.")]),e._v(" "),a("img",{staticClass:"amazingdiagram",attrs:{src:e.$withBase("/images/permanence-pie-1.png")}}),e._v(" "),a("div",{staticClass:"caption"},[e._v("Diagram 1: The Shell of Permanence Pie")]),e._v(" "),a("p",[e._v("The base layer of that pie is the Arweave protocol and network, which is the backbone of the permanent data storage ecosystem. It provides the infrastructure for data to be stored on the network in a decentralized manner and incentivizes nodes to keep the data stored for long periods of time.")]),e._v(" "),a("p",[e._v("The second layer is made up of services that sit on top of the Arweave protocol and network. These services include gateways, data retrieval services, and computation that help to provide a seamless and functional experience for users, creators, and developers.")]),e._v(" "),a("p",[e._v("Finally, the top layer of the pie consists of applications that utilize the data stored on the Arweave network. This includes everything from simple applications that allow users to access and view their data to complex, decentralized applications that use the Arweave network as their backbone.")]),e._v(" "),a("p",[e._v("Each layer of the Permanence Pie is crucial to the overall success and growth of the permanent data storage ecosystem. The Arweave protocol and network provide the foundation for data storage, the services layer helps to facilitate data retrieval and usage, and the application layer brings the benefits of the ecosystem to users and developers alike.")]),e._v(" "),a("h2",{attrs:{id:"what-is-arweave"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#what-is-arweave"}},[e._v("#")]),e._v(" What Is Arweave")]),e._v(" "),a("p",[e._v("Arweave is a decentralized Layer 1 data storage protocol optimized for long-term permanent storage through its unique proof of access mechanism and tokenomic endowment model. It can be thought of as a global, permissionless hard drive.")]),e._v(" "),a("p",[e._v("The information stored on Arweave is immutable and globally replicated by miner nodes. Instead of a traditional blockchain ledger which links blocks of transactions together in linear sequence, Arweave arranges blocks in a web known as the blockweave. These miner nodes secure the blockweave by operating the Succinct Proof of Random Access (SPoRA) algorithm. SPoRA requires miners to prove that they have access to recall randomly selected bits of weave data in order to produce and share a block. If successful, miners are rewarded in Arweave’s native AR token. These token rewards are derived from transaction fees as well as the network’s storage endowment. The endowment is a protocol-controlled pool of tokens designed to fund the projected cost of storage for 200+ years.")]),e._v(" "),a("img",{staticClass:"amazingdiagram",attrs:{src:e.$withBase("/images/permanence-pie-2.png")}}),e._v(" "),a("div",{staticClass:"caption"},[e._v("Diagram 2: Arweave - The Base Storage Layer")]),e._v(" "),a("p",[e._v("Arweave is file type agnostic – any type of file ranging from simple text files to family photos to complex web applications and archival databases can be stored on the network. To upload data, users must pay an amount of AR proportional to the size of the files being uploaded. Arweave is unique when compared with other decentralized storage solutions in that users only pay once to upload their files, then that is it – the files will be stored in perpetuity without any additional upkeep or subscription fees paid by the user.")]),e._v(" "),a("p",[e._v("The Arweave protocol is designed to handle 1,000 base layer transactions per block with new blocks being mined roughly every two minutes. Each transaction may also store an unbounded number of signed, non-AR-transacting data items assembled into a bundle (i.e., a bundled data item). Since its launch in 2018, this scalable architecture has allowed the network's weave size (total data stored on the network) to grow to 140.8 TB with approximately 1.5 billion base layer transactions and bundled data items submitted from over 181k unique wallets. The Arweave protocol endowment has received 60.7k AR to cover the projected storage costs with a cost of storage 0.858 AR/GiB. *")]),e._v(" "),a("p",[e._v("* data as of November 20, 2023")]),e._v(" "),a("h2",{attrs:{id:"gateways"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#gateways"}},[e._v("#")]),e._v(" Gateways")]),e._v(" "),a("p",[e._v('Gateways act as the front door to the permaweb. They are infrastructure utilities that sit above the base storage layer and allow users to write, access, and query the information stored on Arweave. Gateways are specialized nodes responsible for data ingest (data "in") and data egress (data "out").')]),e._v(" "),a("p",[e._v("For access / egress, gateways allow for data retrieval, caching, and serving as well as indexing transactions into a database that can be easily queried at scale. With bundling functionality, gateways can act as services allowing users to write and seed new data the Arweave network.")]),e._v(" "),a("p",[e._v('These "in and out" functions are not performed by the Arweave mining nodes which are optimized for securing the Layer 1 blockweave and replicating information throughout the network through a mechanism known as Wildfire.')]),e._v(" "),a("img",{staticClass:"amazingdiagram",attrs:{src:e.$withBase("/images/permanence-pie-3.png")}}),e._v(" "),a("div",{staticClass:"caption"},[e._v("Diagram 3: Gateways - The Ingest and Access Component")]),e._v(" "),a("p",[e._v("By taking on these responsibilities, gateways allow low cost and maintenance free hosting of static and dynamic content for users, creators, and developers. But there are costs associated with operating a gateway and Arweave does not offer any tokenomic incentives to offset these expenses. As the permaweb grows, these costs can become very significant.")]),e._v(" "),a("p",[e._v("Arweave.net, the primary community gateway, has scaled to meet the needs of the entire Arweave ecosystem and stored the entire weave. Over the last 6 months, this gateway indexed and cached approximately 3.4 million base layer transactions and bundled data items per day, served 233 million requests for data and node information per day, and responded to 3.2 million GQL queries per day. *")]),e._v(" "),a("p",[e._v("Gateway use cases, and the types of administrators who operate them, can range from at-home projects hosted by hobbyists to larger decentralized platforms and dApps run by small teams, all the way up to scaled out environments capable of supporting enterprise offerings.")]),e._v(" "),a("p",[e._v("* data as of November 20, 2023")]),e._v(" "),a("h2",{attrs:{id:"aocomputer"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#aocomputer"}},[e._v("#")]),e._v(" aoComputer")]),e._v(" "),a("p",[e._v("AO is a global supercomputer built on Arweave. This actor-oriented machine is a single, unified computing environment, hosted on a heterogenous set of nodes in a distributed network. AO is designed to offer an environment in which an arbitrary number of parallel processes can be resident, coordinating through an open message passing layer. This message passing standard connects the machine's independently operating processes together into a 'web' -- in the same way that websites operate on independent servers but are conjoined into a cohesive, unified experience via hyperlinks.")]),e._v(" "),a("img",{staticClass:"amazingdiagram",attrs:{src:e.$withBase("/images/aoPie/permanence-pie-4b.png")}}),e._v(" "),a("div",{staticClass:"caption"},[e._v("Diagram 4: AO - The Supercomputer and Smart Contract Protocol")]),e._v(" "),a("p",[e._v("With AO, developers can create processes that act as smart contracts with token-like properties which can then be used to incorporate incentive structures into applications and infrastructure. The AR.IO Network leverages this technology for development of its network protocol and IO token.")]),e._v(" "),a("h2",{attrs:{id:"the-permaweb"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#the-permaweb"}},[e._v("#")]),e._v(" The Permaweb")]),e._v(" "),a("p",[e._v("The permaweb is the third and final layer of the permanence pie. The permaweb stands for the permanent web, a collection of all the webpages, apps, and files stored on top of the Arweave network and enlivened with the functionality of the AR.IO Network. For users and builders, the permaweb offers low-cost, zero maintenance, permanent hosting of their web apps, files, and web pages.")]),e._v(" "),a("img",{staticClass:"amazingdiagram",attrs:{src:e.$withBase("/images/aoPie/permanence-pie-5b.png")}}),e._v(" "),a("div",{staticClass:"caption"},[e._v("Diagram 5: The Permanence Pie")]),e._v(" "),a("p",[e._v("AR.IO is a global network, protocol, and currency built on top of Arweave that enables the permaweb.")]),e._v(" "),a("h2",{attrs:{id:"references-and-further-reading"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#references-and-further-reading"}},[e._v("#")]),e._v(" References and Further Reading")]),e._v(" "),a("p",[e._v("The following resources were used as reference material for this section and can provide the interested reader with additional information:")]),e._v(" "),a("ul",[a("li",[a("p",[a("a",{attrs:{href:"https://arwiki.wiki/",target:"_blank",rel:"noopener noreferrer"}},[e._v("The ArWiki"),a("OutboundLink")],1)])]),e._v(" "),a("li",[a("p",[a("a",{attrs:{href:"https://github.com/ArweaveTeam",target:"_blank",rel:"noopener noreferrer"}},[e._v("Arweave GitHub repository"),a("OutboundLink")],1)])]),e._v(" "),a("li",[a("p",[a("a",{attrs:{href:"https://cookbook_ao.g8way.io/concepts/index.html",target:"_blank",rel:"noopener noreferrer"}},[e._v("aoComputer"),a("OutboundLink")],1)])])])])}),[],!1,null,null,null);a.default=s.exports}}]); \ No newline at end of file diff --git a/assets/js/29.66dbb6ff.js b/assets/js/29.c9ff30b0.js similarity index 93% rename from assets/js/29.66dbb6ff.js rename to assets/js/29.c9ff30b0.js index 66f530e4..a71a3c99 100644 --- a/assets/js/29.66dbb6ff.js +++ b/assets/js/29.c9ff30b0.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[29],{330:function(t,r,e){"use strict";e.r(r);var o=e(10),n=Object(o.a)({},(function(){var t=this,r=t._self._c;return r("ContentSlotsDistributor",{attrs:{"slot-key":t.$parent.slotKey}},[r("h1",{attrs:{id:"community-resources"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#community-resources"}},[t._v("#")]),t._v(" Community Resources")]),t._v(" "),r("p",[r("a",{attrs:{href:"https://github.com/ar-io",target:"_blank",rel:"noopener noreferrer"}},[t._v("ar.io Github"),r("OutboundLink")],1)]),t._v(" "),r("p",[r("a",{attrs:{href:"https://twitter.com/ar_io_network",target:"_blank",rel:"noopener noreferrer"}},[t._v("ar.io Twitter"),r("OutboundLink")],1)]),t._v(" "),r("p",[r("a",{attrs:{href:"https://discord.gg/7zUPfN4D6g",target:"_blank",rel:"noopener noreferrer"}},[t._v("ar.io Discord"),r("OutboundLink")],1)]),t._v(" "),r("p",[r("a",{attrs:{href:"mailto:info@ar.io"}},[t._v("Contact Us Directly")])])])}),[],!1,null,null,null);r.default=n.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[29],{329:function(t,r,e){"use strict";e.r(r);var o=e(10),n=Object(o.a)({},(function(){var t=this,r=t._self._c;return r("ContentSlotsDistributor",{attrs:{"slot-key":t.$parent.slotKey}},[r("h1",{attrs:{id:"community-resources"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#community-resources"}},[t._v("#")]),t._v(" Community Resources")]),t._v(" "),r("p",[r("a",{attrs:{href:"https://github.com/ar-io",target:"_blank",rel:"noopener noreferrer"}},[t._v("ar.io Github"),r("OutboundLink")],1)]),t._v(" "),r("p",[r("a",{attrs:{href:"https://twitter.com/ar_io_network",target:"_blank",rel:"noopener noreferrer"}},[t._v("ar.io Twitter"),r("OutboundLink")],1)]),t._v(" "),r("p",[r("a",{attrs:{href:"https://discord.gg/7zUPfN4D6g",target:"_blank",rel:"noopener noreferrer"}},[t._v("ar.io Discord"),r("OutboundLink")],1)]),t._v(" "),r("p",[r("a",{attrs:{href:"mailto:info@ar.io"}},[t._v("Contact Us Directly")])])])}),[],!1,null,null,null);r.default=n.exports}}]); \ No newline at end of file diff --git a/assets/js/30.374bf635.js b/assets/js/30.874d4f25.js similarity index 99% rename from assets/js/30.374bf635.js rename to assets/js/30.874d4f25.js index 1f645472..ff0bed99 100644 --- a/assets/js/30.374bf635.js +++ b/assets/js/30.874d4f25.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[30],{333:function(t,a,s){"use strict";s.r(a);var e=s(10),n=Object(e.a)({},(function(){var t=this,a=t._self._c;return a("ContentSlotsDistributor",{attrs:{"slot-key":t.$parent.slotKey}},[a("h1",{attrs:{id:"manifests"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#manifests"}},[t._v("#")]),t._v(" Manifests")]),t._v(" "),a("h2",{attrs:{id:"overview"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#overview"}},[t._v("#")]),t._v(" Overview")]),t._v(" "),a("p",[t._v("ar.io Gateways support friendly-path-name routing for data on Arweave via Manifests. This greatly improves the programmability of data relationships. Consider an illustrative example where data stored on Arweave and accessed like this:")]),t._v(" "),a("div",{staticClass:"language- extra-class"},[a("pre",{pre:!0,attrs:{class:"language-text"}},[a("code",[t._v("http:///cG7Hdi_iTQPoEYgQJFqJ8NMpN4KoZ-vH_j7pG4iP7NI (txID of a website's index.html)\nhttp:///3zFsd7bkCAUtXUKBQ4XiPiQvpLVKfZ6kiLNt2XVSfoV (txID of its js/style.css)\nhttp:///or0_fRYFcQYWh-QsozygI5Zoamw_fUsYu2w8_X1RkYZ (txID of its assets/img/logo.png)\n")])])]),a("p",[t._v("can instead be accessed like this:")]),t._v(" "),a("div",{staticClass:"language- extra-class"},[a("pre",{pre:!0,attrs:{class:"language-text"}},[a("code",[t._v("http:/// (resolves to the txID of index.html)\nhttp:////js/style.css\nhttp:////assets/img/logo.png\n")])])]),a("p",[t._v("NFT collections also benefit from manifest-based routing:")]),t._v(" "),a("div",{staticClass:"language- extra-class"},[a("pre",{pre:!0,attrs:{class:"language-text"}},[a("code",[t._v("http:////0.png\nhttp:////1.png\nhttp:////2.png\n... and so on.\n")])])]),a("p",[t._v("ar.io gateways are capable of resolving manifest paths in a relative manner. An HTML page loading assets from Arweave would be very difficult to develop, maintain, and harden against hosting domains leaving existence if assets had to be linked to by a fully qualified domain name and an Arweave data item ID as the path. For example:")]),t._v(" "),a("div",{staticClass:"language-html extra-class"},[a("pre",{pre:!0,attrs:{class:"language-html"}},[a("code",[a("span",{pre:!0,attrs:{class:"token tag"}},[a("span",{pre:!0,attrs:{class:"token tag"}},[a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("<")]),t._v("img")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token attr-name"}},[t._v("src")]),a("span",{pre:!0,attrs:{class:"token attr-value"}},[a("span",{pre:!0,attrs:{class:"token punctuation attr-equals"}},[t._v("=")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v('"')]),t._v("https://arweave.dev/3zFsd7bkCAUtXUKBQ4XiPiQvpLVKfZ6kiLNt2XVSfoV"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v('"')])]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(">")])]),t._v("\n")])])]),a("p",[t._v("Manifests allow HTML pages to use relative paths to assets with friendly names so that the document is easy to read, maintain, and host across any ar.io domain. For example:")]),t._v(" "),a("div",{staticClass:"language-html extra-class"},[a("pre",{pre:!0,attrs:{class:"language-html"}},[a("code",[a("span",{pre:!0,attrs:{class:"token tag"}},[a("span",{pre:!0,attrs:{class:"token tag"}},[a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("<")]),t._v("img")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token attr-name"}},[t._v("src")]),a("span",{pre:!0,attrs:{class:"token attr-value"}},[a("span",{pre:!0,attrs:{class:"token punctuation attr-equals"}},[t._v("=")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v('"')]),t._v("./logo.png"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v('"')])]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(">")])]),t._v("\n")])])]),a("p",[t._v("Relative routing eliminates the need for every link to contain the full Arweave transaction ID and fully qualified domain name. This makes the HTML more readable and ensures that links remain valid even if the hosting domain changes. If "),a("code",[t._v("index.html")]),t._v(" needed to access "),a("code",[t._v("js/style.css")]),t._v(", the relative link "),a("code",[t._v("./js/style.css")]),t._v(" could be used instead of "),a("code",[t._v("/js/style.css")]),t._v(". This relative routing is incredibly useful for linking together files in a way that allows functional websites to be hosted entirely on Arweave.")]),t._v(" "),a("p",[t._v("Learn more about relative path routing and structuring files into a permanently hosted website in ArDrive's "),a("a",{attrs:{href:"https://docs.ardrive.io/docs/misc/deploy/paths.html",target:"_blank",rel:"noopener noreferrer"}},[t._v("decentralized app guide"),a("OutboundLink")],1)]),t._v(" "),a("h2",{attrs:{id:"what-is-a-manifest"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#what-is-a-manifest"}},[t._v("#")]),t._v(" What is a Manifest")]),t._v(" "),a("p",[t._v('Manifests, also known as "Path Manifests" or "Arweave Manifests," are JSON objects that connect various Arweave data items and define relational paths for easy navigation. A common use case for manifests is permanently hosting websites on Arweave by linking all necessary files together. An ar.io gateway can then resolve the manifest into a fully functional website.')]),t._v(" "),a("h3",{attrs:{id:"sample-manifest"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#sample-manifest"}},[t._v("#")]),t._v(" Sample Manifest")]),t._v(" "),a("div",{staticClass:"language-json extra-class"},[a("pre",{pre:!0,attrs:{class:"language-json"}},[a("code",[a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"manifest"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"arweave/paths"')]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"version"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"0.2.0"')]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"index"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"path"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"index.html"')]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"fallback"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"id"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"iXo3LSfVKVtXUKBzfZ4d7bkCAp6kiLNt2XVUFsPiQvQ"')]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"paths"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"index.html"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"id"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"cG7Hdi_iTQPoEYgQJFqJ8NMpN4KoZ-vH_j7pG4iP7NI"')]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"404.html"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"id"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"iXo3LSfVKVtXUKBzfZ4d7bkCAp6kiLNt2XVUFsPiQvQ"')]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"js/style.css"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"id"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"3zFsd7bkCAUtXUKBQ4XiPiQvpLVKfZ6kiLNt2XVSfoV"')]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"css/style.css"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"id"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"sPiQvpAUXLVK3zF6iXSfo7bkCVQkiLNt24dVtXUKBfZ"')]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"css/mobile.css"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"id"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"fZ4d7bkCAUiXSfo3zFsPiQvpLVKVtXUKB6kiLNt2XVQ"')]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"assets/img/logo.png"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"id"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"or0_fRYFcQYWh-QsozygI5Zoamw_fUsYu2w8_X1RkYZ"')]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"assets/img/icon.png"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"id"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"0543SMRGYuGKTaqLzmpOyK4AxAB96Fra2guHzYxjRGo"')]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),t._v("\n"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),t._v("\n")])])]),a("h3",{attrs:{id:"how-it-works"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#how-it-works"}},[t._v("#")]),t._v(" How it Works")]),t._v(" "),a("p",[t._v("A resolver, typically an ar.io gateway, resolves URLs requesting content based on a manifest transaction ID to the corresponding path key in the "),a("code",[t._v("paths")]),t._v(" object. The URL schema for this type of request is "),a("code",[t._v("https:////")]),t._v(".")]),t._v(" "),a("h3",{attrs:{id:"example-usage"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#example-usage"}},[t._v("#")]),t._v(" Example Usage")]),t._v(" "),a("p",[t._v("Assume the manifest above is uploaded to Arweave with the transaction ID "),a("code",[t._v("UyC5P5qKPZaltMmmZAWdakhlDXsBF6qmyrbWYFchRTk")]),t._v(". The below table shows https requests to the ar.io gateway "),a("code",[t._v("arweave.dev")]),t._v(" requesting various endpoints on the manifest transaction Id, the manifest path where the gateway will find the data to return, and the resulting Arweave txId.")]),t._v(" "),a("div",{staticStyle:{"text-align":"center"}},[a("table",{staticClass:"inline-table",staticStyle:{"text-align":"left"},attrs:{id:"gateway-table"}},[a("tr",{staticStyle:{"text-align":"center"}},[a("th",[t._v("Request Path")]),t._v(" "),a("th",[t._v("Manifest Path")]),t._v(" "),a("th",[t._v("Data served from txID")])]),t._v(" "),a("tr",[a("td",[t._v("https://arweave.dev/UyC5P5qKPZaltMmmZAWdakhlDXsBF6qmyrbWYFchRTk")]),t._v(" "),a("td",[t._v("index")]),t._v(" "),a("td",[t._v("cG7Hdi_iTQPoEYgQJFqJ8NMpN4KoZ-vH_j7pG4iP7NI")])]),t._v(" "),a("tr",[a("td",[t._v("https://arweave.dev/UyC5P5qKPZaltMmmZAWdakhlDXsBF6qmyrbWYFchRTk/index.html")]),t._v(" "),a("td",[t._v("index.html")]),t._v(" "),a("td",[t._v("cG7Hdi_iTQPoEYgQJFqJ8NMpN4KoZ-vH_j7pG4iP7NI")])]),t._v(" "),a("tr",[a("td",[t._v("https://arweave.dev/UyC5P5qKPZaltMmmZAWdakhlDXsBF6qmyrbWYFchRTk/js/style.css")]),t._v(" "),a("td",[t._v("js/style.css")]),t._v(" "),a("td",[t._v("3zFsd7bkCAUtXUKBQ4XiPiQvpLVKfZ6kiLNt2XVSfoV")])]),t._v(" "),a("tr",[a("td",[t._v("https://arweave.dev/UyC5P5qKPZaltMmmZAWdakhlDXsBF6qmyrbWYFchRTk/foobar")]),t._v(" "),a("td",[t._v("fallback")]),t._v(" "),a("td",[t._v("iXo3LSfVKVtXUKBzfZ4d7bkCAp6kiLNt2XVUFsPiQvQ")])])])]),t._v(" "),a("h2",{attrs:{id:"specifications"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#specifications"}},[t._v("#")]),t._v(" Specifications")]),t._v(" "),a("h3",{attrs:{id:"transaction-tags"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#transaction-tags"}},[t._v("#")]),t._v(" Transaction Tags")]),t._v(" "),a("p",[t._v("Manifest are uploaded to Arweave in the same manner as any other data item. A specific content type tag must be added while uploading so that resolvers like the ar.io gateways can recognize a manifest and properly resolve the paths. Tags must be attached to the manifest at the time of upload. They cannot be added later without uploading a new manifest, and they must be attached to the upload transaction, NOT placed inside the json object.")]),t._v(" "),a("p",[t._v("Failure to provide this tag will result in resolvers not recognizing the manifest, so they will only return the raw json instead of the linked data items.")]),t._v(" "),a("h4",{attrs:{id:"content-type"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#content-type"}},[t._v("#")]),t._v(" Content-Type")]),t._v(" "),a("div",{staticClass:"language-json extra-class"},[a("pre",{pre:!0,attrs:{class:"language-json"}},[a("code",[a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"name"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"Content-Type"')]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"value"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"application/x.arweave-manifest+json"')]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),t._v("\n")])])]),a("h3",{attrs:{id:"transaction-data"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#transaction-data"}},[t._v("#")]),t._v(" Transaction Data")]),t._v(" "),a("p",[t._v("Being a json object, there are several attributes that make up the structure of a manifest. The json object must be fully defined and uploaded to Arweave as a data item.")]),t._v(" "),a("h4",{attrs:{id:"manifest"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#manifest"}},[t._v("#")]),t._v(" manifest")]),t._v(" "),a("div",{staticClass:"language-json extra-class"},[a("pre",{pre:!0,attrs:{class:"language-json"}},[a("code",[a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"manifest"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"arweave/paths"')]),t._v("\n")])])]),a("p",[t._v("The "),a("code",[t._v("manifest")]),t._v(" attribute serves as an additional validation layer. It must have the value "),a("code",[t._v("arweave/paths")]),t._v(" in order for a gateway to resolve the manifest.")]),t._v(" "),a("h4",{attrs:{id:"version"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#version"}},[t._v("#")]),t._v(" version")]),t._v(" "),a("div",{staticClass:"language-json extra-class"},[a("pre",{pre:!0,attrs:{class:"language-json"}},[a("code",[a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"version"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"0.2.0"')]),t._v("\n")])])]),a("p",[t._v("The "),a("code",[t._v("version")]),t._v(" attribute defines the version of manifest schema a manifest is using.")]),t._v(" "),a("h4",{attrs:{id:"index"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#index"}},[t._v("#")]),t._v(" index")]),t._v(" "),a("div",{staticClass:"language-json extra-class"},[a("pre",{pre:!0,attrs:{class:"language-json"}},[a("code",[a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"index"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"id"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"cG7Hdi_iTQPoEYgQJFqJ8NMpN4KoZ-vH_j7pG4iP7NI"')]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),t._v("\n")])])]),a("p",[t._v("or")]),t._v(" "),a("div",{staticClass:"language-json extra-class"},[a("pre",{pre:!0,attrs:{class:"language-json"}},[a("code",[a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"index"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"path"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"index.html"')]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),t._v("\n")])])]),a("p",[t._v("The "),a("code",[t._v("index")]),t._v(" attribute is an object that defines the base, or 'starting' data item. It is similar to the "),a("code",[t._v("/")]),t._v(" endpoint on a website. When resolving the manifest with no additional path definition, this is the data item that will be returned.")]),t._v(" "),a("p",[a("code",[t._v("index")]),t._v(" accepts either "),a("code",[t._v("path")]),t._v(" or "),a("code",[t._v("id")]),t._v(" as sub attributes. "),a("code",[t._v("path")]),t._v(" represents the key of a defined "),a("a",{attrs:{href:"#paths"}},[t._v("path")]),t._v(" in the manifest, while "),a("code",[t._v("id")]),t._v(" represents a specific Arweave data item transaction Id.")]),t._v(" "),a("p",[t._v("If both "),a("code",[t._v("path")]),t._v(" and "),a("code",[t._v("id")]),t._v(" are defined in "),a("code",[t._v("index")]),t._v(", "),a("code",[t._v("id")]),t._v(" will override path.")]),t._v(" "),a("h4",{attrs:{id:"fallback"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#fallback"}},[t._v("#")]),t._v(" fallback")]),t._v(" "),a("div",{staticClass:"language-json extra-class"},[a("pre",{pre:!0,attrs:{class:"language-json"}},[a("code",[a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"fallback"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"id"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"iXo3LSfVKVtXUKBzfZ4d7bkCAp6kiLNt2XVUFsPiQvQ"')]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),t._v("\n")])])]),a("p",[t._v("The "),a("code",[t._v("fallback")]),t._v(" attribute is an object that defines an Arweave data item transaction Id for the resolver to fall back to if it fails to correctly resolve a requested path. For example, it can act as a 404 page if a user requests "),a("code",[t._v("manifest/non-existent-page")])]),t._v(" "),a("p",[a("code",[t._v("fallback")]),t._v(" accepts "),a("code",[t._v("id")]),t._v(" as a sub attribute, representing an Arweave data item transaction Id.")]),t._v(" "),a("h4",{attrs:{id:"paths"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#paths"}},[t._v("#")]),t._v(" paths")]),t._v(" "),a("div",{staticClass:"language-json extra-class"},[a("pre",{pre:!0,attrs:{class:"language-json"}},[a("code",[a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"paths"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"index.html"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"id"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"cG7Hdi_iTQPoEYgQJFqJ8NMpN4KoZ-vH_j7pG4iP7NI"')]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"404.html"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"id"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"iXo3LSfVKVtXUKBzfZ4d7bkCAp6kiLNt2XVUFsPiQvQ"')]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"js/style.css"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"id"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"3zFsd7bkCAUtXUKBQ4XiPiQvpLVKfZ6kiLNt2XVSfoV"')]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"css/style.css"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"id"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"sPiQvpAUXLVK3zF6iXSfo7bkCVQkiLNt24dVtXUKBfZ"')]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"css/mobile.css"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"id"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"fZ4d7bkCAUiXSfo3zFsPiQvpLVKVtXUKB6kiLNt2XVQ"')]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"assets/img/logo.png"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"id"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"or0_fRYFcQYWh-QsozygI5Zoamw_fUsYu2w8_X1RkYZ"')]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"assets/img/icon.png"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"id"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"0543SMRGYuGKTaqLzmpOyK4AxAB96Fra2guHzYxjRGo"')]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),t._v("\n")])])]),a("p",[t._v("The "),a("code",[t._v("paths")]),t._v(" attribute is an object that defines the url paths that a manifest can resolve to. If a user navigates to "),a("code",[t._v("manifest/index.html")]),t._v(" the resolver will look for "),a("code",[t._v("index.html")]),t._v(" as a key in the "),a("code",[t._v("paths")]),t._v(" object and return the corresponding "),a("code",[t._v("id")]),t._v(". ("),a("code",[t._v("cG7Hdi_iTQPoEYgQJFqJ8NMpN4KoZ-vH_j7pG4iP7NI")]),t._v(")")])])}),[],!1,null,null,null);a.default=n.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[30],{331:function(t,a,s){"use strict";s.r(a);var e=s(10),n=Object(e.a)({},(function(){var t=this,a=t._self._c;return a("ContentSlotsDistributor",{attrs:{"slot-key":t.$parent.slotKey}},[a("h1",{attrs:{id:"manifests"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#manifests"}},[t._v("#")]),t._v(" Manifests")]),t._v(" "),a("h2",{attrs:{id:"overview"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#overview"}},[t._v("#")]),t._v(" Overview")]),t._v(" "),a("p",[t._v("ar.io Gateways support friendly-path-name routing for data on Arweave via Manifests. This greatly improves the programmability of data relationships. Consider an illustrative example where data stored on Arweave and accessed like this:")]),t._v(" "),a("div",{staticClass:"language- extra-class"},[a("pre",{pre:!0,attrs:{class:"language-text"}},[a("code",[t._v("http:///cG7Hdi_iTQPoEYgQJFqJ8NMpN4KoZ-vH_j7pG4iP7NI (txID of a website's index.html)\nhttp:///3zFsd7bkCAUtXUKBQ4XiPiQvpLVKfZ6kiLNt2XVSfoV (txID of its js/style.css)\nhttp:///or0_fRYFcQYWh-QsozygI5Zoamw_fUsYu2w8_X1RkYZ (txID of its assets/img/logo.png)\n")])])]),a("p",[t._v("can instead be accessed like this:")]),t._v(" "),a("div",{staticClass:"language- extra-class"},[a("pre",{pre:!0,attrs:{class:"language-text"}},[a("code",[t._v("http:/// (resolves to the txID of index.html)\nhttp:////js/style.css\nhttp:////assets/img/logo.png\n")])])]),a("p",[t._v("NFT collections also benefit from manifest-based routing:")]),t._v(" "),a("div",{staticClass:"language- extra-class"},[a("pre",{pre:!0,attrs:{class:"language-text"}},[a("code",[t._v("http:////0.png\nhttp:////1.png\nhttp:////2.png\n... and so on.\n")])])]),a("p",[t._v("ar.io gateways are capable of resolving manifest paths in a relative manner. An HTML page loading assets from Arweave would be very difficult to develop, maintain, and harden against hosting domains leaving existence if assets had to be linked to by a fully qualified domain name and an Arweave data item ID as the path. For example:")]),t._v(" "),a("div",{staticClass:"language-html extra-class"},[a("pre",{pre:!0,attrs:{class:"language-html"}},[a("code",[a("span",{pre:!0,attrs:{class:"token tag"}},[a("span",{pre:!0,attrs:{class:"token tag"}},[a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("<")]),t._v("img")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token attr-name"}},[t._v("src")]),a("span",{pre:!0,attrs:{class:"token attr-value"}},[a("span",{pre:!0,attrs:{class:"token punctuation attr-equals"}},[t._v("=")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v('"')]),t._v("https://arweave.dev/3zFsd7bkCAUtXUKBQ4XiPiQvpLVKfZ6kiLNt2XVSfoV"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v('"')])]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(">")])]),t._v("\n")])])]),a("p",[t._v("Manifests allow HTML pages to use relative paths to assets with friendly names so that the document is easy to read, maintain, and host across any ar.io domain. For example:")]),t._v(" "),a("div",{staticClass:"language-html extra-class"},[a("pre",{pre:!0,attrs:{class:"language-html"}},[a("code",[a("span",{pre:!0,attrs:{class:"token tag"}},[a("span",{pre:!0,attrs:{class:"token tag"}},[a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("<")]),t._v("img")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token attr-name"}},[t._v("src")]),a("span",{pre:!0,attrs:{class:"token attr-value"}},[a("span",{pre:!0,attrs:{class:"token punctuation attr-equals"}},[t._v("=")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v('"')]),t._v("./logo.png"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v('"')])]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(">")])]),t._v("\n")])])]),a("p",[t._v("Relative routing eliminates the need for every link to contain the full Arweave transaction ID and fully qualified domain name. This makes the HTML more readable and ensures that links remain valid even if the hosting domain changes. If "),a("code",[t._v("index.html")]),t._v(" needed to access "),a("code",[t._v("js/style.css")]),t._v(", the relative link "),a("code",[t._v("./js/style.css")]),t._v(" could be used instead of "),a("code",[t._v("/js/style.css")]),t._v(". This relative routing is incredibly useful for linking together files in a way that allows functional websites to be hosted entirely on Arweave.")]),t._v(" "),a("p",[t._v("Learn more about relative path routing and structuring files into a permanently hosted website in ArDrive's "),a("a",{attrs:{href:"https://docs.ardrive.io/docs/misc/deploy/paths.html",target:"_blank",rel:"noopener noreferrer"}},[t._v("decentralized app guide"),a("OutboundLink")],1)]),t._v(" "),a("h2",{attrs:{id:"what-is-a-manifest"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#what-is-a-manifest"}},[t._v("#")]),t._v(" What is a Manifest")]),t._v(" "),a("p",[t._v('Manifests, also known as "Path Manifests" or "Arweave Manifests," are JSON objects that connect various Arweave data items and define relational paths for easy navigation. A common use case for manifests is permanently hosting websites on Arweave by linking all necessary files together. An ar.io gateway can then resolve the manifest into a fully functional website.')]),t._v(" "),a("h3",{attrs:{id:"sample-manifest"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#sample-manifest"}},[t._v("#")]),t._v(" Sample Manifest")]),t._v(" "),a("div",{staticClass:"language-json extra-class"},[a("pre",{pre:!0,attrs:{class:"language-json"}},[a("code",[a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"manifest"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"arweave/paths"')]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"version"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"0.2.0"')]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"index"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"path"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"index.html"')]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"fallback"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"id"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"iXo3LSfVKVtXUKBzfZ4d7bkCAp6kiLNt2XVUFsPiQvQ"')]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"paths"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"index.html"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"id"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"cG7Hdi_iTQPoEYgQJFqJ8NMpN4KoZ-vH_j7pG4iP7NI"')]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"404.html"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"id"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"iXo3LSfVKVtXUKBzfZ4d7bkCAp6kiLNt2XVUFsPiQvQ"')]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"js/style.css"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"id"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"3zFsd7bkCAUtXUKBQ4XiPiQvpLVKfZ6kiLNt2XVSfoV"')]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"css/style.css"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"id"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"sPiQvpAUXLVK3zF6iXSfo7bkCVQkiLNt24dVtXUKBfZ"')]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"css/mobile.css"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"id"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"fZ4d7bkCAUiXSfo3zFsPiQvpLVKVtXUKB6kiLNt2XVQ"')]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"assets/img/logo.png"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"id"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"or0_fRYFcQYWh-QsozygI5Zoamw_fUsYu2w8_X1RkYZ"')]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"assets/img/icon.png"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"id"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"0543SMRGYuGKTaqLzmpOyK4AxAB96Fra2guHzYxjRGo"')]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),t._v("\n"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),t._v("\n")])])]),a("h3",{attrs:{id:"how-it-works"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#how-it-works"}},[t._v("#")]),t._v(" How it Works")]),t._v(" "),a("p",[t._v("A resolver, typically an ar.io gateway, resolves URLs requesting content based on a manifest transaction ID to the corresponding path key in the "),a("code",[t._v("paths")]),t._v(" object. The URL schema for this type of request is "),a("code",[t._v("https:////")]),t._v(".")]),t._v(" "),a("h3",{attrs:{id:"example-usage"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#example-usage"}},[t._v("#")]),t._v(" Example Usage")]),t._v(" "),a("p",[t._v("Assume the manifest above is uploaded to Arweave with the transaction ID "),a("code",[t._v("UyC5P5qKPZaltMmmZAWdakhlDXsBF6qmyrbWYFchRTk")]),t._v(". The below table shows https requests to the ar.io gateway "),a("code",[t._v("arweave.dev")]),t._v(" requesting various endpoints on the manifest transaction Id, the manifest path where the gateway will find the data to return, and the resulting Arweave txId.")]),t._v(" "),a("div",{staticStyle:{"text-align":"center"}},[a("table",{staticClass:"inline-table",staticStyle:{"text-align":"left"},attrs:{id:"gateway-table"}},[a("tr",{staticStyle:{"text-align":"center"}},[a("th",[t._v("Request Path")]),t._v(" "),a("th",[t._v("Manifest Path")]),t._v(" "),a("th",[t._v("Data served from txID")])]),t._v(" "),a("tr",[a("td",[t._v("https://arweave.dev/UyC5P5qKPZaltMmmZAWdakhlDXsBF6qmyrbWYFchRTk")]),t._v(" "),a("td",[t._v("index")]),t._v(" "),a("td",[t._v("cG7Hdi_iTQPoEYgQJFqJ8NMpN4KoZ-vH_j7pG4iP7NI")])]),t._v(" "),a("tr",[a("td",[t._v("https://arweave.dev/UyC5P5qKPZaltMmmZAWdakhlDXsBF6qmyrbWYFchRTk/index.html")]),t._v(" "),a("td",[t._v("index.html")]),t._v(" "),a("td",[t._v("cG7Hdi_iTQPoEYgQJFqJ8NMpN4KoZ-vH_j7pG4iP7NI")])]),t._v(" "),a("tr",[a("td",[t._v("https://arweave.dev/UyC5P5qKPZaltMmmZAWdakhlDXsBF6qmyrbWYFchRTk/js/style.css")]),t._v(" "),a("td",[t._v("js/style.css")]),t._v(" "),a("td",[t._v("3zFsd7bkCAUtXUKBQ4XiPiQvpLVKfZ6kiLNt2XVSfoV")])]),t._v(" "),a("tr",[a("td",[t._v("https://arweave.dev/UyC5P5qKPZaltMmmZAWdakhlDXsBF6qmyrbWYFchRTk/foobar")]),t._v(" "),a("td",[t._v("fallback")]),t._v(" "),a("td",[t._v("iXo3LSfVKVtXUKBzfZ4d7bkCAp6kiLNt2XVUFsPiQvQ")])])])]),t._v(" "),a("h2",{attrs:{id:"specifications"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#specifications"}},[t._v("#")]),t._v(" Specifications")]),t._v(" "),a("h3",{attrs:{id:"transaction-tags"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#transaction-tags"}},[t._v("#")]),t._v(" Transaction Tags")]),t._v(" "),a("p",[t._v("Manifest are uploaded to Arweave in the same manner as any other data item. A specific content type tag must be added while uploading so that resolvers like the ar.io gateways can recognize a manifest and properly resolve the paths. Tags must be attached to the manifest at the time of upload. They cannot be added later without uploading a new manifest, and they must be attached to the upload transaction, NOT placed inside the json object.")]),t._v(" "),a("p",[t._v("Failure to provide this tag will result in resolvers not recognizing the manifest, so they will only return the raw json instead of the linked data items.")]),t._v(" "),a("h4",{attrs:{id:"content-type"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#content-type"}},[t._v("#")]),t._v(" Content-Type")]),t._v(" "),a("div",{staticClass:"language-json extra-class"},[a("pre",{pre:!0,attrs:{class:"language-json"}},[a("code",[a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"name"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"Content-Type"')]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"value"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"application/x.arweave-manifest+json"')]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),t._v("\n")])])]),a("h3",{attrs:{id:"transaction-data"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#transaction-data"}},[t._v("#")]),t._v(" Transaction Data")]),t._v(" "),a("p",[t._v("Being a json object, there are several attributes that make up the structure of a manifest. The json object must be fully defined and uploaded to Arweave as a data item.")]),t._v(" "),a("h4",{attrs:{id:"manifest"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#manifest"}},[t._v("#")]),t._v(" manifest")]),t._v(" "),a("div",{staticClass:"language-json extra-class"},[a("pre",{pre:!0,attrs:{class:"language-json"}},[a("code",[a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"manifest"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"arweave/paths"')]),t._v("\n")])])]),a("p",[t._v("The "),a("code",[t._v("manifest")]),t._v(" attribute serves as an additional validation layer. It must have the value "),a("code",[t._v("arweave/paths")]),t._v(" in order for a gateway to resolve the manifest.")]),t._v(" "),a("h4",{attrs:{id:"version"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#version"}},[t._v("#")]),t._v(" version")]),t._v(" "),a("div",{staticClass:"language-json extra-class"},[a("pre",{pre:!0,attrs:{class:"language-json"}},[a("code",[a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"version"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"0.2.0"')]),t._v("\n")])])]),a("p",[t._v("The "),a("code",[t._v("version")]),t._v(" attribute defines the version of manifest schema a manifest is using.")]),t._v(" "),a("h4",{attrs:{id:"index"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#index"}},[t._v("#")]),t._v(" index")]),t._v(" "),a("div",{staticClass:"language-json extra-class"},[a("pre",{pre:!0,attrs:{class:"language-json"}},[a("code",[a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"index"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"id"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"cG7Hdi_iTQPoEYgQJFqJ8NMpN4KoZ-vH_j7pG4iP7NI"')]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),t._v("\n")])])]),a("p",[t._v("or")]),t._v(" "),a("div",{staticClass:"language-json extra-class"},[a("pre",{pre:!0,attrs:{class:"language-json"}},[a("code",[a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"index"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"path"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"index.html"')]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),t._v("\n")])])]),a("p",[t._v("The "),a("code",[t._v("index")]),t._v(" attribute is an object that defines the base, or 'starting' data item. It is similar to the "),a("code",[t._v("/")]),t._v(" endpoint on a website. When resolving the manifest with no additional path definition, this is the data item that will be returned.")]),t._v(" "),a("p",[a("code",[t._v("index")]),t._v(" accepts either "),a("code",[t._v("path")]),t._v(" or "),a("code",[t._v("id")]),t._v(" as sub attributes. "),a("code",[t._v("path")]),t._v(" represents the key of a defined "),a("a",{attrs:{href:"#paths"}},[t._v("path")]),t._v(" in the manifest, while "),a("code",[t._v("id")]),t._v(" represents a specific Arweave data item transaction Id.")]),t._v(" "),a("p",[t._v("If both "),a("code",[t._v("path")]),t._v(" and "),a("code",[t._v("id")]),t._v(" are defined in "),a("code",[t._v("index")]),t._v(", "),a("code",[t._v("id")]),t._v(" will override path.")]),t._v(" "),a("h4",{attrs:{id:"fallback"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#fallback"}},[t._v("#")]),t._v(" fallback")]),t._v(" "),a("div",{staticClass:"language-json extra-class"},[a("pre",{pre:!0,attrs:{class:"language-json"}},[a("code",[a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"fallback"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"id"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"iXo3LSfVKVtXUKBzfZ4d7bkCAp6kiLNt2XVUFsPiQvQ"')]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),t._v("\n")])])]),a("p",[t._v("The "),a("code",[t._v("fallback")]),t._v(" attribute is an object that defines an Arweave data item transaction Id for the resolver to fall back to if it fails to correctly resolve a requested path. For example, it can act as a 404 page if a user requests "),a("code",[t._v("manifest/non-existent-page")])]),t._v(" "),a("p",[a("code",[t._v("fallback")]),t._v(" accepts "),a("code",[t._v("id")]),t._v(" as a sub attribute, representing an Arweave data item transaction Id.")]),t._v(" "),a("h4",{attrs:{id:"paths"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#paths"}},[t._v("#")]),t._v(" paths")]),t._v(" "),a("div",{staticClass:"language-json extra-class"},[a("pre",{pre:!0,attrs:{class:"language-json"}},[a("code",[a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"paths"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"index.html"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"id"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"cG7Hdi_iTQPoEYgQJFqJ8NMpN4KoZ-vH_j7pG4iP7NI"')]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"404.html"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"id"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"iXo3LSfVKVtXUKBzfZ4d7bkCAp6kiLNt2XVUFsPiQvQ"')]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"js/style.css"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"id"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"3zFsd7bkCAUtXUKBQ4XiPiQvpLVKfZ6kiLNt2XVSfoV"')]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"css/style.css"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"id"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"sPiQvpAUXLVK3zF6iXSfo7bkCVQkiLNt24dVtXUKBfZ"')]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"css/mobile.css"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"id"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"fZ4d7bkCAUiXSfo3zFsPiQvpLVKVtXUKB6kiLNt2XVQ"')]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"assets/img/logo.png"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"id"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"or0_fRYFcQYWh-QsozygI5Zoamw_fUsYu2w8_X1RkYZ"')]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"assets/img/icon.png"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token property"}},[t._v('"id"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"0543SMRGYuGKTaqLzmpOyK4AxAB96Fra2guHzYxjRGo"')]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),t._v("\n")])])]),a("p",[t._v("The "),a("code",[t._v("paths")]),t._v(" attribute is an object that defines the url paths that a manifest can resolve to. If a user navigates to "),a("code",[t._v("manifest/index.html")]),t._v(" the resolver will look for "),a("code",[t._v("index.html")]),t._v(" as a key in the "),a("code",[t._v("paths")]),t._v(" object and return the corresponding "),a("code",[t._v("id")]),t._v(". ("),a("code",[t._v("cG7Hdi_iTQPoEYgQJFqJ8NMpN4KoZ-vH_j7pG4iP7NI")]),t._v(")")])])}),[],!1,null,null,null);a.default=n.exports}}]); \ No newline at end of file diff --git a/assets/js/31.e84c66da.js b/assets/js/31.948c53dc.js similarity index 99% rename from assets/js/31.e84c66da.js rename to assets/js/31.948c53dc.js index 0d88ea95..091112c3 100644 --- a/assets/js/31.e84c66da.js +++ b/assets/js/31.948c53dc.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[31],{331:function(e,t,a){"use strict";a.r(t);var s=a(10),n=Object(s.a)({},(function(){var e=this,t=e._self._c;return t("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[t("h1",{attrs:{id:"browser-sandboxing"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#browser-sandboxing"}},[e._v("#")]),e._v(" Browser Sandboxing")]),e._v(" "),t("h2",{attrs:{id:"overview"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#overview"}},[e._v("#")]),e._v(" Overview")]),e._v(" "),t("p",[e._v("Browser sandboxing allows data requests to a gateway node to benefit from the security advantages of using a browser's same-origin policy by redirecting the requests to a pseudo-unique subdomain of the gateway's apex domain. For example, an attempt to access "),t("code",[e._v("https://arweave.net/gnWKBqFXMJrrksEWrXLQRUQQQeFhv4uVxesHBcT8i6o")]),e._v(" would redirect to "),t("code",[e._v("https://qj2yubvbk4yjv24syelk24wqivcbaqpbmg7yxfof5mdqlrh4rova.arweave.net/gnWKBqFXMJrrksEWrXLQRUQQQeFhv4uVxesHBcT8i6o")])]),e._v(" "),t("p",[e._v("Two DNS records are required to link a domain to an Arweave transaction on a gateway node. For example, "),t("code",[e._v("www.mycustomsite.com")]),e._v(" would need the following records to link it to "),t("code",[e._v("www.arweave-gateway.net")]),e._v(":")]),e._v(" "),t("ul",[t("li",[e._v("A DNS CNAME record pointing to an Arweave gateway: www CNAME "),t("code",[e._v("arweave-gateway.net")]),e._v(",")]),e._v(" "),t("li",[e._v("A DNS TXT record linking the domain with a specific transaction ID: arweavetx TXT "),t("code",[e._v("kTv4OkVtmc0NAsqIcnHfudKjykJeQ83qXXrxf8hrh0S")])])]),e._v(" "),t("p",[e._v("When a browser requests "),t("code",[e._v("www.mycustomsite.com")]),e._v(" the user's machine will (through the usual DNS processes) resolve this to the IP address for the gateway node "),t("code",[e._v("arweave-gateway.net")]),e._v(". When the gateway receives an HTTP request with a non-default hostname, e.g. "),t("code",[e._v("www.mycustomsite.com")]),e._v(" instead of "),t("code",[e._v("www.arweave-gateway.net")]),e._v(", the gateway will query the DNS records for "),t("code",[e._v("www.mycustomsite.com")]),e._v(" and the 'arweavetx' TXT record will tell the node which transaction to serve.")]),e._v(" "),t("h2",{attrs:{id:"tls-and-its-role-in-browser-sandboxing"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#tls-and-its-role-in-browser-sandboxing"}},[e._v("#")]),e._v(" TLS and its Role in Browser Sandboxing")]),e._v(" "),t("p",[e._v("Transport Layer Security (TLS) is a cryptographic protocol designed to provide communications security over a computer network. In the context of Arweave applications and browser sandboxing, TLS plays a critical role in ensuring secure data transmission and enabling the effective use of browser security features.")]),e._v(" "),t("p",[e._v("When Arweave applications are accessed without TLS, most browsers restrict the use of native cryptographic functions. These functions, which include hashing, signing, and verification, are essential for the secure operation of Arweave permaweb apps. Without TLS, not only are these functions unavailable, but the applications also become susceptible to various security threats, notably man-in-the-middle (MITM) attacks. Although Arweave transactions are signed, making direct MITM attacks challenging, the absence of encryption can expose other vulnerabilities. For instance, attackers could intercept and alter the "),t("code",[e._v("/price")]),e._v(" endpoint, potentially causing transaction failures or leading to overcharging.")]),e._v(" "),t("p",[e._v("To address these concerns, gateway operators are responsible for generating and maintaining TLS certificates for their gateways. This can be achieved through various systems, such as ACME for Let's Encrypt. An important step in setting up a gateway is obtaining a wildcard TLS certificate for the gateway's domain. This certificate secures traffic on both the apex domain and its single-level subdomains (e.g., "),t("code",[e._v("gateway.com")]),e._v(" and "),t("code",[e._v("subdomain.gateway.com")]),e._v(").")]),e._v(" "),t("p",[e._v("The integration of TLS is crucial for the implementation of browser sandboxing. When a browser requests a transaction from a gateway, the gateway issues a 301 redirect to a subdomain of the gateway, using a Base32 pseudo-unique address derived from the transaction ID. This redirection, secured by TLS, invokes the browser's same-origin policy. As a result, the requested web page is confined within a secure sandbox environment, isolated from other domains. This isolation is vital for maintaining the integrity and security of transactions and interactions within Arweave's permaweb applications.")]),e._v(" "),t("h2",{attrs:{id:"deriving-sandbox-value"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#deriving-sandbox-value"}},[e._v("#")]),e._v(" Deriving Sandbox Value")]),e._v(" "),t("p",[e._v("ar.io nodes generate browser sandbox values deterministically. Because of this, it is possible to calculate ahead of time what that value will be for a particular transaction id.")]),e._v(" "),t("p",[e._v("Sandbox values are a Base32 encoding of the transaction ID. ar.io gateways use the following code snippet to accomplish the encoding:")]),e._v(" "),t("div",{staticClass:"language-typescript extra-class"},[t("pre",{pre:!0,attrs:{class:"language-typescript"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[e._v("const")]),e._v(" expectedTxSandbox "),t("span",{pre:!0,attrs:{class:"token operator"}},[e._v("=")]),e._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("(")]),e._v("id"),t("span",{pre:!0,attrs:{class:"token operator"}},[e._v(":")]),e._v(" "),t("span",{pre:!0,attrs:{class:"token builtin"}},[e._v("string")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v(")")]),t("span",{pre:!0,attrs:{class:"token operator"}},[e._v(":")]),e._v(" "),t("span",{pre:!0,attrs:{class:"token builtin"}},[e._v("string")]),e._v(" "),t("span",{pre:!0,attrs:{class:"token operator"}},[e._v("=>")]),e._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("{")]),e._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[e._v("return")]),e._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[e._v("toB32")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("(")]),t("span",{pre:!0,attrs:{class:"token function"}},[e._v("fromB64Url")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("(")]),e._v("id"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v(";")]),e._v("\n"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("}")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v(";")]),e._v("\n")])])]),t("p",[e._v("Example:")]),e._v(" "),t("div",{staticClass:"language-typescript extra-class"},[t("pre",{pre:!0,attrs:{class:"language-typescript"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[e._v("const")]),e._v(" id "),t("span",{pre:!0,attrs:{class:"token operator"}},[e._v("=")]),e._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[e._v("'gnWKBqFXMJrrksEWrXLQRUQQQeFhv4uVxesHBcT8i6o'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v(";")]),e._v("\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[e._v("const")]),e._v(" expectedTxSandbox "),t("span",{pre:!0,attrs:{class:"token operator"}},[e._v("=")]),e._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("(")]),e._v("id"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v(")")]),t("span",{pre:!0,attrs:{class:"token operator"}},[e._v(":")]),e._v(" "),t("span",{pre:!0,attrs:{class:"token builtin"}},[e._v("string")]),e._v(" "),t("span",{pre:!0,attrs:{class:"token operator"}},[e._v("=>")]),e._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("{")]),e._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[e._v("return")]),e._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[e._v("toB32")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("(")]),t("span",{pre:!0,attrs:{class:"token function"}},[e._v("fromB64Url")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("(")]),e._v("id"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v(";")]),e._v("\n"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("}")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v(";")]),e._v("\n"),t("span",{pre:!0,attrs:{class:"token builtin"}},[e._v("console")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[e._v("log")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("(")]),e._v("expectedTxSandbox"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v(";")]),e._v("\n")])])]),t("p",[e._v("Example Output:")]),e._v(" "),t("div",{staticClass:"language-console extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("qj2yubvbk4yjv24syelk24wqivcbaqpbmg7yxfof5mdqlrh4rova\n")])])]),t("p",[e._v("View the full code for generating browser sandbox values "),t("a",{attrs:{href:"https://github.com/ar-io/arweave-gateway/blob/719f43f8d6135adf44c87701e95f58105638710a/src/gateway/middleware/sandbox.ts#L69",target:"_blank",rel:"noopener noreferrer"}},[e._v("here"),t("OutboundLink")],1),e._v(".")])])}),[],!1,null,null,null);t.default=n.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[31],{332:function(e,t,a){"use strict";a.r(t);var s=a(10),n=Object(s.a)({},(function(){var e=this,t=e._self._c;return t("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[t("h1",{attrs:{id:"browser-sandboxing"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#browser-sandboxing"}},[e._v("#")]),e._v(" Browser Sandboxing")]),e._v(" "),t("h2",{attrs:{id:"overview"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#overview"}},[e._v("#")]),e._v(" Overview")]),e._v(" "),t("p",[e._v("Browser sandboxing allows data requests to a gateway node to benefit from the security advantages of using a browser's same-origin policy by redirecting the requests to a pseudo-unique subdomain of the gateway's apex domain. For example, an attempt to access "),t("code",[e._v("https://arweave.net/gnWKBqFXMJrrksEWrXLQRUQQQeFhv4uVxesHBcT8i6o")]),e._v(" would redirect to "),t("code",[e._v("https://qj2yubvbk4yjv24syelk24wqivcbaqpbmg7yxfof5mdqlrh4rova.arweave.net/gnWKBqFXMJrrksEWrXLQRUQQQeFhv4uVxesHBcT8i6o")])]),e._v(" "),t("p",[e._v("Two DNS records are required to link a domain to an Arweave transaction on a gateway node. For example, "),t("code",[e._v("www.mycustomsite.com")]),e._v(" would need the following records to link it to "),t("code",[e._v("www.arweave-gateway.net")]),e._v(":")]),e._v(" "),t("ul",[t("li",[e._v("A DNS CNAME record pointing to an Arweave gateway: www CNAME "),t("code",[e._v("arweave-gateway.net")]),e._v(",")]),e._v(" "),t("li",[e._v("A DNS TXT record linking the domain with a specific transaction ID: arweavetx TXT "),t("code",[e._v("kTv4OkVtmc0NAsqIcnHfudKjykJeQ83qXXrxf8hrh0S")])])]),e._v(" "),t("p",[e._v("When a browser requests "),t("code",[e._v("www.mycustomsite.com")]),e._v(" the user's machine will (through the usual DNS processes) resolve this to the IP address for the gateway node "),t("code",[e._v("arweave-gateway.net")]),e._v(". When the gateway receives an HTTP request with a non-default hostname, e.g. "),t("code",[e._v("www.mycustomsite.com")]),e._v(" instead of "),t("code",[e._v("www.arweave-gateway.net")]),e._v(", the gateway will query the DNS records for "),t("code",[e._v("www.mycustomsite.com")]),e._v(" and the 'arweavetx' TXT record will tell the node which transaction to serve.")]),e._v(" "),t("h2",{attrs:{id:"tls-and-its-role-in-browser-sandboxing"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#tls-and-its-role-in-browser-sandboxing"}},[e._v("#")]),e._v(" TLS and its Role in Browser Sandboxing")]),e._v(" "),t("p",[e._v("Transport Layer Security (TLS) is a cryptographic protocol designed to provide communications security over a computer network. In the context of Arweave applications and browser sandboxing, TLS plays a critical role in ensuring secure data transmission and enabling the effective use of browser security features.")]),e._v(" "),t("p",[e._v("When Arweave applications are accessed without TLS, most browsers restrict the use of native cryptographic functions. These functions, which include hashing, signing, and verification, are essential for the secure operation of Arweave permaweb apps. Without TLS, not only are these functions unavailable, but the applications also become susceptible to various security threats, notably man-in-the-middle (MITM) attacks. Although Arweave transactions are signed, making direct MITM attacks challenging, the absence of encryption can expose other vulnerabilities. For instance, attackers could intercept and alter the "),t("code",[e._v("/price")]),e._v(" endpoint, potentially causing transaction failures or leading to overcharging.")]),e._v(" "),t("p",[e._v("To address these concerns, gateway operators are responsible for generating and maintaining TLS certificates for their gateways. This can be achieved through various systems, such as ACME for Let's Encrypt. An important step in setting up a gateway is obtaining a wildcard TLS certificate for the gateway's domain. This certificate secures traffic on both the apex domain and its single-level subdomains (e.g., "),t("code",[e._v("gateway.com")]),e._v(" and "),t("code",[e._v("subdomain.gateway.com")]),e._v(").")]),e._v(" "),t("p",[e._v("The integration of TLS is crucial for the implementation of browser sandboxing. When a browser requests a transaction from a gateway, the gateway issues a 301 redirect to a subdomain of the gateway, using a Base32 pseudo-unique address derived from the transaction ID. This redirection, secured by TLS, invokes the browser's same-origin policy. As a result, the requested web page is confined within a secure sandbox environment, isolated from other domains. This isolation is vital for maintaining the integrity and security of transactions and interactions within Arweave's permaweb applications.")]),e._v(" "),t("h2",{attrs:{id:"deriving-sandbox-value"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#deriving-sandbox-value"}},[e._v("#")]),e._v(" Deriving Sandbox Value")]),e._v(" "),t("p",[e._v("ar.io nodes generate browser sandbox values deterministically. Because of this, it is possible to calculate ahead of time what that value will be for a particular transaction id.")]),e._v(" "),t("p",[e._v("Sandbox values are a Base32 encoding of the transaction ID. ar.io gateways use the following code snippet to accomplish the encoding:")]),e._v(" "),t("div",{staticClass:"language-typescript extra-class"},[t("pre",{pre:!0,attrs:{class:"language-typescript"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[e._v("const")]),e._v(" expectedTxSandbox "),t("span",{pre:!0,attrs:{class:"token operator"}},[e._v("=")]),e._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("(")]),e._v("id"),t("span",{pre:!0,attrs:{class:"token operator"}},[e._v(":")]),e._v(" "),t("span",{pre:!0,attrs:{class:"token builtin"}},[e._v("string")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v(")")]),t("span",{pre:!0,attrs:{class:"token operator"}},[e._v(":")]),e._v(" "),t("span",{pre:!0,attrs:{class:"token builtin"}},[e._v("string")]),e._v(" "),t("span",{pre:!0,attrs:{class:"token operator"}},[e._v("=>")]),e._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("{")]),e._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[e._v("return")]),e._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[e._v("toB32")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("(")]),t("span",{pre:!0,attrs:{class:"token function"}},[e._v("fromB64Url")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("(")]),e._v("id"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v(";")]),e._v("\n"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("}")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v(";")]),e._v("\n")])])]),t("p",[e._v("Example:")]),e._v(" "),t("div",{staticClass:"language-typescript extra-class"},[t("pre",{pre:!0,attrs:{class:"language-typescript"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[e._v("const")]),e._v(" id "),t("span",{pre:!0,attrs:{class:"token operator"}},[e._v("=")]),e._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[e._v("'gnWKBqFXMJrrksEWrXLQRUQQQeFhv4uVxesHBcT8i6o'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v(";")]),e._v("\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[e._v("const")]),e._v(" expectedTxSandbox "),t("span",{pre:!0,attrs:{class:"token operator"}},[e._v("=")]),e._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("(")]),e._v("id"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v(")")]),t("span",{pre:!0,attrs:{class:"token operator"}},[e._v(":")]),e._v(" "),t("span",{pre:!0,attrs:{class:"token builtin"}},[e._v("string")]),e._v(" "),t("span",{pre:!0,attrs:{class:"token operator"}},[e._v("=>")]),e._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("{")]),e._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[e._v("return")]),e._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[e._v("toB32")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("(")]),t("span",{pre:!0,attrs:{class:"token function"}},[e._v("fromB64Url")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("(")]),e._v("id"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v(";")]),e._v("\n"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("}")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v(";")]),e._v("\n"),t("span",{pre:!0,attrs:{class:"token builtin"}},[e._v("console")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[e._v("log")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("(")]),e._v("expectedTxSandbox"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v(";")]),e._v("\n")])])]),t("p",[e._v("Example Output:")]),e._v(" "),t("div",{staticClass:"language-console extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("qj2yubvbk4yjv24syelk24wqivcbaqpbmg7yxfof5mdqlrh4rova\n")])])]),t("p",[e._v("View the full code for generating browser sandbox values "),t("a",{attrs:{href:"https://github.com/ar-io/arweave-gateway/blob/719f43f8d6135adf44c87701e95f58105638710a/src/gateway/middleware/sandbox.ts#L69",target:"_blank",rel:"noopener noreferrer"}},[e._v("here"),t("OutboundLink")],1),e._v(".")])])}),[],!1,null,null,null);t.default=n.exports}}]); \ No newline at end of file diff --git a/assets/js/32.d59b3ddd.js b/assets/js/32.6f87bd0a.js similarity index 99% rename from assets/js/32.d59b3ddd.js rename to assets/js/32.6f87bd0a.js index 43d9b238..ed861b4f 100644 --- a/assets/js/32.d59b3ddd.js +++ b/assets/js/32.6f87bd0a.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[32],{332:function(e,t,a){"use strict";a.r(t);var r=a(10),n=Object(r.a)({},(function(){var e=this,t=e._self._c;return t("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[t("h1",{attrs:{id:"wayfinder-protocol"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#wayfinder-protocol"}},[e._v("#")]),e._v(" Wayfinder Protocol")]),e._v(" "),t("h2",{attrs:{id:"overview"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#overview"}},[e._v("#")]),e._v(" Overview")]),e._v(" "),t("p",[e._v("The Wayfinder protocol is a "),t("a",{attrs:{href:"https://wikipedia.org/wiki/Uniform_Resource_Identifier",target:"_blank",rel:"noopener noreferrer"}},[e._v("URI scheme"),t("OutboundLink")],1),e._v(" designed to translate requests for Arweave content into "),t("code",[e._v("https://")]),e._v(" requests. Essentially, Wayfinder allows for transforming traditional Arweave URLs like "),t("code",[e._v("https://arweave.net/long-txid")]),e._v(" into more concise and user-friendly forms such as "),t("code",[e._v("ar://txid")]),e._v(" or "),t("code",[e._v("ar://arns-name")]),e._v(". When combined with the "),t("a",{attrs:{href:"https://chrome.google.com/webstore/detail/ario-WayFinder/hnhmeknhajanolcoihhkkaaimapnmgil",target:"_blank",rel:"noopener noreferrer"}},[e._v("AR.IO WayFinder browser extension"),t("OutboundLink")],1),e._v(", the request can be directed to any number of functional "),t("RouterLink",{attrs:{to:"/concepts/gateways/"}},[e._v("AR.IO Gateways")]),e._v(" to serve the content.")],1),e._v(" "),t("p",[e._v('An early technical breakdown of Wayfinder, formerly "ARCSS", created by Arweave community member DMac, can be found '),t("a",{attrs:{href:"https://hackmd.io/@DMac/r1iyjzxPs",target:"_blank",rel:"noopener noreferrer"}},[e._v("here"),t("OutboundLink")],1),e._v(".")]),e._v(" "),t("h2",{attrs:{id:"browser-integration"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#browser-integration"}},[e._v("#")]),e._v(" Browser Integration")]),e._v(" "),t("p",[e._v("The Wayfinder Protocol is currently facilitated via the WayFinder App or internal application integration. The intention is to lead popular web browsers like Chrome and Brave towards a direct integration of the Wayfinder Protocol, similar to recent integrations of the "),t("code",[e._v("ipfs://")]),e._v(" protocol. Such integration would remove the need for a client-side extension and boost developers' confidence in embedding Wayfinder Protocol URLs in their websites.")]),e._v(" "),t("h2",{attrs:{id:"internal-application-integration"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#internal-application-integration"}},[e._v("#")]),e._v(" Internal Application Integration")]),e._v(" "),t("p",[e._v("Certain websites or apps may want to resolve Arweave Transaction ID's (TxId) internally. In these scenarios, they can process the Wayfinder Protocol internally without depending on browser support or the WayFinder App. A prime example is "),t("a",{attrs:{href:"https://opensea.io",target:"_blank",rel:"noopener noreferrer"}},[e._v("opensea.io"),t("OutboundLink")],1),e._v(". Opensea, an NFT marketplace, frequently imports NFT metadata from external sources. If metadata employs the Wayfinder Protocol, Opensea internally resolves these, presenting content without redirecting users through an "),t("code",[e._v("https://")]),e._v(" link.")]),e._v(" "),t("p",[e._v("There are two main approaches to resolving Wayfinder Protocol URLs:")]),e._v(" "),t("ol",[t("li",[e._v("Convert Wayfinder into a request directed at a predefined Arweave gateway.")]),e._v(" "),t("li",[e._v("Retrieve a list of active AR.IO Gateways from the "),t("RouterLink",{attrs:{to:"/concepts/gateway-network.html#gateway-address-registry-gar"}},[e._v("GAR")]),e._v(" by reading the contract state, or other available resources, and then fetch content from a gateway on the list.")],1)]),e._v(" "),t("p",[e._v("Each strategy has its benefits and challenges, necessitating careful evaluation based on specific use cases.")]),e._v(" "),t("h2",{attrs:{id:"benefits-of-wayfinder-over-hardcoded-gateway-links"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#benefits-of-wayfinder-over-hardcoded-gateway-links"}},[e._v("#")]),e._v(" Benefits of Wayfinder Over Hardcoded Gateway Links")]),e._v(" "),t("p",[e._v("Using the Wayfinder Protocol offers several advantages over hardcoded links to a specific gateway:")]),e._v(" "),t("ol",[t("li",[t("strong",[e._v("Flexibility")]),e._v(": Wayfinder links can be routed through any available AR.IO Gateway, ensuring content remains accessible even if a specific gateway is down or congested.")]),e._v(" "),t("li",[t("strong",[e._v("Decentralization")]),e._v(": By not being tied to a single gateway, the Wayfinder Protocol embodies the decentralized spirit of the web, reducing potential censorship points.")]),e._v(" "),t("li",[t("strong",[e._v("Ease of Maintenance")]),e._v(": Developers and content creators don't need to modify links if a gateway changes its URL or becomes unavailable. The WayFinder extension handles routing to an active gateway.")]),e._v(" "),t("li",[t("strong",[e._v("Consistency")]),e._v(": Users always receive the same content, regardless of the gateway used, ensuring a consistent user experience.")])]),e._v(" "),t("h2",{attrs:{id:"use-cases"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#use-cases"}},[e._v("#")]),e._v(" Use Cases")]),e._v(" "),t("h3",{attrs:{id:"decentralized-web-hosting-with-flexible-access"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#decentralized-web-hosting-with-flexible-access"}},[e._v("#")]),e._v(" Decentralized Web Hosting with Flexible Access")]),e._v(" "),t("p",[e._v("With Wayfinder, not only can websites be hosted on the Arweave network, but their accessibility is also enhanced. By using the Wayfinder Protocol, web developers can ensure that if a specific AR.IO Gateway is down, the content can still be accessed through another gateway, offering a more reliable and resilient user experience.")]),e._v(" "),t("h3",{attrs:{id:"digital-archives-and-preservation-with-enhanced-sharing"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#digital-archives-and-preservation-with-enhanced-sharing"}},[e._v("#")]),e._v(" Digital Archives and Preservation with Enhanced Sharing")]),e._v(" "),t("p",[e._v("Digitally archiving public domain works, especially in light of events like "),t("a",{attrs:{href:"https://www.youtube.com/watch?v=eMSCHXklULQ",target:"_blank",rel:"noopener noreferrer"}},[e._v('"banned books week"'),t("OutboundLink")],1),e._v(", becomes more efficient with Wayfinder. Historical institutions or enthusiasts can easily share specific Wayfinder links to documents or media. Unlike hardcoded links which might break if a specific gateway goes offline, Wayfinder ensures that the content remains consistently accessible.")]),e._v(" "),t("h3",{attrs:{id:"media-sharing-platforms-with-consistent-content-delivery"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#media-sharing-platforms-with-consistent-content-delivery"}},[e._v("#")]),e._v(" Media Sharing Platforms with Consistent Content Delivery")]),e._v(" "),t("p",[e._v("For platforms hosting user-generated content, the Wayfinder Protocol provides not just decentralized hosting but also a guarantee of content delivery. Even if a content piece becomes viral and one gateway gets congested, Wayfinder ensures that users can still access the content through another gateway, providing a seamless experience.")]),e._v(" "),t("h3",{attrs:{id:"decentralized-applications-dapps-with-reliable-front-end-accessibility"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#decentralized-applications-dapps-with-reliable-front-end-accessibility"}},[e._v("#")]),e._v(" Decentralized Applications (DApps) with Reliable Front-End Accessibility")]),e._v(" "),t("p",[e._v("DApps, while benefiting from Arweave's permanent hosting, can further ensure their front-end remains consistently accessible to users by using Wayfinder. If a DApp's front-end is accessed frequently, causing strain on one gateway, Wayfinder can help ensure the load is distributed, and the DApp remains online and functional.")]),e._v(" "),t("h2",{attrs:{id:"how-it-works"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#how-it-works"}},[e._v("#")]),e._v(" How it Works")]),e._v(" "),t("h3",{attrs:{id:"transaction-id"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#transaction-id"}},[e._v("#")]),e._v(" Transaction ID")]),e._v(" "),t("p",[e._v("To access content tied to an Arweave Transaction ID (TxId), simply append the TxId to "),t("code",[e._v("ar://")]),e._v(":")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("ar://qI19W6spw-kzOGl4qUMNp2gwFH2EBfDXOFsjkcNyK9A\n")])])]),t("p",[e._v("Inputting this into a WayFinder-equipped browser will route your request through the right AR.IO Gateway, translating it as per your "),t("code",[e._v("Routing Method")]),e._v(" settings.")]),e._v(" "),t("h3",{attrs:{id:"arns"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#arns"}},[e._v("#")]),e._v(" ArNS")]),e._v(" "),t("p",[e._v("Fetching content via an Arweave Name System (ArNS) name is straightforward. Attach the ArNS name to "),t("code",[e._v("ar://")]),e._v(":")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("ar://good-morning\n")])])]),t("p",[e._v("The Wayfinder protocol, along with the WayFinder App, discerns between TxIds and ArNS names. Once the suitable "),t("code",[e._v("https://")]),e._v(" request is formulated, the chosen gateway translates the ArNS name based on the ArNS aoComputer contract.")]),e._v(" "),t("h2",{attrs:{id:"wayfinder-app"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#wayfinder-app"}},[e._v("#")]),e._v(" Wayfinder App")]),e._v(" "),t("p",[e._v("The "),t("a",{attrs:{href:"https://chrome.google.com/webstore/detail/ario-WayFinder/hnhmeknhajanolcoihhkkaaimapnmgil",target:"_blank",rel:"noopener noreferrer"}},[e._v("AR.IO WayFinder App"),t("OutboundLink")],1),e._v(" is a browser extension designed to facilitate the resolving of "),t("code",[e._v("ar://")]),e._v(" urls.")]),e._v(" "),t("h3",{attrs:{id:"v0-0-10"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#v0-0-10"}},[e._v("#")]),e._v(" v0.0.10")]),e._v(" "),t("p",[e._v("As of v0.0.10, Wayfinder supports the resolution of TXT records to Arweave content on top level domains. This innovative feature leverages DNS TXT records to associate Arweave transaction IDs with human-readable domain names, facilitating intuitive and memorable access to permaweb content. By simply entering an "),t("code",[e._v("ar://")]),e._v(" URL with a domain name, the Wayfinder App resolves the corresponding Arweave transaction ID through DNS TXT records, redirecting users directly to the content hosted on the Arweave network.")]),e._v(" "),t("p",[t("strong",[e._v("Setup")]),e._v(": Owners of a domain can set a TXT record for that domain following the format "),t("code",[e._v("ARTX ")]),e._v(".")]),e._v(" "),t("center",[t("img",{attrs:{src:e.$withBase("/images/arcss-txt.png")}})]),e._v(" "),t("p",[t("strong",[e._v("Wayfinder Redirection")]),e._v(": With a TXT record set properly, whenever a user (who has Wayfinder installed) enters an "),t("code",[e._v("ar://")]),e._v(" URL containing a domain name (e.g., "),t("code",[e._v("ar://example.com")]),e._v("), the Wayfinder App performs a DNS lookup for that TXT record in order to redirect to the Arweave content. The lookup is completed through a secure DNS-over-HTTPS query to ensure privacy and integrity.")]),e._v(" "),t("p",[t("strong",[e._v("Dynamic Content Resolution")]),e._v(": After retrieving the TXT record, the Wayfinder App extracts that Arweave transaction ID and dynamically redirects the user to the content on the permaweb. This process is transparent to the user, providing a seamless experience as if accessing a traditional website.")]),e._v(" "),t("h3",{attrs:{id:"key-features"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#key-features"}},[e._v("#")]),e._v(" Key Features")]),e._v(" "),t("ul",[t("li",[t("strong",[e._v("Gasless")]),e._v(": TXT records can be set without any onchain transactions that would require gas fees.")]),e._v(" "),t("li",[t("strong",[e._v("Easy Integration")]),e._v(": Domain owners can easily link their permaweb content to their domains, making it accessible through a simple "),t("code",[e._v("ar://")]),e._v(" URL.")]),e._v(" "),t("li",[t("strong",[e._v("Dyncamic Content Access")]),e._v(": Content links can be updated in real-time through DNS TXT records, without requiring any changes to the "),t("code",[e._v("ar://")]),e._v(" URL itself.")]),e._v(" "),t("li",[t("strong",[e._v("Enhanced User Experience")]),e._v(": Offers users a familiar and easy-to-remember way to access permaweb content, leveraging standard web domain names.")]),e._v(" "),t("li",[t("strong",[e._v("Security and Privacy")]),e._v(": Secure DNS-over-HTTPS queries for DNS lookups protect user privacy and enhances security.")])]),e._v(" "),t("h3",{attrs:{id:"use-cases-2"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#use-cases-2"}},[e._v("#")]),e._v(" Use Cases")]),e._v(" "),t("ul",[t("li",[t("strong",[e._v("Branded Content Access")]),e._v(": Companies and individuals can brand their permaweb content, making it accessible through their domain, enhancing brand visibility and user trust.")]),e._v(" "),t("li",[t("strong",[e._v("Dynamic Content Updates")]),e._v(": Domain owners can easily update what Permaweb content their AR:// URL resolves to, which is ideal for frequently updated resources like documents, blogs, and application interfaces.")]),e._v(" "),t("li",[t("strong",[e._v("Educational and Informational Resources")]),e._v(": Educational institutions and information providers can make their resources permanently available on the permaweb, accessible through simple, memorable URLs.")])]),e._v(" "),t("p",[e._v("This feature marks a significant advancement in making decentralized content more accessible and user-friendly, bridging the gap between traditional internet usability and the permaweb’s permanence and censorship-resistant nature.")])],1)}),[],!1,null,null,null);t.default=n.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[32],{333:function(e,t,a){"use strict";a.r(t);var r=a(10),n=Object(r.a)({},(function(){var e=this,t=e._self._c;return t("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[t("h1",{attrs:{id:"wayfinder-protocol"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#wayfinder-protocol"}},[e._v("#")]),e._v(" Wayfinder Protocol")]),e._v(" "),t("h2",{attrs:{id:"overview"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#overview"}},[e._v("#")]),e._v(" Overview")]),e._v(" "),t("p",[e._v("The Wayfinder protocol is a "),t("a",{attrs:{href:"https://wikipedia.org/wiki/Uniform_Resource_Identifier",target:"_blank",rel:"noopener noreferrer"}},[e._v("URI scheme"),t("OutboundLink")],1),e._v(" designed to translate requests for Arweave content into "),t("code",[e._v("https://")]),e._v(" requests. Essentially, Wayfinder allows for transforming traditional Arweave URLs like "),t("code",[e._v("https://arweave.net/long-txid")]),e._v(" into more concise and user-friendly forms such as "),t("code",[e._v("ar://txid")]),e._v(" or "),t("code",[e._v("ar://arns-name")]),e._v(". When combined with the "),t("a",{attrs:{href:"https://chrome.google.com/webstore/detail/ario-WayFinder/hnhmeknhajanolcoihhkkaaimapnmgil",target:"_blank",rel:"noopener noreferrer"}},[e._v("AR.IO WayFinder browser extension"),t("OutboundLink")],1),e._v(", the request can be directed to any number of functional "),t("RouterLink",{attrs:{to:"/concepts/gateways/"}},[e._v("AR.IO Gateways")]),e._v(" to serve the content.")],1),e._v(" "),t("p",[e._v('An early technical breakdown of Wayfinder, formerly "ARCSS", created by Arweave community member DMac, can be found '),t("a",{attrs:{href:"https://hackmd.io/@DMac/r1iyjzxPs",target:"_blank",rel:"noopener noreferrer"}},[e._v("here"),t("OutboundLink")],1),e._v(".")]),e._v(" "),t("h2",{attrs:{id:"browser-integration"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#browser-integration"}},[e._v("#")]),e._v(" Browser Integration")]),e._v(" "),t("p",[e._v("The Wayfinder Protocol is currently facilitated via the WayFinder App or internal application integration. The intention is to lead popular web browsers like Chrome and Brave towards a direct integration of the Wayfinder Protocol, similar to recent integrations of the "),t("code",[e._v("ipfs://")]),e._v(" protocol. Such integration would remove the need for a client-side extension and boost developers' confidence in embedding Wayfinder Protocol URLs in their websites.")]),e._v(" "),t("h2",{attrs:{id:"internal-application-integration"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#internal-application-integration"}},[e._v("#")]),e._v(" Internal Application Integration")]),e._v(" "),t("p",[e._v("Certain websites or apps may want to resolve Arweave Transaction ID's (TxId) internally. In these scenarios, they can process the Wayfinder Protocol internally without depending on browser support or the WayFinder App. A prime example is "),t("a",{attrs:{href:"https://opensea.io",target:"_blank",rel:"noopener noreferrer"}},[e._v("opensea.io"),t("OutboundLink")],1),e._v(". Opensea, an NFT marketplace, frequently imports NFT metadata from external sources. If metadata employs the Wayfinder Protocol, Opensea internally resolves these, presenting content without redirecting users through an "),t("code",[e._v("https://")]),e._v(" link.")]),e._v(" "),t("p",[e._v("There are two main approaches to resolving Wayfinder Protocol URLs:")]),e._v(" "),t("ol",[t("li",[e._v("Convert Wayfinder into a request directed at a predefined Arweave gateway.")]),e._v(" "),t("li",[e._v("Retrieve a list of active AR.IO Gateways from the "),t("RouterLink",{attrs:{to:"/concepts/gateway-network.html#gateway-address-registry-gar"}},[e._v("GAR")]),e._v(" by reading the contract state, or other available resources, and then fetch content from a gateway on the list.")],1)]),e._v(" "),t("p",[e._v("Each strategy has its benefits and challenges, necessitating careful evaluation based on specific use cases.")]),e._v(" "),t("h2",{attrs:{id:"benefits-of-wayfinder-over-hardcoded-gateway-links"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#benefits-of-wayfinder-over-hardcoded-gateway-links"}},[e._v("#")]),e._v(" Benefits of Wayfinder Over Hardcoded Gateway Links")]),e._v(" "),t("p",[e._v("Using the Wayfinder Protocol offers several advantages over hardcoded links to a specific gateway:")]),e._v(" "),t("ol",[t("li",[t("strong",[e._v("Flexibility")]),e._v(": Wayfinder links can be routed through any available AR.IO Gateway, ensuring content remains accessible even if a specific gateway is down or congested.")]),e._v(" "),t("li",[t("strong",[e._v("Decentralization")]),e._v(": By not being tied to a single gateway, the Wayfinder Protocol embodies the decentralized spirit of the web, reducing potential censorship points.")]),e._v(" "),t("li",[t("strong",[e._v("Ease of Maintenance")]),e._v(": Developers and content creators don't need to modify links if a gateway changes its URL or becomes unavailable. The WayFinder extension handles routing to an active gateway.")]),e._v(" "),t("li",[t("strong",[e._v("Consistency")]),e._v(": Users always receive the same content, regardless of the gateway used, ensuring a consistent user experience.")])]),e._v(" "),t("h2",{attrs:{id:"use-cases"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#use-cases"}},[e._v("#")]),e._v(" Use Cases")]),e._v(" "),t("h3",{attrs:{id:"decentralized-web-hosting-with-flexible-access"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#decentralized-web-hosting-with-flexible-access"}},[e._v("#")]),e._v(" Decentralized Web Hosting with Flexible Access")]),e._v(" "),t("p",[e._v("With Wayfinder, not only can websites be hosted on the Arweave network, but their accessibility is also enhanced. By using the Wayfinder Protocol, web developers can ensure that if a specific AR.IO Gateway is down, the content can still be accessed through another gateway, offering a more reliable and resilient user experience.")]),e._v(" "),t("h3",{attrs:{id:"digital-archives-and-preservation-with-enhanced-sharing"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#digital-archives-and-preservation-with-enhanced-sharing"}},[e._v("#")]),e._v(" Digital Archives and Preservation with Enhanced Sharing")]),e._v(" "),t("p",[e._v("Digitally archiving public domain works, especially in light of events like "),t("a",{attrs:{href:"https://www.youtube.com/watch?v=eMSCHXklULQ",target:"_blank",rel:"noopener noreferrer"}},[e._v('"banned books week"'),t("OutboundLink")],1),e._v(", becomes more efficient with Wayfinder. Historical institutions or enthusiasts can easily share specific Wayfinder links to documents or media. Unlike hardcoded links which might break if a specific gateway goes offline, Wayfinder ensures that the content remains consistently accessible.")]),e._v(" "),t("h3",{attrs:{id:"media-sharing-platforms-with-consistent-content-delivery"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#media-sharing-platforms-with-consistent-content-delivery"}},[e._v("#")]),e._v(" Media Sharing Platforms with Consistent Content Delivery")]),e._v(" "),t("p",[e._v("For platforms hosting user-generated content, the Wayfinder Protocol provides not just decentralized hosting but also a guarantee of content delivery. Even if a content piece becomes viral and one gateway gets congested, Wayfinder ensures that users can still access the content through another gateway, providing a seamless experience.")]),e._v(" "),t("h3",{attrs:{id:"decentralized-applications-dapps-with-reliable-front-end-accessibility"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#decentralized-applications-dapps-with-reliable-front-end-accessibility"}},[e._v("#")]),e._v(" Decentralized Applications (DApps) with Reliable Front-End Accessibility")]),e._v(" "),t("p",[e._v("DApps, while benefiting from Arweave's permanent hosting, can further ensure their front-end remains consistently accessible to users by using Wayfinder. If a DApp's front-end is accessed frequently, causing strain on one gateway, Wayfinder can help ensure the load is distributed, and the DApp remains online and functional.")]),e._v(" "),t("h2",{attrs:{id:"how-it-works"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#how-it-works"}},[e._v("#")]),e._v(" How it Works")]),e._v(" "),t("h3",{attrs:{id:"transaction-id"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#transaction-id"}},[e._v("#")]),e._v(" Transaction ID")]),e._v(" "),t("p",[e._v("To access content tied to an Arweave Transaction ID (TxId), simply append the TxId to "),t("code",[e._v("ar://")]),e._v(":")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("ar://qI19W6spw-kzOGl4qUMNp2gwFH2EBfDXOFsjkcNyK9A\n")])])]),t("p",[e._v("Inputting this into a WayFinder-equipped browser will route your request through the right AR.IO Gateway, translating it as per your "),t("code",[e._v("Routing Method")]),e._v(" settings.")]),e._v(" "),t("h3",{attrs:{id:"arns"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#arns"}},[e._v("#")]),e._v(" ArNS")]),e._v(" "),t("p",[e._v("Fetching content via an Arweave Name System (ArNS) name is straightforward. Attach the ArNS name to "),t("code",[e._v("ar://")]),e._v(":")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("ar://good-morning\n")])])]),t("p",[e._v("The Wayfinder protocol, along with the WayFinder App, discerns between TxIds and ArNS names. Once the suitable "),t("code",[e._v("https://")]),e._v(" request is formulated, the chosen gateway translates the ArNS name based on the ArNS aoComputer contract.")]),e._v(" "),t("h2",{attrs:{id:"wayfinder-app"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#wayfinder-app"}},[e._v("#")]),e._v(" Wayfinder App")]),e._v(" "),t("p",[e._v("The "),t("a",{attrs:{href:"https://chrome.google.com/webstore/detail/ario-WayFinder/hnhmeknhajanolcoihhkkaaimapnmgil",target:"_blank",rel:"noopener noreferrer"}},[e._v("AR.IO WayFinder App"),t("OutboundLink")],1),e._v(" is a browser extension designed to facilitate the resolving of "),t("code",[e._v("ar://")]),e._v(" urls.")]),e._v(" "),t("h3",{attrs:{id:"v0-0-10"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#v0-0-10"}},[e._v("#")]),e._v(" v0.0.10")]),e._v(" "),t("p",[e._v("As of v0.0.10, Wayfinder supports the resolution of TXT records to Arweave content on top level domains. This innovative feature leverages DNS TXT records to associate Arweave transaction IDs with human-readable domain names, facilitating intuitive and memorable access to permaweb content. By simply entering an "),t("code",[e._v("ar://")]),e._v(" URL with a domain name, the Wayfinder App resolves the corresponding Arweave transaction ID through DNS TXT records, redirecting users directly to the content hosted on the Arweave network.")]),e._v(" "),t("p",[t("strong",[e._v("Setup")]),e._v(": Owners of a domain can set a TXT record for that domain following the format "),t("code",[e._v("ARTX ")]),e._v(".")]),e._v(" "),t("center",[t("img",{attrs:{src:e.$withBase("/images/arcss-txt.png")}})]),e._v(" "),t("p",[t("strong",[e._v("Wayfinder Redirection")]),e._v(": With a TXT record set properly, whenever a user (who has Wayfinder installed) enters an "),t("code",[e._v("ar://")]),e._v(" URL containing a domain name (e.g., "),t("code",[e._v("ar://example.com")]),e._v("), the Wayfinder App performs a DNS lookup for that TXT record in order to redirect to the Arweave content. The lookup is completed through a secure DNS-over-HTTPS query to ensure privacy and integrity.")]),e._v(" "),t("p",[t("strong",[e._v("Dynamic Content Resolution")]),e._v(": After retrieving the TXT record, the Wayfinder App extracts that Arweave transaction ID and dynamically redirects the user to the content on the permaweb. This process is transparent to the user, providing a seamless experience as if accessing a traditional website.")]),e._v(" "),t("h3",{attrs:{id:"key-features"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#key-features"}},[e._v("#")]),e._v(" Key Features")]),e._v(" "),t("ul",[t("li",[t("strong",[e._v("Gasless")]),e._v(": TXT records can be set without any onchain transactions that would require gas fees.")]),e._v(" "),t("li",[t("strong",[e._v("Easy Integration")]),e._v(": Domain owners can easily link their permaweb content to their domains, making it accessible through a simple "),t("code",[e._v("ar://")]),e._v(" URL.")]),e._v(" "),t("li",[t("strong",[e._v("Dyncamic Content Access")]),e._v(": Content links can be updated in real-time through DNS TXT records, without requiring any changes to the "),t("code",[e._v("ar://")]),e._v(" URL itself.")]),e._v(" "),t("li",[t("strong",[e._v("Enhanced User Experience")]),e._v(": Offers users a familiar and easy-to-remember way to access permaweb content, leveraging standard web domain names.")]),e._v(" "),t("li",[t("strong",[e._v("Security and Privacy")]),e._v(": Secure DNS-over-HTTPS queries for DNS lookups protect user privacy and enhances security.")])]),e._v(" "),t("h3",{attrs:{id:"use-cases-2"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#use-cases-2"}},[e._v("#")]),e._v(" Use Cases")]),e._v(" "),t("ul",[t("li",[t("strong",[e._v("Branded Content Access")]),e._v(": Companies and individuals can brand their permaweb content, making it accessible through their domain, enhancing brand visibility and user trust.")]),e._v(" "),t("li",[t("strong",[e._v("Dynamic Content Updates")]),e._v(": Domain owners can easily update what Permaweb content their AR:// URL resolves to, which is ideal for frequently updated resources like documents, blogs, and application interfaces.")]),e._v(" "),t("li",[t("strong",[e._v("Educational and Informational Resources")]),e._v(": Educational institutions and information providers can make their resources permanently available on the permaweb, accessible through simple, memorable URLs.")])]),e._v(" "),t("p",[e._v("This feature marks a significant advancement in making decentralized content more accessible and user-friendly, bridging the gap between traditional internet usability and the permaweb’s permanence and censorship-resistant nature.")])],1)}),[],!1,null,null,null);t.default=n.exports}}]); \ No newline at end of file diff --git a/assets/js/33.b0845a95.js b/assets/js/33.739a1ec4.js similarity index 99% rename from assets/js/33.b0845a95.js rename to assets/js/33.739a1ec4.js index 8d748efd..cac5dd51 100644 --- a/assets/js/33.b0845a95.js +++ b/assets/js/33.739a1ec4.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[33],{335:function(e,t,a){"use strict";a.r(t);var n=a(10),r=Object(n.a)({},(function(){var e=this,t=e._self._c;return t("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[t("h1",{attrs:{id:"contributing-to-ar-io-docs"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#contributing-to-ar-io-docs"}},[e._v("#")]),e._v(" Contributing to AR.IO Docs")]),e._v(" "),t("h2",{attrs:{id:"overview"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#overview"}},[e._v("#")]),e._v(" Overview")]),e._v(" "),t("p",[e._v("The AR.IO Docs serve as a primary source of information and guidance for users, developers, and contributors interacting with the AR.IO platform. As such, maintaining its clarity, accuracy, and comprehensiveness is paramount. This document outlines the standardized procedures and best practices for contributing to these docs. By following this guide, contributors can ensure that their additions and modifications align with the established documentation structure and conventions.")]),e._v(" "),t("p",[e._v("Contributions can range from minor typographical corrections to the addition of entire new sections. Regardless of the scale, every contribution is valuable. Proper setup, understanding the file structure, and familiarity with the submission process are essential components of effective contribution. The sections that follow delve into each stage of the contribution process, from initial setup and local development to the submission of changes for review.")]),e._v(" "),t("p",[e._v("By adhering to this guide, contributors can streamline the review and integration of their changes, ensuring that the AR.IO Docs remain a reliable and up-to-date resource for all its users.")]),e._v(" "),t("h2",{attrs:{id:"prerequisites"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#prerequisites"}},[e._v("#")]),e._v(" Prerequisites")]),e._v(" "),t("ul",[t("li",[t("a",{attrs:{href:"https://github.com/",target:"_blank",rel:"noopener noreferrer"}},[e._v("Github account"),t("OutboundLink")],1)]),e._v(" "),t("li",[t("a",{attrs:{href:"https://git-scm.com/book/en/v2/Getting-Started-Installing-Git",target:"_blank",rel:"noopener noreferrer"}},[e._v("Git installed on your computer"),t("OutboundLink")],1)]),e._v(" "),t("li",[e._v("Nodejs version 16.15.1")]),e._v(" "),t("li",[t("a",{attrs:{href:"https://classic.yarnpkg.com/lang/en/docs/install/#windows-stable",target:"_blank",rel:"noopener noreferrer"}},[e._v("Yarn installed on your computer"),t("OutboundLink")],1)])]),e._v(" "),t("h2",{attrs:{id:"initial-setup"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#initial-setup"}},[e._v("#")]),e._v(" Initial Setup")]),e._v(" "),t("h3",{attrs:{id:"fork-the-repository"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#fork-the-repository"}},[e._v("#")]),e._v(" Fork the Repository")]),e._v(" "),t("p",[e._v("While logged into your Github account, visit the repository for the "),t("a",{attrs:{href:"https://github.com/ar-io/public-site",target:"_blank",rel:"noopener noreferrer"}},[e._v("AR.IO public site"),t("OutboundLink")],1)]),e._v(" "),t("p",[e._v('Near the top right of the page, there will be a button labeled "fork".')]),e._v(" "),t("p",[e._v("Clicking this will begin the process of making a copy of the public-site repo under your own account.")]),e._v(" "),t("p",[e._v('On the next screen, make sure the box labeled "copy the '),t("code",[e._v("main")]),e._v(' branch only" is NOT checked, then click "create fork"')]),e._v(" "),t("p",[e._v("This process only needs to be completed once, you will not need to create a new fork each time you want to submit an edit.")]),e._v(" "),t("h3",{attrs:{id:"clone-your-fork"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#clone-your-fork"}},[e._v("#")]),e._v(" Clone your Fork")]),e._v(" "),t("p",[e._v("Once you have your fork created, you'll need to clone it onto your computer in order to make your edits.")]),e._v(" "),t("p",[e._v("Navigate the the location you want to clone the repo and open a terminal (or command prompt/powershell on Windows)")]),e._v(" "),t("p",[e._v("run the command:")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("git clone -b main https://github.com/yourusernamehere/public-site\n")])])]),t("p",[e._v('Be sure to replace "yourusernamehere" with your Github username')]),e._v(" "),t("h3",{attrs:{id:"link-upstream"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#link-upstream"}},[e._v("#")]),e._v(" Link Upstream")]),e._v(" "),t("p",[e._v('The AR.IO Public Site, and especially the docs portal, is constantly evolving. You are going to want to be able to pull updates from the AR.IO repo into your fork without having to delete it and create a new fork. To do this, you can link the original repo to your fork as "upstream".')]),e._v(" "),t("p",[e._v("From inside the fork on your computer, run the command:")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("git remote add upstream https://github.com/ar-io/public-site\n")])])]),t("p",[e._v("You can then check to make sure the upstream source was added with:")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("git remote -v\n")])])]),t("h4",{attrs:{id:"pull-updates"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#pull-updates"}},[e._v("#")]),e._v(" Pull updates")]),e._v(" "),t("p",[e._v('Periodically, you should check if there have been updates to the original repo by using"')]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("git fetch upstream\n")])])]),t("p",[e._v('If changes show up, you can merge them into your own repo by ensuring you are on the "main" branch, and then running the merge command:')]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("git checkout main\ngit merge upstream/main\n")])])]),t("h3",{attrs:{id:"install-dependencies-for-docs-portal"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#install-dependencies-for-docs-portal"}},[e._v("#")]),e._v(" Install Dependencies for Docs Portal")]),e._v(" "),t("p",[e._v("The AR.IO Public Site is primarily a static html website. There are no dependencies that need to be installed in order to launch and view the site as a whole. However, the docs portal is a Vuepress app nested inside that html website. In order to launch the docs portal for review, or to build it into static html, you are going to need to install its dependencies.")]),e._v(" "),t("p",[e._v("From in the root directory of the Public Site, navigate into the docs portal and run the install command:")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("cd docsGenerator/docs\nyarn install\n")])])]),t("p",[t("strong",[e._v("NOTE")]),e._v(": This repository uses yarn to manage dependency versions, installing dependencies with npm instead of yarn can lead to errors.")]),e._v(" "),t("h2",{attrs:{id:"editing"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#editing"}},[e._v("#")]),e._v(" Editing")]),e._v(" "),t("p",[e._v("Vuepress generates content using markdown (.md) files. Each markdown file can be displayed as its own content page. The location (url) of each page is "),t("strong",[e._v("generally")]),e._v(" determined by the file's location in the file-structure of the vuepress app, though this can be overridden by using frontmatter. Adding a new content page can be as simple as dropping a new file in the appropriate location in the file-structure and adding a reference to it in the sidebar configuration file.")]),e._v(" "),t("h3",{attrs:{id:"branches"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#branches"}},[e._v("#")]),e._v(" Branches")]),e._v(" "),t("p",[e._v("You should always ensure that you are starting from an up to date version of the main branch. See "),t("a",{attrs:{href:"#pull-updates"}},[e._v("Pull Updates")]),e._v(" for instructions.")]),e._v(" "),t("p",[e._v("Once you are up to date and on the main branch, you should always create a new branch specific to the changes you are making. This can be done with the command:")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("git checkout -b \n")])])]),t("p",[e._v("Replace "),t("code",[e._v("")]),e._v(" with a short, descriptive name for what you are changing. Do not reuse branches for future edits, you should always create a fresh branch based on the most up to date version of the main branch.")]),e._v(" "),t("h3",{attrs:{id:"what-is-markdown"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#what-is-markdown"}},[e._v("#")]),e._v(" What is Markdown?")]),e._v(" "),t("p",[e._v("Markdown is a lightweight markup language that allows you to format plain text documents with simple syntax. It's commonly used for creating documentation, README files, and web content. Markdown files are easy to read, write, and convert into various formats, such as HTML.")]),e._v(" "),t("p",[e._v("Here are some commonly used Markdown syntax elements:")]),e._v(" "),t("ol",[t("li",[t("p",[t("strong",[e._v("Headings")]),e._v(": Use hash symbols (#) to denote headings. The number of hashes determines the heading level (e.g., "),t("code",[e._v("# Heading 1")]),e._v(", "),t("code",[e._v("## Heading 2")]),e._v(").")])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Emphasis")]),e._v(": Surround text with asterisks (*) or underscores (_) for emphasis. For example, "),t("code",[e._v("*italic\\*")]),e._v("or"),t("code",[e._v("_italic_")]),e._v("renders as italic, and"),t("code",[e._v("**bold**")]),e._v("or"),t("code",[e._v("**bold**")]),e._v(" renders as bold.")])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Lists")]),e._v(": Create unordered lists by starting lines with hyphens (-), plus signs (+), or asterisks (*). Ordered lists use numbers (1., 2., etc.).")])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Links")]),e._v(": Enclose the linked text in square brackets [] and the URL in parentheses (). For example, "),t("a",{attrs:{href:"https://ar.io",target:"_blank",rel:"noopener noreferrer"}},[e._v("AR.IO"),t("OutboundLink")],1),e._v(" creates a link to AR.IO's Public website.")])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Images")]),e._v(": Similar to links, but with an exclamation mark (!) at the beginning. For example, "),t("code",[e._v("![Alt Text](image.jpg)")]),e._v(" embeds an image.")])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Code")]),e._v(": Use backticks ( ` ) to denote inline code . For code blocks, indent each line with four spaces or use triple backticks (```) before and after the code block.")])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Horizontal Rule")]),e._v(": To create a horizontal rule, use three or more hyphens (-), asterisks (*), or underscores (_).")])])]),e._v(" "),t("p",[e._v("To denote a Markdown file, save it with the .md extension (e.g., "),t("code",[e._v("document.md")]),e._v(").")]),e._v(" "),t("p",[e._v("When used in a VuePress app, Markdown files are rendered into HTML by VuePress's built-in Markdown compiler, which supports most standard html tags as well. This includes the ability to assign css classes for additional styling.")]),e._v(" "),t("h3",{attrs:{id:"frontmatter"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#frontmatter"}},[e._v("#")]),e._v(" Frontmatter")]),e._v(" "),t("p",[e._v("Vuepress supports injecting certain options into your markdown files. These options, collectively, are known as frontmatter. There are 5 items that you will primarily use for these docs. All of them may be omitted without issue, or included for additional customization. These are:")]),e._v(" "),t("ol",[t("li",[t("p",[t("strong",[e._v("title")]),e._v(": This sets the title for the page. It will be displayed on the left side of the browser tab when a user accesses that page. If omitted, the title will be pulled from the sidebar for that page.")])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("permalink")]),e._v(": Vuepress sets urls based on the filestructure of the project. This can be overridden using permalink, and a custom url can be assigned to a specific page.")])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("prev")]),e._v(": Sets the value for the “previous page” button that appears at the bottom of the page. If omitted, this will be pulled from the sidebar. The button can be removed from the page by setting the value to “false”.")])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("next")]),e._v(": Similar to "),t("code",[e._v("prev")]),e._v(", this sets the “next page” button value.")])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("tags")]),e._v(": accepts a list of key words that can be accessed by the “search” function, as well as helping with SEO.")])])]),e._v(" "),t("p",[e._v("Frontmatter uses YAML syntax, sandwiched inside two lines of three dashes "),t("code",[e._v("---")]),e._v(" , like so:")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v('---\ntitle: Frontmatter Instructions\npermalink: "/frontmatter/"\nprev: "./what-is-markdown"\nnext: false\ntags: ["frontmatter", "permalink", "other tags"]\n---\n')])])]),t("h3",{attrs:{id:"css"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#css"}},[e._v("#")]),e._v(" CSS")]),e._v(" "),t("p",[e._v("If you add html elements into your markdown file, you can assign custom css classes to them. The easiest way to customize a class is to add it to the primary global css file located at "),t("code",[e._v("/docsGenerator/docs/src/.vuepress/theme/styles/index.styl")])]),e._v(" "),t("p",[e._v("The file is written in stylus, but supports standard css syntax.")]),e._v(" "),t("p",[t("strong",[e._v("NOTE")]),e._v(": It is a good idea to be overly specific with your class names, as the content of the index.styl file will affect the entire docs portal.")]),e._v(" "),t("h3",{attrs:{id:"adding-to-the-sidebar"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#adding-to-the-sidebar"}},[e._v("#")]),e._v(" Adding to the Sidebar")]),e._v(" "),t("p",[e._v("The sidebar is rendered from a JavaScript array of objects. It is possible to configure multiple different sidebars, and have them display depending on the filepath a user is currently viewing. The docs portal only uses a single default sidebar at the moment. The configuration file for the sidebar is located at "),t("code",[e._v("/docs/src/.vuepress/theme/configs/default_sidebar_config.js")])]),e._v(" "),t("p",[e._v("To add a new item to the sidebar, simply choose where you want the item to appear, and insert an object with the following format:")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v('{\ntitle: "Text you want to display",\npath: "Filepath to new file"\n}\n')])])]),t("p",[e._v("The sidebar, when rendered, will find all the H2 tags (##) in the file, and automatically display them as sub-headers in the sidebar, which work as links to that specific section of the page.")]),e._v(" "),t("p",[e._v("You can also make a sidebar item into an expandable menu by adding a children attribute, which will be an array of objects similar to the parent:")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v('{\ntitle: "Label",\nchildren: [\n {\n title: "First Subtext",\n path: "Filepath to file"\n },\n {\n title: "Second Subtext",\n path: "Filepath to second file"\n }\n ]\n}\n')])])]),t("p",[e._v("Children can be nested for several layers if desired.")]),e._v(" "),t("p",[e._v("Below is the current sidebar configuration to serve as an example:")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v('module.exports = [\n {\n title: "Welcome",\n path: "/",\n },\n {\n title: "Network Overview",\n children: [\n {\n title: "Introduction",\n path: "/introduction",\n },\n {\n title: "Arweave and the Permaweb",\n path: "/arweave",\n },\n {\n title: "The IO Token",\n path: "/token.md",\n },\n {\n title: "Gateway Architecture",\n path: "/gateways/gateways",\n },\n {\n title: "Network Protocols",\n path: "/network-protocols"\n },\n {\n title: "Arweave name System (ArNS)",\n path: "/arns.md",\n },\n ],\n },\n {\n title: "Gateway Operators",\n children: [\n {\n title: "Getting Started",\n children: [\n {\n title: "Overview",\n path: "/gateways/ar-io-node/overview"\n },\n {\n title: "Setting up on Windows",\n path: "/gateways/ar-io-node/windows-setup",\n },\n {\n title: "Setting up on Linux",\n path: "/gateways/ar-io-node/linux-setup",\n },\n {\n title: "Join the Network",\n path: "/gateways/ar-io-node/testnet"\n },\n {\n title: "Upgrading",\n path: "/gateways/ar-io-node/upgrading"\n }\n\n ],\n },\n {\n title: "Advanced Configurations",\n path: "/gateways/ar-io-node/advanced-config"\n },\n {\n title: "AR.IO HTTP API",\n path: "/gateways/ar-io-node/api",\n },\n {\n title: "AR.IO Admin API",\n path: "/gateways/ar-io-node/admin/admin-api"\n }\n ],\n },\n {\n title: "Ecosystem and Community",\n children: [\n {\n title: "AR.IO Foundation",\n path: "/foundation",\n },\n {\n title: "AR.IO Labs",\n path: "/labs",\n },\n {\n title: "Community Resources",\n path: "/community-resources",\n },\n ],\n },\n {\n title: "Glossary",\n path: "/glossary",\n },\n];\n')])])]),t("h2",{attrs:{id:"development-and-deployment"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#development-and-deployment"}},[e._v("#")]),e._v(" Development and Deployment")]),e._v(" "),t("h3",{attrs:{id:"launching-development-server"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#launching-development-server"}},[e._v("#")]),e._v(" Launching Development Server")]),e._v(" "),t("p",[e._v("From inside the "),t("code",[e._v("docsGenerator/docs")]),e._v(" directory in your terminal, you can launch a development server in order to preview your edits. This will automatically update as you are making edits, but if some changes do not immediately appear you can shut the server down and restart it for a hard refresh:")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("yarn dev\n")])])]),t("p",[e._v("The development server will, by default, launch at localhost:8080. The server can be shut down with "),t("code",[e._v("ctrl+c")]),e._v(" or by killing the terminal used to start it.")]),e._v(" "),t("p",[e._v("The most common error when attempting to launch the development server comes from not having a compatible version of Nodejs. If you get an error, try switching to Node version 16.15.1")]),e._v(" "),t("h3",{attrs:{id:"building-static-files"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#building-static-files"}},[e._v("#")]),e._v(" Building Static Files")]),e._v(" "),t("p",[e._v("The Vuepress docs portal is nested inside a static html website. For ease of deployment, Vuepress can build the docs portal into static html files and place them in the docs/ folder in the root of the website. This is not necessary for submitting a pr, but it may be useful for local testing. You can do this by navigating your terminal inside the docs portal Vuepress app "),t("code",[e._v("docsGenerator/docs")]),e._v(" and running the command:")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("yarn build\n")])])]),t("h3",{attrs:{id:"creating-your-pull-request"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#creating-your-pull-request"}},[e._v("#")]),e._v(" Creating Your Pull Request")]),e._v(" "),t("p",[e._v("Once you have all of your local changes committed and synced to your github account, you can create a Pull Request and have the team review the changes for integration into the public site.")]),e._v(" "),t("ol",[t("li",[t("p",[e._v("Ensure that all of your changes are committed to your own repository. All commits should follow the "),t("a",{attrs:{href:"https://www.conventionalcommits.org/en/v1.0.0/#summary",target:"_blank",rel:"noopener noreferrer"}},[e._v("Conventional Commits"),t("OutboundLink")],1),e._v(" standards.")])]),e._v(" "),t("li",[t("p",[e._v("Navigate to your forked repository's page on GitHub.")])]),e._v(" "),t("li",[t("p",[e._v("Switch to the branch you created for your changes.")])]),e._v(" "),t("li",[t("p",[e._v('You should see a banner indicating that you recently pushed a new branch. Click on the "Compare & pull request" button on that banner.')])]),e._v(" "),t("li",[t("p",[e._v('Make sure the base repository is set to the original AR.IO repository and the base branch is set to "staging".')])]),e._v(" "),t("li",[t("p",[e._v("Provide a brief description of your changes in the pull request form. Ensure your title adheres to the "),t("a",{attrs:{href:"https://www.conventionalcommits.org/en/v1.0.0/#summary",target:"_blank",rel:"noopener noreferrer"}},[e._v("Conventional Commits"),t("OutboundLink")],1),e._v(" standards.")])]),e._v(" "),t("li",[t("p",[e._v("Review the changes and confirm they appear as expected.")])]),e._v(" "),t("li",[t("p",[e._v('Once you\'re ready, click on the "Create pull request" button. The AR.IO team will review the request and, if approved, merge your changes into the staging branch of the repository. The changes will later be merged into the main branch for production deployment.')])])])])}),[],!1,null,null,null);t.default=r.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[33],{334:function(e,t,a){"use strict";a.r(t);var n=a(10),r=Object(n.a)({},(function(){var e=this,t=e._self._c;return t("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[t("h1",{attrs:{id:"contributing-to-ar-io-docs"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#contributing-to-ar-io-docs"}},[e._v("#")]),e._v(" Contributing to AR.IO Docs")]),e._v(" "),t("h2",{attrs:{id:"overview"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#overview"}},[e._v("#")]),e._v(" Overview")]),e._v(" "),t("p",[e._v("The AR.IO Docs serve as a primary source of information and guidance for users, developers, and contributors interacting with the AR.IO platform. As such, maintaining its clarity, accuracy, and comprehensiveness is paramount. This document outlines the standardized procedures and best practices for contributing to these docs. By following this guide, contributors can ensure that their additions and modifications align with the established documentation structure and conventions.")]),e._v(" "),t("p",[e._v("Contributions can range from minor typographical corrections to the addition of entire new sections. Regardless of the scale, every contribution is valuable. Proper setup, understanding the file structure, and familiarity with the submission process are essential components of effective contribution. The sections that follow delve into each stage of the contribution process, from initial setup and local development to the submission of changes for review.")]),e._v(" "),t("p",[e._v("By adhering to this guide, contributors can streamline the review and integration of their changes, ensuring that the AR.IO Docs remain a reliable and up-to-date resource for all its users.")]),e._v(" "),t("h2",{attrs:{id:"prerequisites"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#prerequisites"}},[e._v("#")]),e._v(" Prerequisites")]),e._v(" "),t("ul",[t("li",[t("a",{attrs:{href:"https://github.com/",target:"_blank",rel:"noopener noreferrer"}},[e._v("Github account"),t("OutboundLink")],1)]),e._v(" "),t("li",[t("a",{attrs:{href:"https://git-scm.com/book/en/v2/Getting-Started-Installing-Git",target:"_blank",rel:"noopener noreferrer"}},[e._v("Git installed on your computer"),t("OutboundLink")],1)]),e._v(" "),t("li",[e._v("Nodejs version 16.15.1")]),e._v(" "),t("li",[t("a",{attrs:{href:"https://classic.yarnpkg.com/lang/en/docs/install/#windows-stable",target:"_blank",rel:"noopener noreferrer"}},[e._v("Yarn installed on your computer"),t("OutboundLink")],1)])]),e._v(" "),t("h2",{attrs:{id:"initial-setup"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#initial-setup"}},[e._v("#")]),e._v(" Initial Setup")]),e._v(" "),t("h3",{attrs:{id:"fork-the-repository"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#fork-the-repository"}},[e._v("#")]),e._v(" Fork the Repository")]),e._v(" "),t("p",[e._v("While logged into your Github account, visit the repository for the "),t("a",{attrs:{href:"https://github.com/ar-io/public-site",target:"_blank",rel:"noopener noreferrer"}},[e._v("AR.IO public site"),t("OutboundLink")],1)]),e._v(" "),t("p",[e._v('Near the top right of the page, there will be a button labeled "fork".')]),e._v(" "),t("p",[e._v("Clicking this will begin the process of making a copy of the public-site repo under your own account.")]),e._v(" "),t("p",[e._v('On the next screen, make sure the box labeled "copy the '),t("code",[e._v("main")]),e._v(' branch only" is NOT checked, then click "create fork"')]),e._v(" "),t("p",[e._v("This process only needs to be completed once, you will not need to create a new fork each time you want to submit an edit.")]),e._v(" "),t("h3",{attrs:{id:"clone-your-fork"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#clone-your-fork"}},[e._v("#")]),e._v(" Clone your Fork")]),e._v(" "),t("p",[e._v("Once you have your fork created, you'll need to clone it onto your computer in order to make your edits.")]),e._v(" "),t("p",[e._v("Navigate the the location you want to clone the repo and open a terminal (or command prompt/powershell on Windows)")]),e._v(" "),t("p",[e._v("run the command:")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("git clone -b main https://github.com/yourusernamehere/public-site\n")])])]),t("p",[e._v('Be sure to replace "yourusernamehere" with your Github username')]),e._v(" "),t("h3",{attrs:{id:"link-upstream"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#link-upstream"}},[e._v("#")]),e._v(" Link Upstream")]),e._v(" "),t("p",[e._v('The AR.IO Public Site, and especially the docs portal, is constantly evolving. You are going to want to be able to pull updates from the AR.IO repo into your fork without having to delete it and create a new fork. To do this, you can link the original repo to your fork as "upstream".')]),e._v(" "),t("p",[e._v("From inside the fork on your computer, run the command:")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("git remote add upstream https://github.com/ar-io/public-site\n")])])]),t("p",[e._v("You can then check to make sure the upstream source was added with:")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("git remote -v\n")])])]),t("h4",{attrs:{id:"pull-updates"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#pull-updates"}},[e._v("#")]),e._v(" Pull updates")]),e._v(" "),t("p",[e._v('Periodically, you should check if there have been updates to the original repo by using"')]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("git fetch upstream\n")])])]),t("p",[e._v('If changes show up, you can merge them into your own repo by ensuring you are on the "main" branch, and then running the merge command:')]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("git checkout main\ngit merge upstream/main\n")])])]),t("h3",{attrs:{id:"install-dependencies-for-docs-portal"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#install-dependencies-for-docs-portal"}},[e._v("#")]),e._v(" Install Dependencies for Docs Portal")]),e._v(" "),t("p",[e._v("The AR.IO Public Site is primarily a static html website. There are no dependencies that need to be installed in order to launch and view the site as a whole. However, the docs portal is a Vuepress app nested inside that html website. In order to launch the docs portal for review, or to build it into static html, you are going to need to install its dependencies.")]),e._v(" "),t("p",[e._v("From in the root directory of the Public Site, navigate into the docs portal and run the install command:")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("cd docsGenerator/docs\nyarn install\n")])])]),t("p",[t("strong",[e._v("NOTE")]),e._v(": This repository uses yarn to manage dependency versions, installing dependencies with npm instead of yarn can lead to errors.")]),e._v(" "),t("h2",{attrs:{id:"editing"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#editing"}},[e._v("#")]),e._v(" Editing")]),e._v(" "),t("p",[e._v("Vuepress generates content using markdown (.md) files. Each markdown file can be displayed as its own content page. The location (url) of each page is "),t("strong",[e._v("generally")]),e._v(" determined by the file's location in the file-structure of the vuepress app, though this can be overridden by using frontmatter. Adding a new content page can be as simple as dropping a new file in the appropriate location in the file-structure and adding a reference to it in the sidebar configuration file.")]),e._v(" "),t("h3",{attrs:{id:"branches"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#branches"}},[e._v("#")]),e._v(" Branches")]),e._v(" "),t("p",[e._v("You should always ensure that you are starting from an up to date version of the main branch. See "),t("a",{attrs:{href:"#pull-updates"}},[e._v("Pull Updates")]),e._v(" for instructions.")]),e._v(" "),t("p",[e._v("Once you are up to date and on the main branch, you should always create a new branch specific to the changes you are making. This can be done with the command:")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("git checkout -b \n")])])]),t("p",[e._v("Replace "),t("code",[e._v("")]),e._v(" with a short, descriptive name for what you are changing. Do not reuse branches for future edits, you should always create a fresh branch based on the most up to date version of the main branch.")]),e._v(" "),t("h3",{attrs:{id:"what-is-markdown"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#what-is-markdown"}},[e._v("#")]),e._v(" What is Markdown?")]),e._v(" "),t("p",[e._v("Markdown is a lightweight markup language that allows you to format plain text documents with simple syntax. It's commonly used for creating documentation, README files, and web content. Markdown files are easy to read, write, and convert into various formats, such as HTML.")]),e._v(" "),t("p",[e._v("Here are some commonly used Markdown syntax elements:")]),e._v(" "),t("ol",[t("li",[t("p",[t("strong",[e._v("Headings")]),e._v(": Use hash symbols (#) to denote headings. The number of hashes determines the heading level (e.g., "),t("code",[e._v("# Heading 1")]),e._v(", "),t("code",[e._v("## Heading 2")]),e._v(").")])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Emphasis")]),e._v(": Surround text with asterisks (*) or underscores (_) for emphasis. For example, "),t("code",[e._v("*italic\\*")]),e._v("or"),t("code",[e._v("_italic_")]),e._v("renders as italic, and"),t("code",[e._v("**bold**")]),e._v("or"),t("code",[e._v("**bold**")]),e._v(" renders as bold.")])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Lists")]),e._v(": Create unordered lists by starting lines with hyphens (-), plus signs (+), or asterisks (*). Ordered lists use numbers (1., 2., etc.).")])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Links")]),e._v(": Enclose the linked text in square brackets [] and the URL in parentheses (). For example, "),t("a",{attrs:{href:"https://ar.io",target:"_blank",rel:"noopener noreferrer"}},[e._v("AR.IO"),t("OutboundLink")],1),e._v(" creates a link to AR.IO's Public website.")])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Images")]),e._v(": Similar to links, but with an exclamation mark (!) at the beginning. For example, "),t("code",[e._v("![Alt Text](image.jpg)")]),e._v(" embeds an image.")])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Code")]),e._v(": Use backticks ( ` ) to denote inline code . For code blocks, indent each line with four spaces or use triple backticks (```) before and after the code block.")])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Horizontal Rule")]),e._v(": To create a horizontal rule, use three or more hyphens (-), asterisks (*), or underscores (_).")])])]),e._v(" "),t("p",[e._v("To denote a Markdown file, save it with the .md extension (e.g., "),t("code",[e._v("document.md")]),e._v(").")]),e._v(" "),t("p",[e._v("When used in a VuePress app, Markdown files are rendered into HTML by VuePress's built-in Markdown compiler, which supports most standard html tags as well. This includes the ability to assign css classes for additional styling.")]),e._v(" "),t("h3",{attrs:{id:"frontmatter"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#frontmatter"}},[e._v("#")]),e._v(" Frontmatter")]),e._v(" "),t("p",[e._v("Vuepress supports injecting certain options into your markdown files. These options, collectively, are known as frontmatter. There are 5 items that you will primarily use for these docs. All of them may be omitted without issue, or included for additional customization. These are:")]),e._v(" "),t("ol",[t("li",[t("p",[t("strong",[e._v("title")]),e._v(": This sets the title for the page. It will be displayed on the left side of the browser tab when a user accesses that page. If omitted, the title will be pulled from the sidebar for that page.")])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("permalink")]),e._v(": Vuepress sets urls based on the filestructure of the project. This can be overridden using permalink, and a custom url can be assigned to a specific page.")])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("prev")]),e._v(": Sets the value for the “previous page” button that appears at the bottom of the page. If omitted, this will be pulled from the sidebar. The button can be removed from the page by setting the value to “false”.")])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("next")]),e._v(": Similar to "),t("code",[e._v("prev")]),e._v(", this sets the “next page” button value.")])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("tags")]),e._v(": accepts a list of key words that can be accessed by the “search” function, as well as helping with SEO.")])])]),e._v(" "),t("p",[e._v("Frontmatter uses YAML syntax, sandwiched inside two lines of three dashes "),t("code",[e._v("---")]),e._v(" , like so:")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v('---\ntitle: Frontmatter Instructions\npermalink: "/frontmatter/"\nprev: "./what-is-markdown"\nnext: false\ntags: ["frontmatter", "permalink", "other tags"]\n---\n')])])]),t("h3",{attrs:{id:"css"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#css"}},[e._v("#")]),e._v(" CSS")]),e._v(" "),t("p",[e._v("If you add html elements into your markdown file, you can assign custom css classes to them. The easiest way to customize a class is to add it to the primary global css file located at "),t("code",[e._v("/docsGenerator/docs/src/.vuepress/theme/styles/index.styl")])]),e._v(" "),t("p",[e._v("The file is written in stylus, but supports standard css syntax.")]),e._v(" "),t("p",[t("strong",[e._v("NOTE")]),e._v(": It is a good idea to be overly specific with your class names, as the content of the index.styl file will affect the entire docs portal.")]),e._v(" "),t("h3",{attrs:{id:"adding-to-the-sidebar"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#adding-to-the-sidebar"}},[e._v("#")]),e._v(" Adding to the Sidebar")]),e._v(" "),t("p",[e._v("The sidebar is rendered from a JavaScript array of objects. It is possible to configure multiple different sidebars, and have them display depending on the filepath a user is currently viewing. The docs portal only uses a single default sidebar at the moment. The configuration file for the sidebar is located at "),t("code",[e._v("/docs/src/.vuepress/theme/configs/default_sidebar_config.js")])]),e._v(" "),t("p",[e._v("To add a new item to the sidebar, simply choose where you want the item to appear, and insert an object with the following format:")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v('{\ntitle: "Text you want to display",\npath: "Filepath to new file"\n}\n')])])]),t("p",[e._v("The sidebar, when rendered, will find all the H2 tags (##) in the file, and automatically display them as sub-headers in the sidebar, which work as links to that specific section of the page.")]),e._v(" "),t("p",[e._v("You can also make a sidebar item into an expandable menu by adding a children attribute, which will be an array of objects similar to the parent:")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v('{\ntitle: "Label",\nchildren: [\n {\n title: "First Subtext",\n path: "Filepath to file"\n },\n {\n title: "Second Subtext",\n path: "Filepath to second file"\n }\n ]\n}\n')])])]),t("p",[e._v("Children can be nested for several layers if desired.")]),e._v(" "),t("p",[e._v("Below is the current sidebar configuration to serve as an example:")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v('module.exports = [\n {\n title: "Welcome",\n path: "/",\n },\n {\n title: "Network Overview",\n children: [\n {\n title: "Introduction",\n path: "/introduction",\n },\n {\n title: "Arweave and the Permaweb",\n path: "/arweave",\n },\n {\n title: "The IO Token",\n path: "/token.md",\n },\n {\n title: "Gateway Architecture",\n path: "/gateways/gateways",\n },\n {\n title: "Network Protocols",\n path: "/network-protocols"\n },\n {\n title: "Arweave name System (ArNS)",\n path: "/arns.md",\n },\n ],\n },\n {\n title: "Gateway Operators",\n children: [\n {\n title: "Getting Started",\n children: [\n {\n title: "Overview",\n path: "/gateways/ar-io-node/overview"\n },\n {\n title: "Setting up on Windows",\n path: "/gateways/ar-io-node/windows-setup",\n },\n {\n title: "Setting up on Linux",\n path: "/gateways/ar-io-node/linux-setup",\n },\n {\n title: "Join the Network",\n path: "/gateways/ar-io-node/testnet"\n },\n {\n title: "Upgrading",\n path: "/gateways/ar-io-node/upgrading"\n }\n\n ],\n },\n {\n title: "Advanced Configurations",\n path: "/gateways/ar-io-node/advanced-config"\n },\n {\n title: "AR.IO HTTP API",\n path: "/gateways/ar-io-node/api",\n },\n {\n title: "AR.IO Admin API",\n path: "/gateways/ar-io-node/admin/admin-api"\n }\n ],\n },\n {\n title: "Ecosystem and Community",\n children: [\n {\n title: "AR.IO Foundation",\n path: "/foundation",\n },\n {\n title: "AR.IO Labs",\n path: "/labs",\n },\n {\n title: "Community Resources",\n path: "/community-resources",\n },\n ],\n },\n {\n title: "Glossary",\n path: "/glossary",\n },\n];\n')])])]),t("h2",{attrs:{id:"development-and-deployment"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#development-and-deployment"}},[e._v("#")]),e._v(" Development and Deployment")]),e._v(" "),t("h3",{attrs:{id:"launching-development-server"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#launching-development-server"}},[e._v("#")]),e._v(" Launching Development Server")]),e._v(" "),t("p",[e._v("From inside the "),t("code",[e._v("docsGenerator/docs")]),e._v(" directory in your terminal, you can launch a development server in order to preview your edits. This will automatically update as you are making edits, but if some changes do not immediately appear you can shut the server down and restart it for a hard refresh:")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("yarn dev\n")])])]),t("p",[e._v("The development server will, by default, launch at localhost:8080. The server can be shut down with "),t("code",[e._v("ctrl+c")]),e._v(" or by killing the terminal used to start it.")]),e._v(" "),t("p",[e._v("The most common error when attempting to launch the development server comes from not having a compatible version of Nodejs. If you get an error, try switching to Node version 16.15.1")]),e._v(" "),t("h3",{attrs:{id:"building-static-files"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#building-static-files"}},[e._v("#")]),e._v(" Building Static Files")]),e._v(" "),t("p",[e._v("The Vuepress docs portal is nested inside a static html website. For ease of deployment, Vuepress can build the docs portal into static html files and place them in the docs/ folder in the root of the website. This is not necessary for submitting a pr, but it may be useful for local testing. You can do this by navigating your terminal inside the docs portal Vuepress app "),t("code",[e._v("docsGenerator/docs")]),e._v(" and running the command:")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("yarn build\n")])])]),t("h3",{attrs:{id:"creating-your-pull-request"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#creating-your-pull-request"}},[e._v("#")]),e._v(" Creating Your Pull Request")]),e._v(" "),t("p",[e._v("Once you have all of your local changes committed and synced to your github account, you can create a Pull Request and have the team review the changes for integration into the public site.")]),e._v(" "),t("ol",[t("li",[t("p",[e._v("Ensure that all of your changes are committed to your own repository. All commits should follow the "),t("a",{attrs:{href:"https://www.conventionalcommits.org/en/v1.0.0/#summary",target:"_blank",rel:"noopener noreferrer"}},[e._v("Conventional Commits"),t("OutboundLink")],1),e._v(" standards.")])]),e._v(" "),t("li",[t("p",[e._v("Navigate to your forked repository's page on GitHub.")])]),e._v(" "),t("li",[t("p",[e._v("Switch to the branch you created for your changes.")])]),e._v(" "),t("li",[t("p",[e._v('You should see a banner indicating that you recently pushed a new branch. Click on the "Compare & pull request" button on that banner.')])]),e._v(" "),t("li",[t("p",[e._v('Make sure the base repository is set to the original AR.IO repository and the base branch is set to "staging".')])]),e._v(" "),t("li",[t("p",[e._v("Provide a brief description of your changes in the pull request form. Ensure your title adheres to the "),t("a",{attrs:{href:"https://www.conventionalcommits.org/en/v1.0.0/#summary",target:"_blank",rel:"noopener noreferrer"}},[e._v("Conventional Commits"),t("OutboundLink")],1),e._v(" standards.")])]),e._v(" "),t("li",[t("p",[e._v("Review the changes and confirm they appear as expected.")])]),e._v(" "),t("li",[t("p",[e._v('Once you\'re ready, click on the "Create pull request" button. The AR.IO team will review the request and, if approved, merge your changes into the staging branch of the repository. The changes will later be merged into the main branch for production deployment.')])])])])}),[],!1,null,null,null);t.default=r.exports}}]); \ No newline at end of file diff --git a/assets/js/34.49c73000.js b/assets/js/34.2a17dc91.js similarity index 99% rename from assets/js/34.49c73000.js rename to assets/js/34.2a17dc91.js index c5cf6f6c..a5da5cc7 100644 --- a/assets/js/34.49c73000.js +++ b/assets/js/34.2a17dc91.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[34],{334:function(t,a,e){"use strict";e.r(a);var s=e(10),r=Object(s.a)({},(function(){var t=this,a=t._self._c;return a("ContentSlotsDistributor",{attrs:{"slot-key":t.$parent.slotKey}},[a("h1",{attrs:{id:"ao-ant"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#ao-ant"}},[t._v("#")]),t._v(" AO ANT")]),t._v(" "),a("h2",{attrs:{id:"overview"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#overview"}},[t._v("#")]),t._v(" Overview")]),t._v(" "),a("p",[t._v("Arweave Name Tokens, or ANTs, are the aoComputer contracts that control each ArNS name. You can easily set up an ao process to function as an ANT by loading the "),a("code",[t._v("ant.lua")]),t._v(" file from the "),a("a",{attrs:{href:"https://github.com/ar-io/ao-pilot",target:"_blank",rel:"noopener noreferrer"}},[t._v("ao-pilot"),a("OutboundLink")],1),t._v(" github repository into your process.")]),t._v(" "),a("h2",{attrs:{id:"installation"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#installation"}},[t._v("#")]),t._v(" Installation")]),t._v(" "),a("p",[t._v("The ao ANT code is a single file within the "),a("a",{attrs:{href:"https://github.com/ar-io/ao-pilot",target:"_blank",rel:"noopener noreferrer"}},[t._v("ao-pilot"),a("OutboundLink")],1),t._v(" Github repository from ar.io. The specific file is located "),a("a",{attrs:{href:"https://github.com/ar-io/ao-pilot/blob/main/src/ant.lua",target:"_blank",rel:"noopener noreferrer"}},[t._v("here"),a("OutboundLink")],1),t._v(".")]),t._v(" "),a("p",[t._v("You can install the ao-pilot repo on your computer with")]),t._v(" "),a("p",[a("code",[t._v("git clone https://github.com/ar-io/ao-pilot")])]),t._v(" "),a("p",[t._v("Navigating the file system inside of ao is not as straightforward as it is in a regular terminal, so opening ao directly in the same folder as the file you are going to load can make things significantly easier.")]),t._v(" "),a("div",{staticClass:"language- extra-class"},[a("pre",{pre:!0,attrs:{class:"language-text"}},[a("code",[t._v("cd ao-pilot/src\naos\n")])])]),a("p",[t._v("From here, simply load the arns-resolver file into your process.")]),t._v(" "),a("p",[a("code",[t._v(".load ant.lua")])]),t._v(" "),a("p",[t._v('If things work successfully, your aos terminal will print "undefined".')]),t._v(" "),a("h2",{attrs:{id:"usage"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#usage"}},[t._v("#")]),t._v(" Usage")]),t._v(" "),a("p",[t._v("Simply loading the script into your process will set variables and handlers to make your process conform to the ant standard, but you will still need to send an initiate request to add your ANT into the ao registry.")]),t._v(" "),a("h3",{attrs:{id:"set-controller"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#set-controller"}},[t._v("#")]),t._v(" Set Controller")]),t._v(" "),a("p",[t._v("Only authorized people can make updates to your ArNS name. Because of this, you will need to add your process ID as a 'controller' under your ArNS name at "),a("a",{attrs:{href:"https://arns.app",target:"_blank",rel:"noopener noreferrer"}},[t._v("arns.app"),a("OutboundLink")],1),t._v(". This will give your process permissions needed to make these updates")]),t._v(" "),a("h3",{attrs:{id:"initiate-record-sync-and-update"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#initiate-record-sync-and-update"}},[t._v("#")]),t._v(" Initiate Record Sync and Update")]),t._v(" "),a("p",[t._v("When you purchase an ArNS name on arns.app, that name is not automatically synced to the ao-ArNS registry. Anyone can initiate a sync, which loads the data of an ArNS name from the aoComputer contract into the ao-ArNS registry:")]),t._v(" "),a("div",{staticClass:"language-shell extra-class"},[a("pre",{pre:!0,attrs:{class:"language-shell"}},[a("code",[t._v("Send"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v(" Target "),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"TyduW6spZTr3gkdIsdktduJhgtilaR_ex5JukK8gI9o"')]),t._v(", Tags "),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v(" Action "),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"Initiate-Record-Sync"')]),t._v(", Name "),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('""')]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n")])])]),a("p",[t._v("Be sure to replace "),a("code",[t._v("")]),t._v(" with the correct ArNS name.")]),t._v(" "),a("p",[t._v("Once your process is a controller, and you have loaded the ANT script, you can initiate an update to the ao-ArNS registry by running the following command:")]),t._v(" "),a("div",{staticClass:"language-shell extra-class"},[a("pre",{pre:!0,attrs:{class:"language-shell"}},[a("code",[t._v("Send"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v(" Target "),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" ARNS_PROCESS_ID, Tags "),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v(" Action "),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"Initiate-Record-Update"')]),t._v(", Name "),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('""')]),t._v(", ProcessId "),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" ao.id "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n")])])]),a("p",[t._v("Make sure to change "),a("code",[t._v(""')]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n")])])]),a("p",[t._v("Be sure to replace "),a("code",[t._v("")]),t._v(" with the correct ArNS name.")]),t._v(" "),a("p",[t._v("Once your process is a controller, and you have loaded the ANT script, you can initiate an update to the ao-ArNS registry by running the following command:")]),t._v(" "),a("div",{staticClass:"language-shell extra-class"},[a("pre",{pre:!0,attrs:{class:"language-shell"}},[a("code",[t._v("Send"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v(" Target "),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" ARNS_PROCESS_ID, Tags "),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v(" Action "),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"Initiate-Record-Update"')]),t._v(", Name "),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('""')]),t._v(", ProcessId "),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" ao.id "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n")])])]),a("p",[t._v("Make sure to change "),a("code",[t._v("/api-docs")]),e._v(", you can enter your "),t("code",[e._v("ADMIN_API_KEY")]),e._v(' using the green "Authorize" button near the top of the page, or by clicking any of the open lock icons next to a password protected end point.')]),e._v(" "),t("h2",{attrs:{id:"debug"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#debug"}},[e._v("#")]),e._v(" Debug")]),e._v(" "),t("p",[e._v("The "),t("code",[e._v("ar-io/admin/debug")]),e._v(" endpoint provides a comprehensive view of the current state of your Gateway. This endpoint has been designed to offer developers and administrators insights into the operational status of the gateway, including any errors or warnings that have occurred since the last startup.")]),e._v(" "),t("details",[t("summary",[e._v("Example response")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("{\n db: {\n counts: {\n wallets: 137,\n tagNames: 61,\n tagValues: 892,\n stableTxs: 0,\n stableBlocks: 0,\n stableBlockTxs: 0,\n missingStableBlocks: 0,\n missingStableTxs: 0,\n missingTxs: 0,\n newBlocks: 32,\n newTxs: 4436,\n bundleCount: 159,\n bundleDataItems: 0,\n matcheDataItems: 0,\n dataItems: 0,\n nestedDataItems: null\n },\n heights: { minStable: -1, maxStable: -1, minNew: 1000000, maxNew: 1000031 },\n timestamps: {\n now: 1692230403,\n maxBundleQueuedAt: -1,\n maxBundleSkippedAt: 1692230390,\n maxBundleUnbundledAt: -1,\n maxBundleFullyIndexedAt: -1,\n maxNewDataItemIndexedAt: -1,\n maxStableDataItemIndexedAt: -1\n },\n errors: [],\n warnings: []\n }\n}\n")])])])]),e._v(" "),t("h2",{attrs:{id:"queue-transaction"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#queue-transaction"}},[e._v("#")]),e._v(" Queue Transaction")]),e._v(" "),t("p",[e._v("The "),t("code",[e._v("ar-io/admin/queue-tx")]),e._v(" endpoint allows you to prioritize processing of a specific transaction, based on that transaction's ID. The "),t("code",[e._v("id")]),e._v(" key must be set in the body of your request, and a POST request should be used.")]),e._v(" "),t("p",[e._v("This endpoint will also enable you to prioritize opening and indexing bundles by providing the L1 TX ID for the bundle, but only if your Gateway is operating with the "),t("code",[e._v("ANS104_UNBUNDLE_FILTER")]),e._v(" and "),t("code",[e._v("ANS104_INDEX_FILTER")]),e._v(" keys set.")]),e._v(" "),t("p",[e._v("Your Gateway will either respond with an error, or "),t("code",[e._v("{ message: 'TX queued' }")])]),e._v(" "),t("h2",{attrs:{id:"block-data"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#block-data"}},[e._v("#")]),e._v(" Block Data")]),e._v(" "),t("p",[e._v("The "),t("code",[e._v("ar-io/admin/block-data")]),e._v(" endpoint allows you to tell your Gateway to refuse to serve certain data. In order to add to this block list, make a PUT request to this endpoint with the following in the body:")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v('{\n "id": "",\n "notes": "Example notes",\n "source": "Example source"\n}\n')])])]),t("ul",[t("li",[t("strong",[e._v("id")]),e._v(": This should be the transaction id of the content you want to block.")]),e._v(" "),t("li",[t("strong",[e._v("notes")]),e._v(": Notes regarding the reason this content was blocked. For documentation purposes only.")]),e._v(" "),t("li",[t("strong",[e._v("source")]),e._v(": Identifier for the source of TX IDs you are blocking. For example, the name of a public block list. For documentation purposes only.")])]),e._v(" "),t("p",[e._v("Your Gateway will either respond with an error, or "),t("code",[e._v("{ message: 'Content blocked' }")])])])}),[],!1,null,null,null);t.default=o.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[38],{340:function(e,t,a){"use strict";a.r(t);var n=a(10),o=Object(n.a)({},(function(){var e=this,t=e._self._c;return t("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[t("h1",{attrs:{id:"ar-io-http-api-admin-endpoints"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#ar-io-http-api-admin-endpoints"}},[e._v("#")]),e._v(" AR.IO HTTP API Admin Endpoints")]),e._v(" "),t("h2",{attrs:{id:"overview"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#overview"}},[e._v("#")]),e._v(" Overview")]),e._v(" "),t("p",[e._v("The AR.IO HTTP API offers several endpoints that allow access to internal information and the ability to make adjustments without restarting your Gateway. Each of these endpoints behind "),t("code",[e._v("/ar-io/admin/")]),e._v(" have access restricted, so you will need to have set up your "),t("code",[e._v("ADMIN_API_KEY")]),e._v(" variable and include "),t("code",[e._v('"Authorization: "Bearer ${ADMIN_API_KEY}"')]),e._v(" in the header of your request.")]),e._v(" "),t("p",[e._v("When testing endpoints at "),t("code",[e._v("/api-docs")]),e._v(", you can enter your "),t("code",[e._v("ADMIN_API_KEY")]),e._v(' using the green "Authorize" button near the top of the page, or by clicking any of the open lock icons next to a password protected end point.')]),e._v(" "),t("h2",{attrs:{id:"debug"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#debug"}},[e._v("#")]),e._v(" Debug")]),e._v(" "),t("p",[e._v("The "),t("code",[e._v("ar-io/admin/debug")]),e._v(" endpoint provides a comprehensive view of the current state of your Gateway. This endpoint has been designed to offer developers and administrators insights into the operational status of the gateway, including any errors or warnings that have occurred since the last startup.")]),e._v(" "),t("details",[t("summary",[e._v("Example response")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("{\n db: {\n counts: {\n wallets: 137,\n tagNames: 61,\n tagValues: 892,\n stableTxs: 0,\n stableBlocks: 0,\n stableBlockTxs: 0,\n missingStableBlocks: 0,\n missingStableTxs: 0,\n missingTxs: 0,\n newBlocks: 32,\n newTxs: 4436,\n bundleCount: 159,\n bundleDataItems: 0,\n matcheDataItems: 0,\n dataItems: 0,\n nestedDataItems: null\n },\n heights: { minStable: -1, maxStable: -1, minNew: 1000000, maxNew: 1000031 },\n timestamps: {\n now: 1692230403,\n maxBundleQueuedAt: -1,\n maxBundleSkippedAt: 1692230390,\n maxBundleUnbundledAt: -1,\n maxBundleFullyIndexedAt: -1,\n maxNewDataItemIndexedAt: -1,\n maxStableDataItemIndexedAt: -1\n },\n errors: [],\n warnings: []\n }\n}\n")])])])]),e._v(" "),t("h2",{attrs:{id:"queue-transaction"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#queue-transaction"}},[e._v("#")]),e._v(" Queue Transaction")]),e._v(" "),t("p",[e._v("The "),t("code",[e._v("ar-io/admin/queue-tx")]),e._v(" endpoint allows you to prioritize processing of a specific transaction, based on that transaction's ID. The "),t("code",[e._v("id")]),e._v(" key must be set in the body of your request, and a POST request should be used.")]),e._v(" "),t("p",[e._v("This endpoint will also enable you to prioritize opening and indexing bundles by providing the L1 TX ID for the bundle, but only if your Gateway is operating with the "),t("code",[e._v("ANS104_UNBUNDLE_FILTER")]),e._v(" and "),t("code",[e._v("ANS104_INDEX_FILTER")]),e._v(" keys set.")]),e._v(" "),t("p",[e._v("Your Gateway will either respond with an error, or "),t("code",[e._v("{ message: 'TX queued' }")])]),e._v(" "),t("h2",{attrs:{id:"block-data"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#block-data"}},[e._v("#")]),e._v(" Block Data")]),e._v(" "),t("p",[e._v("The "),t("code",[e._v("ar-io/admin/block-data")]),e._v(" endpoint allows you to tell your Gateway to refuse to serve certain data. In order to add to this block list, make a PUT request to this endpoint with the following in the body:")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v('{\n "id": "",\n "notes": "Example notes",\n "source": "Example source"\n}\n')])])]),t("ul",[t("li",[t("strong",[e._v("id")]),e._v(": This should be the transaction id of the content you want to block.")]),e._v(" "),t("li",[t("strong",[e._v("notes")]),e._v(": Notes regarding the reason this content was blocked. For documentation purposes only.")]),e._v(" "),t("li",[t("strong",[e._v("source")]),e._v(": Identifier for the source of TX IDs you are blocking. For example, the name of a public block list. For documentation purposes only.")])]),e._v(" "),t("p",[e._v("Your Gateway will either respond with an error, or "),t("code",[e._v("{ message: 'Content blocked' }")])])])}),[],!1,null,null,null);t.default=o.exports}}]); \ No newline at end of file diff --git a/assets/js/39.a7000d72.js b/assets/js/39.705353f4.js similarity index 99% rename from assets/js/39.a7000d72.js rename to assets/js/39.705353f4.js index 16138375..3949e225 100644 --- a/assets/js/39.a7000d72.js +++ b/assets/js/39.705353f4.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[39],{346:function(t,a,e){"use strict";e.r(a);var s=e(10),r=Object(s.a)({},(function(){var t=this,a=t._self._c;return a("ContentSlotsDistributor",{attrs:{"slot-key":t.$parent.slotKey}},[a("h1",{attrs:{id:"advanced-configuration"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#advanced-configuration"}},[t._v("#")]),t._v(" Advanced Configuration")]),t._v(" "),a("h2",{attrs:{id:"overview"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#overview"}},[t._v("#")]),t._v(" Overview")]),t._v(" "),a("p",[t._v("The Getting Started guides for "),a("RouterLink",{attrs:{to:"/gateways/ar-io-node/windows-setup.html"}},[t._v("windows")]),t._v(" and "),a("RouterLink",{attrs:{to:"/gateways/ar-io-node/linux-setup.html"}},[t._v("linux")]),t._v(" contain all the information needed to start your ar.io Gateway node successfully with basic configurations. There are also ever expanding advanced configuration options that allow you to run your node in a way that is customized to your specific use case.")],1),t._v(" "),a("p",[t._v("Most of the below options can be added to your "),a("code",[t._v(".env")]),t._v(" file in order to customize its operation. Any changes made to your "),a("code",[t._v(".env")]),t._v(" require you to stop the docker containers running your node, and restarting them with the "),a("code",[t._v("--build")]),t._v(" flag in order for the changes to take effect. See "),a("RouterLink",{attrs:{to:"/gateways/ar-io-node/env.html"}},[t._v("ENV")]),t._v(" for a complete list of environmental variables you can set.")],1),t._v(" "),a("h2",{attrs:{id:"data-storage-location"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#data-storage-location"}},[t._v("#")]),t._v(" Data Storage Location")]),t._v(" "),a("p",[t._v('You can set a custom location for your AR.IO Gateway to save the data it pulls from the Arweave network. There are three primary types of data stored, and you can set a unique storage location for each of these independently. These are "chunks data", "contiguous data", and "headers data". The custom location for each of these can be set in your .env file like this:')]),t._v(" "),a("div",{staticClass:"language-js extra-class"},[a("pre",{pre:!0,attrs:{class:"language-js"}},[a("code",[a("span",{pre:!0,attrs:{class:"token constant"}},[t._v("CHUNKS_DATA_PATH")]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("<")]),t._v("file path"),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(">")]),t._v("\n"),a("span",{pre:!0,attrs:{class:"token constant"}},[t._v("CONTIGUOUS_DATA_PATH")]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("<")]),t._v("file path"),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(">")]),t._v("\n"),a("span",{pre:!0,attrs:{class:"token constant"}},[t._v("HEADERS_DATA_PATH")]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("<")]),t._v("file path"),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(">")]),t._v("\n")])])]),a("p",[t._v('Be sure to replace "" with the path to the location where you would like the data stored. If these values are omitted, the data will be stored in the "data" directory inside your Gateway code repository.')]),t._v(" "),a("h2",{attrs:{id:"admin-api-key"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#admin-api-key"}},[t._v("#")]),t._v(" Admin API Key")]),t._v(" "),a("p",[t._v('HTTP endpoints under "/ar-io/admin" are protected by an admin API key. These endpoints allow you to get certain analytics data or make adjustments to your node as it\'s running. When your node starts, it reads your environmental variables to see if a key is set. If not, a random key is generated. The key name is '),a("code",[t._v("ADMIN_API_KEY")]),t._v(" and it should be set in your "),a("code",[t._v(".env")]),t._v(" file like this:")]),t._v(" "),a("div",{staticClass:"language-js extra-class"},[a("pre",{pre:!0,attrs:{class:"language-js"}},[a("code",[a("span",{pre:!0,attrs:{class:"token constant"}},[t._v("ADMIN_API_KEY")]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),a("span",{pre:!0,attrs:{class:"token constant"}},[t._v("SUPER_SECRET_PASSWORD")]),t._v("\n")])])]),a("p",[t._v("View examples of the admin endpoints "),a("RouterLink",{attrs:{to:"/gateways/ar-io-node/admin/admin-api.html"}},[t._v("here")])],1),t._v(" "),a("h2",{attrs:{id:"wallet-association"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#wallet-association"}},[t._v("#")]),t._v(" Wallet Association")]),t._v(" "),a("p",[t._v("In order to participate in the greater "),a("a",{attrs:{href:"https://ar.io",target:"_blank",rel:"noopener noreferrer"}},[t._v("ar.io network"),a("OutboundLink")],1),t._v(", Gateway nodes need to associate themselves with an Arweave wallet. This can be configured by setting the "),a("code",[t._v("AR_IO_WALLET")]),t._v(" key value in your "),a("code",[t._v(".env")]),t._v(" file.")]),t._v(" "),a("div",{staticClass:"language-js extra-class"},[a("pre",{pre:!0,attrs:{class:"language-js"}},[a("code",[a("span",{pre:!0,attrs:{class:"token constant"}},[t._v("AR_IO_WALLET")]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v("1seRanklLU_1VTGowDZdD7s_"),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("-")]),t._v("7k1qowT6oeFZHUZiZo\n")])])]),a("h2",{attrs:{id:"unbundling"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#unbundling"}},[t._v("#")]),t._v(" Unbundling")]),t._v(" "),a("p",[t._v("AR.IO Gateway nodes support unbundling and indexing "),a("a",{attrs:{href:"https://github.com/ArweaveTeam/arweave-standards/blob/master/ans/ANS-104.md",target:"_blank",rel:"noopener noreferrer"}},[t._v("ANS-104"),a("OutboundLink")],1),t._v(" bundle data. This is disabled by default, but can be turned on with several different configuration options. You can set these configurations with the "),a("code",[t._v("ANS104_UNBUNDLE_FILTER")]),t._v(" and "),a("code",[t._v("ANS104_INDEX_FILTER")]),t._v(" keys in your .env:")]),t._v(" "),a("div",{staticClass:"language-js extra-class"},[a("pre",{pre:!0,attrs:{class:"language-js"}},[a("code",[a("span",{pre:!0,attrs:{class:"token constant"}},[t._v("ANS104_UNBUNDLE_FILTER")]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('""')]),t._v("\n"),a("span",{pre:!0,attrs:{class:"token constant"}},[t._v("ANS104_INDEX_FILTER")]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('""')]),t._v("\n")])])]),a("p",[t._v("The following types of filters are supported:")]),t._v(" "),a("div",{staticClass:"language-js extra-class"},[a("pre",{pre:!0,attrs:{class:"language-js"}},[a("code",[a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string-property property"}},[t._v('"never"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token boolean"}},[t._v("true")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),t._v(" # the "),a("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("default")]),t._v("\n"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string-property property"}},[t._v('"always"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token boolean"}},[t._v("true")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),t._v("\n"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string-property property"}},[t._v('"attributes"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string-property property"}},[t._v('"owner"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("<")]),t._v("owner key"),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(">")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("...")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),t._v("\n"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string-property property"}},[t._v('"tags"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("[")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string-property property"}},[t._v('"name"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("<")]),t._v("utf8 tag name"),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(">")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string-property property"}},[t._v('"value"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("<")]),t._v("utf8 tag value"),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(">")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("...")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("]")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),t._v("\n"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string-property property"}},[t._v('"and"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("[")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("<")]),t._v("nested filter"),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(">")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("...")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("]")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),t._v("\n"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string-property property"}},[t._v('"or"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("[")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("<")]),t._v("nested filter"),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(">")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("...")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("]")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),t._v("\n")])])]),a("h2",{attrs:{id:"content-moderation"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#content-moderation"}},[t._v("#")]),t._v(" Content Moderation")]),t._v(" "),a("p",[t._v("You are able to set your Gateway to block specific transactions or data-items you don't want to serve. Unlike previous configuration options in this list, blocking content can be achieved without the need to add to your .env file and rebuild your Gateway. Instead, make a "),a("code",[t._v("PUT")]),t._v(" request to your Gateway at "),a("code",[t._v("/ar-io/admin/block-data")]),t._v(". As this is an admin endpoint, you will need to have configured your "),a("code",[t._v("ADMIN_API_KEY")]),t._v(". Using curl as an example, the request should be formatted as follows:")]),t._v(" "),a("div",{staticClass:"language-bash extra-class"},[a("pre",{pre:!0,attrs:{class:"language-bash"}},[a("code",[a("span",{pre:!0,attrs:{class:"token function"}},[t._v("curl")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token parameter variable"}},[t._v("-X")]),t._v(" PUT "),a("span",{pre:!0,attrs:{class:"token parameter variable"}},[t._v("-H")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"Authorization: Bearer "')]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("\\")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token parameter variable"}},[t._v("-H")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"Content-Type: application/json"')]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("\\")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"http://:/ar-io/admin/block-data"')]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("\\")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token parameter variable"}},[t._v("-d")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('\'{ "id": "", "notes": "Example notes", "source": "Example source" }\'')]),t._v("\n")])])]),a("ul",[a("li",[a("strong",[t._v("id")]),t._v(" (string): This will be the transaction ID of the content you want to add to your block list.")]),t._v(" "),a("li",[a("strong",[t._v("notes")]),t._v(" (string): Internal notes regarding why a particular ID is blocked.")]),t._v(" "),a("li",[a("strong",[t._v("source")]),t._v(" (string): Identifier of a particular source of IDs to block. (e.g. the name of a block list)")])]),t._v(" "),a("p",[a("code",[t._v("notes")]),t._v(" and "),a("code",[t._v("source")]),t._v(" are used for documentation only, and have no effect on your block list itself.")]),t._v(" "),a("h2",{attrs:{id:"contiguous-data-cleanup"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#contiguous-data-cleanup"}},[t._v("#")]),t._v(" Contiguous Data Cleanup")]),t._v(" "),a("p",[t._v("Transaction data on Arweave is stored in a chunked manner. It is commonly retrieved, however, in the the transaction data's original, contiguous form with all of its component chunks assembled end-to-end. Gateways cache contiguous representations of the transaction data to assist in various workloads, including serving transaction data to clients, allowing for efficient utilization of valuable system resources. Gateway operators will need to determine for themselves the best balance between disk space and other resource usage based on the size of their gateway and their particular use case.")]),t._v(" "),a("p",[t._v("Contiguous data cache cleanup can be enabled using the "),a("code",[t._v("CONTIGUOUS_DATA_CACHE_CLEANUP_THRESHOLD")]),t._v(" environmental variable. This variable sets the number of seconds from the creation of a file in the contiguous data cache after which that file will be deleted. For example:")]),t._v(" "),a("div",{staticClass:"language-js extra-class"},[a("pre",{pre:!0,attrs:{class:"language-js"}},[a("code",[a("span",{pre:!0,attrs:{class:"token constant"}},[t._v("CONTIGUOUS_DATA_CACHE_CLEANUP_THRESHOLD")]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),a("span",{pre:!0,attrs:{class:"token number"}},[t._v("10000")]),t._v("\n")])])]),a("p",[t._v("will clear items from the contiguous data cache after ten thousand (10,000) seconds.")]),t._v(" "),a("h2",{attrs:{id:"arns-resolver"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#arns-resolver"}},[t._v("#")]),t._v(" ArNS Resolver")]),t._v(" "),a("p",[t._v("Gateways, by default, forward requests to resolve ArNS names to "),a("a",{attrs:{href:"https://arweave.dev",target:"_blank",rel:"noopener noreferrer"}},[t._v("arweave.dev"),a("OutboundLink")],1),t._v(". Starting with "),a("RouterLink",{attrs:{to:"/gateways/ar-io-node/release-notes.html#release-9---2024-04-10"}},[t._v("Release 9")]),t._v(" gateways can instead build and maintain their own local cache. Doing so removes external dependencies and allows faster resolution.")],1),t._v(" "),a("p",[t._v("View the code for the ArNS resolver service here: "),a("a",{attrs:{href:"https://github.com/ar-io/arns-resolver",target:"_blank",rel:"noopener noreferrer"}},[t._v("https://github.com/ar-io/arns-resolver"),a("OutboundLink")],1)]),t._v(" "),a("p",[a("strong",[t._v("NOTE")]),t._v(": The ArNS resolver is still an experimental feature. It is possible it may behave in unexpected ways when presented with rare edge case scenarios.")]),t._v(" "),a("p",[t._v("In order to enable the local ArNS resolver, three environmental variables will need to be set:")]),t._v(" "),a("div",{staticClass:"language-js extra-class"},[a("pre",{pre:!0,attrs:{class:"language-js"}},[a("code",[a("span",{pre:!0,attrs:{class:"token constant"}},[t._v("RUN_RESOLVER")]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),a("span",{pre:!0,attrs:{class:"token boolean"}},[t._v("true")]),t._v("\n"),a("span",{pre:!0,attrs:{class:"token constant"}},[t._v("TRUSTED_ARNS_RESOLVER_TYPE")]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v("resolver\n"),a("span",{pre:!0,attrs:{class:"token constant"}},[t._v("TRUSTED_ARNS_RESOLVER_URL")]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v("http"),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("/")]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("/")]),t._v("resolver"),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),a("span",{pre:!0,attrs:{class:"token number"}},[t._v("6000")]),t._v("\n")])])]),a("ul",[a("li",[a("strong",[t._v("RUN_RESOLVER")]),t._v(" is a boolean representing an on/off switch for the local resolver.")]),t._v(" "),a("li",[a("strong",[t._v("TRUSTED_ARNS_RESOLVER_TYPE")]),t._v(" sets the method the gateway uses for resolving ArNS names. Use "),a("code",[t._v("resolver")]),t._v(" for the local resolver, or "),a("code",[t._v("gateway")]),t._v(" for default functionality.")]),t._v(" "),a("li",[a("strong",[t._v("TRUSTED_ARNS_RESOLVER_URL")]),t._v(" is the url a gateway will use to request ArNS name resolution.")])])])}),[],!1,null,null,null);a.default=r.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[39],{339:function(t,a,e){"use strict";e.r(a);var s=e(10),r=Object(s.a)({},(function(){var t=this,a=t._self._c;return a("ContentSlotsDistributor",{attrs:{"slot-key":t.$parent.slotKey}},[a("h1",{attrs:{id:"advanced-configuration"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#advanced-configuration"}},[t._v("#")]),t._v(" Advanced Configuration")]),t._v(" "),a("h2",{attrs:{id:"overview"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#overview"}},[t._v("#")]),t._v(" Overview")]),t._v(" "),a("p",[t._v("The Getting Started guides for "),a("RouterLink",{attrs:{to:"/gateways/ar-io-node/windows-setup.html"}},[t._v("windows")]),t._v(" and "),a("RouterLink",{attrs:{to:"/gateways/ar-io-node/linux-setup.html"}},[t._v("linux")]),t._v(" contain all the information needed to start your ar.io Gateway node successfully with basic configurations. There are also ever expanding advanced configuration options that allow you to run your node in a way that is customized to your specific use case.")],1),t._v(" "),a("p",[t._v("Most of the below options can be added to your "),a("code",[t._v(".env")]),t._v(" file in order to customize its operation. Any changes made to your "),a("code",[t._v(".env")]),t._v(" require you to stop the docker containers running your node, and restarting them with the "),a("code",[t._v("--build")]),t._v(" flag in order for the changes to take effect. See "),a("RouterLink",{attrs:{to:"/gateways/ar-io-node/env.html"}},[t._v("ENV")]),t._v(" for a complete list of environmental variables you can set.")],1),t._v(" "),a("h2",{attrs:{id:"data-storage-location"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#data-storage-location"}},[t._v("#")]),t._v(" Data Storage Location")]),t._v(" "),a("p",[t._v('You can set a custom location for your AR.IO Gateway to save the data it pulls from the Arweave network. There are three primary types of data stored, and you can set a unique storage location for each of these independently. These are "chunks data", "contiguous data", and "headers data". The custom location for each of these can be set in your .env file like this:')]),t._v(" "),a("div",{staticClass:"language-js extra-class"},[a("pre",{pre:!0,attrs:{class:"language-js"}},[a("code",[a("span",{pre:!0,attrs:{class:"token constant"}},[t._v("CHUNKS_DATA_PATH")]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("<")]),t._v("file path"),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(">")]),t._v("\n"),a("span",{pre:!0,attrs:{class:"token constant"}},[t._v("CONTIGUOUS_DATA_PATH")]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("<")]),t._v("file path"),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(">")]),t._v("\n"),a("span",{pre:!0,attrs:{class:"token constant"}},[t._v("HEADERS_DATA_PATH")]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("<")]),t._v("file path"),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(">")]),t._v("\n")])])]),a("p",[t._v('Be sure to replace "" with the path to the location where you would like the data stored. If these values are omitted, the data will be stored in the "data" directory inside your Gateway code repository.')]),t._v(" "),a("h2",{attrs:{id:"admin-api-key"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#admin-api-key"}},[t._v("#")]),t._v(" Admin API Key")]),t._v(" "),a("p",[t._v('HTTP endpoints under "/ar-io/admin" are protected by an admin API key. These endpoints allow you to get certain analytics data or make adjustments to your node as it\'s running. When your node starts, it reads your environmental variables to see if a key is set. If not, a random key is generated. The key name is '),a("code",[t._v("ADMIN_API_KEY")]),t._v(" and it should be set in your "),a("code",[t._v(".env")]),t._v(" file like this:")]),t._v(" "),a("div",{staticClass:"language-js extra-class"},[a("pre",{pre:!0,attrs:{class:"language-js"}},[a("code",[a("span",{pre:!0,attrs:{class:"token constant"}},[t._v("ADMIN_API_KEY")]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),a("span",{pre:!0,attrs:{class:"token constant"}},[t._v("SUPER_SECRET_PASSWORD")]),t._v("\n")])])]),a("p",[t._v("View examples of the admin endpoints "),a("RouterLink",{attrs:{to:"/gateways/ar-io-node/admin/admin-api.html"}},[t._v("here")])],1),t._v(" "),a("h2",{attrs:{id:"wallet-association"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#wallet-association"}},[t._v("#")]),t._v(" Wallet Association")]),t._v(" "),a("p",[t._v("In order to participate in the greater "),a("a",{attrs:{href:"https://ar.io",target:"_blank",rel:"noopener noreferrer"}},[t._v("ar.io network"),a("OutboundLink")],1),t._v(", Gateway nodes need to associate themselves with an Arweave wallet. This can be configured by setting the "),a("code",[t._v("AR_IO_WALLET")]),t._v(" key value in your "),a("code",[t._v(".env")]),t._v(" file.")]),t._v(" "),a("div",{staticClass:"language-js extra-class"},[a("pre",{pre:!0,attrs:{class:"language-js"}},[a("code",[a("span",{pre:!0,attrs:{class:"token constant"}},[t._v("AR_IO_WALLET")]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v("1seRanklLU_1VTGowDZdD7s_"),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("-")]),t._v("7k1qowT6oeFZHUZiZo\n")])])]),a("h2",{attrs:{id:"unbundling"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#unbundling"}},[t._v("#")]),t._v(" Unbundling")]),t._v(" "),a("p",[t._v("AR.IO Gateway nodes support unbundling and indexing "),a("a",{attrs:{href:"https://github.com/ArweaveTeam/arweave-standards/blob/master/ans/ANS-104.md",target:"_blank",rel:"noopener noreferrer"}},[t._v("ANS-104"),a("OutboundLink")],1),t._v(" bundle data. This is disabled by default, but can be turned on with several different configuration options. You can set these configurations with the "),a("code",[t._v("ANS104_UNBUNDLE_FILTER")]),t._v(" and "),a("code",[t._v("ANS104_INDEX_FILTER")]),t._v(" keys in your .env:")]),t._v(" "),a("div",{staticClass:"language-js extra-class"},[a("pre",{pre:!0,attrs:{class:"language-js"}},[a("code",[a("span",{pre:!0,attrs:{class:"token constant"}},[t._v("ANS104_UNBUNDLE_FILTER")]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('""')]),t._v("\n"),a("span",{pre:!0,attrs:{class:"token constant"}},[t._v("ANS104_INDEX_FILTER")]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('""')]),t._v("\n")])])]),a("p",[t._v("The following types of filters are supported:")]),t._v(" "),a("div",{staticClass:"language-js extra-class"},[a("pre",{pre:!0,attrs:{class:"language-js"}},[a("code",[a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string-property property"}},[t._v('"never"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token boolean"}},[t._v("true")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),t._v(" # the "),a("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("default")]),t._v("\n"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string-property property"}},[t._v('"always"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token boolean"}},[t._v("true")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),t._v("\n"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string-property property"}},[t._v('"attributes"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string-property property"}},[t._v('"owner"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("<")]),t._v("owner key"),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(">")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("...")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),t._v("\n"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string-property property"}},[t._v('"tags"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("[")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string-property property"}},[t._v('"name"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("<")]),t._v("utf8 tag name"),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(">")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string-property property"}},[t._v('"value"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("<")]),t._v("utf8 tag value"),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(">")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("...")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("]")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),t._v("\n"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string-property property"}},[t._v('"and"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("[")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("<")]),t._v("nested filter"),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(">")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("...")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("]")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),t._v("\n"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("{")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string-property property"}},[t._v('"or"')]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("[")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("<")]),t._v("nested filter"),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(">")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("...")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("]")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("}")]),t._v("\n")])])]),a("h2",{attrs:{id:"content-moderation"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#content-moderation"}},[t._v("#")]),t._v(" Content Moderation")]),t._v(" "),a("p",[t._v("You are able to set your Gateway to block specific transactions or data-items you don't want to serve. Unlike previous configuration options in this list, blocking content can be achieved without the need to add to your .env file and rebuild your Gateway. Instead, make a "),a("code",[t._v("PUT")]),t._v(" request to your Gateway at "),a("code",[t._v("/ar-io/admin/block-data")]),t._v(". As this is an admin endpoint, you will need to have configured your "),a("code",[t._v("ADMIN_API_KEY")]),t._v(". Using curl as an example, the request should be formatted as follows:")]),t._v(" "),a("div",{staticClass:"language-bash extra-class"},[a("pre",{pre:!0,attrs:{class:"language-bash"}},[a("code",[a("span",{pre:!0,attrs:{class:"token function"}},[t._v("curl")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token parameter variable"}},[t._v("-X")]),t._v(" PUT "),a("span",{pre:!0,attrs:{class:"token parameter variable"}},[t._v("-H")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"Authorization: Bearer "')]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("\\")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token parameter variable"}},[t._v("-H")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"Content-Type: application/json"')]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("\\")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('"http://:/ar-io/admin/block-data"')]),t._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("\\")]),t._v("\n "),a("span",{pre:!0,attrs:{class:"token parameter variable"}},[t._v("-d")]),t._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[t._v('\'{ "id": "", "notes": "Example notes", "source": "Example source" }\'')]),t._v("\n")])])]),a("ul",[a("li",[a("strong",[t._v("id")]),t._v(" (string): This will be the transaction ID of the content you want to add to your block list.")]),t._v(" "),a("li",[a("strong",[t._v("notes")]),t._v(" (string): Internal notes regarding why a particular ID is blocked.")]),t._v(" "),a("li",[a("strong",[t._v("source")]),t._v(" (string): Identifier of a particular source of IDs to block. (e.g. the name of a block list)")])]),t._v(" "),a("p",[a("code",[t._v("notes")]),t._v(" and "),a("code",[t._v("source")]),t._v(" are used for documentation only, and have no effect on your block list itself.")]),t._v(" "),a("h2",{attrs:{id:"contiguous-data-cleanup"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#contiguous-data-cleanup"}},[t._v("#")]),t._v(" Contiguous Data Cleanup")]),t._v(" "),a("p",[t._v("Transaction data on Arweave is stored in a chunked manner. It is commonly retrieved, however, in the the transaction data's original, contiguous form with all of its component chunks assembled end-to-end. Gateways cache contiguous representations of the transaction data to assist in various workloads, including serving transaction data to clients, allowing for efficient utilization of valuable system resources. Gateway operators will need to determine for themselves the best balance between disk space and other resource usage based on the size of their gateway and their particular use case.")]),t._v(" "),a("p",[t._v("Contiguous data cache cleanup can be enabled using the "),a("code",[t._v("CONTIGUOUS_DATA_CACHE_CLEANUP_THRESHOLD")]),t._v(" environmental variable. This variable sets the number of seconds from the creation of a file in the contiguous data cache after which that file will be deleted. For example:")]),t._v(" "),a("div",{staticClass:"language-js extra-class"},[a("pre",{pre:!0,attrs:{class:"language-js"}},[a("code",[a("span",{pre:!0,attrs:{class:"token constant"}},[t._v("CONTIGUOUS_DATA_CACHE_CLEANUP_THRESHOLD")]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),a("span",{pre:!0,attrs:{class:"token number"}},[t._v("10000")]),t._v("\n")])])]),a("p",[t._v("will clear items from the contiguous data cache after ten thousand (10,000) seconds.")]),t._v(" "),a("h2",{attrs:{id:"arns-resolver"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#arns-resolver"}},[t._v("#")]),t._v(" ArNS Resolver")]),t._v(" "),a("p",[t._v("Gateways, by default, forward requests to resolve ArNS names to "),a("a",{attrs:{href:"https://arweave.dev",target:"_blank",rel:"noopener noreferrer"}},[t._v("arweave.dev"),a("OutboundLink")],1),t._v(". Starting with "),a("RouterLink",{attrs:{to:"/gateways/ar-io-node/release-notes.html#release-9---2024-04-10"}},[t._v("Release 9")]),t._v(" gateways can instead build and maintain their own local cache. Doing so removes external dependencies and allows faster resolution.")],1),t._v(" "),a("p",[t._v("View the code for the ArNS resolver service here: "),a("a",{attrs:{href:"https://github.com/ar-io/arns-resolver",target:"_blank",rel:"noopener noreferrer"}},[t._v("https://github.com/ar-io/arns-resolver"),a("OutboundLink")],1)]),t._v(" "),a("p",[a("strong",[t._v("NOTE")]),t._v(": The ArNS resolver is still an experimental feature. It is possible it may behave in unexpected ways when presented with rare edge case scenarios.")]),t._v(" "),a("p",[t._v("In order to enable the local ArNS resolver, three environmental variables will need to be set:")]),t._v(" "),a("div",{staticClass:"language-js extra-class"},[a("pre",{pre:!0,attrs:{class:"language-js"}},[a("code",[a("span",{pre:!0,attrs:{class:"token constant"}},[t._v("RUN_RESOLVER")]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),a("span",{pre:!0,attrs:{class:"token boolean"}},[t._v("true")]),t._v("\n"),a("span",{pre:!0,attrs:{class:"token constant"}},[t._v("TRUSTED_ARNS_RESOLVER_TYPE")]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v("resolver\n"),a("span",{pre:!0,attrs:{class:"token constant"}},[t._v("TRUSTED_ARNS_RESOLVER_URL")]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v("http"),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("/")]),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v("/")]),t._v("resolver"),a("span",{pre:!0,attrs:{class:"token operator"}},[t._v(":")]),a("span",{pre:!0,attrs:{class:"token number"}},[t._v("6000")]),t._v("\n")])])]),a("ul",[a("li",[a("strong",[t._v("RUN_RESOLVER")]),t._v(" is a boolean representing an on/off switch for the local resolver.")]),t._v(" "),a("li",[a("strong",[t._v("TRUSTED_ARNS_RESOLVER_TYPE")]),t._v(" sets the method the gateway uses for resolving ArNS names. Use "),a("code",[t._v("resolver")]),t._v(" for the local resolver, or "),a("code",[t._v("gateway")]),t._v(" for default functionality.")]),t._v(" "),a("li",[a("strong",[t._v("TRUSTED_ARNS_RESOLVER_URL")]),t._v(" is the url a gateway will use to request ArNS name resolution.")])])])}),[],!1,null,null,null);a.default=r.exports}}]); \ No newline at end of file diff --git a/assets/js/40.3422d9ed.js b/assets/js/40.7b598302.js similarity index 92% rename from assets/js/40.3422d9ed.js rename to assets/js/40.7b598302.js index bfae87bb..ec9ce500 100644 --- a/assets/js/40.3422d9ed.js +++ b/assets/js/40.7b598302.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[40],{340:function(t,e,o){"use strict";o.r(e);var a=o(10),n=Object(a.a)({},(function(){var t=this,e=t._self._c;return e("ContentSlotsDistributor",{attrs:{"slot-key":t.$parent.slotKey}},[e("h1",{attrs:{id:"ar-io-http-api"}},[e("a",{staticClass:"header-anchor",attrs:{href:"#ar-io-http-api"}},[t._v("#")]),t._v(" AR.IO HTTP API")]),t._v(" "),e("p",[t._v("Up to date documentation of endpoints for the AR.IO HTTP API used to access your Gateway can be found "),e("a",{attrs:{href:"https://ar-io.dev/api-docs/",target:"_blank",rel:"noopener noreferrer"}},[t._v("here"),e("OutboundLink")],1),t._v(".")]),t._v(" "),e("p",[t._v("You can also view endpoint documentation and test the endpoints against your own Gateway by going to "),e("code",[t._v("/api-docs")])])])}),[],!1,null,null,null);e.default=n.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[40],{341:function(t,e,o){"use strict";o.r(e);var a=o(10),n=Object(a.a)({},(function(){var t=this,e=t._self._c;return e("ContentSlotsDistributor",{attrs:{"slot-key":t.$parent.slotKey}},[e("h1",{attrs:{id:"ar-io-http-api"}},[e("a",{staticClass:"header-anchor",attrs:{href:"#ar-io-http-api"}},[t._v("#")]),t._v(" AR.IO HTTP API")]),t._v(" "),e("p",[t._v("Up to date documentation of endpoints for the AR.IO HTTP API used to access your Gateway can be found "),e("a",{attrs:{href:"https://ar-io.dev/api-docs/",target:"_blank",rel:"noopener noreferrer"}},[t._v("here"),e("OutboundLink")],1),t._v(".")]),t._v(" "),e("p",[t._v("You can also view endpoint documentation and test the endpoints against your own Gateway by going to "),e("code",[t._v("/api-docs")])])])}),[],!1,null,null,null);e.default=n.exports}}]); \ No newline at end of file diff --git a/assets/js/41.1b7373ab.js b/assets/js/41.663b1761.js similarity index 99% rename from assets/js/41.1b7373ab.js rename to assets/js/41.663b1761.js index 7d39fa5a..ff9c476d 100644 --- a/assets/js/41.1b7373ab.js +++ b/assets/js/41.663b1761.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[41],{341:function(e,a,t){"use strict";t.r(a);var r=t(10),s=Object(r.a)({},(function(){var e=this,a=e._self._c;return a("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[a("h1",{attrs:{id:"observation-and-incentives"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#observation-and-incentives"}},[e._v("#")]),e._v(" Observation and Incentives")]),e._v(" "),a("h2",{attrs:{id:"overview"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#overview"}},[e._v("#")]),e._v(" Overview")]),e._v(" "),a("p",[e._v('The Observation and Incentive Protocol is designed to maintain and enhance the operational integrity of gateways on the AR.IO Network. It achieves this through a combination of incentivizing gateways for good performance and tasking those gateways to fulfill the role of "observers". The protocol is intentionally simple and adaptable, employing a smart contract-based method for onchain “voting” to assess peer performance while being flexible on how that performance is measured. This setup permits gateway and observer nodes to experiment and evolve best practices for performance evaluation, all while operating within the bounds of the network\'s immutable smart contract, thus eliminating the need for frequent contract updates (forks).')]),e._v(" "),a("p",[e._v("In this protocol, observers evaluate their gateway peers' performance to resolve ArNS names. Their aim is to ensure each gateway in the network accurately resolves a subset of names and assigning a pass / fail score based on their findings.")]),e._v(" "),a("p",[e._v('A key component of the protocol is its reward mechanism. This system is predicated on gateway performance and compliance with observation duties. Gateways that excel are tagged as "Functional Gateways" and earn rewards, while those that do not meet the criteria, “Deficient Gateways” risk facing penalties – namely, the lack of rewards.')]),e._v(" "),a("p",[e._v("Funds for incentive rewards are derived from the protocol balance, which consists of IO tokens collected from ArNS asset purchases. Every epoch, this balance is utilized to distribute rewards to qualifying gateways and observers based on certain performance metrics.")]),e._v(" "),a("h2",{attrs:{id:"observation-protocol"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#observation-protocol"}},[e._v("#")]),e._v(" Observation Protocol")]),e._v(" "),a("p",[e._v("The Observation protocol is organized around epochs, periods of time that are broken into an observation reporting and tallying phase. The protocol is followed across each epoch, promoting consistent healthy network activity that can form pro-social behaviors and react to malicious circumstances.")]),e._v(" "),a("img",{staticClass:"amazingdiagram",attrs:{src:e.$withBase("/images/observer-1.png")}}),e._v(" "),a("div",{staticClass:"caption"},[e._v("Observation and Incentive Protocol")]),e._v(" "),a("ul",[a("li",[e._v("To participate in the epoch, a gateway must have already staked IO tokens and joined the network before it starts.")]),e._v(" "),a("li",[e._v("Each epoch (approximately 7 block-days), a random pool of active gateways will be selected (prescribed) to perform observation duties.")]),e._v(" "),a("li",[e._v("Within the epoch, observers are tasked with evaluating a subset of ArNS names for each gateway in the network.")]),e._v(" "),a("li",[e._v("By the end of the epoch’s observation reporting period, the observer must upload its standardized health observation report to Arweave.")]),e._v(" "),a("li",[e._v("The observer must also submit an interaction to the AR.IO contract to save its report transaction ID and a summary of all failed gateways for tallying by the incentive protocol.")]),e._v(" "),a("li",[e._v("After the observation reporting period and tallying periods have closed, the payout is performed on the next contract state tick.\n"),a("ul",[a("li",[e._v("This payout rewards gateways and observers who have performed their duties.")]),e._v(" "),a("li",[e._v("Gateways that did not meet the performance threshold will not receive rewards.")]),e._v(" "),a("li",[e._v("Observers that did not perform their duties are not rewarded and in addition, are penalized on any gateway rewards received.")])])]),e._v(" "),a("li",[e._v("Community builders and application users can verify and leverage the report and distribution information to make more informed decisions on which gateway to use.")])]),e._v(" "),a("h2",{attrs:{id:"onchain-reports"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#onchain-reports"}},[e._v("#")]),e._v(" Onchain Reports")]),e._v(" "),a("p",[e._v("The to-be-evaluated ArNS names include a set of names randomly determined by the protocol, known as “prescribed names”, which are common across all observers within the epoch, as well as a set of “chosen names” picked at the discretion of each individual observer. “Prescribed names” are assigned to act as a common denominator / baseline while “chosen names” allow each observer to evaluate names that may be important to their operation.")]),e._v(" "),a("p",[e._v("Each observer shall assess the performance of the selected ArNS names (across all gateways) and summarize those findings in a report which details the following:")]),e._v(" "),a("ul",[a("li",[a("p",[e._v("General Information: Observer's Arweave address, starting and concluding block heights for the epoch.")])]),e._v(" "),a("li",[a("p",[e._v("Gateway Operator Assessment: The expected and actual Arweave addresses of observed gateways, along with a summary verdict (pass or fail), and accompanying reasons for failure.")])]),e._v(" "),a("li",[a("p",[e._v('Detailed ArNS Evaluations: For each gateway, it includes the domain name, evaluated ArNS names, the associated block height, transaction IDs, data hashes, a "pass or fail" score, reasons for failure (if any), and performance metrics like time to the first byte.')])])]),e._v(" "),a("p",[e._v("A comprehensive list of report criteria can be found in the Appendix.")]),e._v(" "),a("p",[e._v("Observers shall upload their completed reports (in JSON format) to the Arweave network as an onchain audit trail. In addition, observers shall submit an interaction to the AR.IO smart contact detailing each gateway that they observed to have “failed” their assessments. This is tallied and used to determine the reward distribution.")]),e._v(" "),a("h2",{attrs:{id:"selection-of-observers"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#selection-of-observers"}},[e._v("#")]),e._v(" Selection of Observers")]),e._v(" "),a("p",[e._v("The observer selection process employs a random-weighted selection method. By combining random selection with weighted criteria like stake, tenure, and past rewards, the process aims to ensure both fairness and acknowledgment of consistent performance. This method allows for a systematic yet randomized approach to selecting gateways for observation tasks.")]),e._v(" "),a("h3",{attrs:{id:"criteria-for-selection"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#criteria-for-selection"}},[e._v("#")]),e._v(" Criteria for Selection")]),e._v(" "),a("p",[e._v("Up to 50 gateways can be chosen as observers per epoch. If the GAR contains 50 or fewer gateways, then every gateway is designated as an observer for that epoch. If there are greater than 50, then randomized selection shall be utilized.")]),e._v(" "),a("p",[e._v("The weighted selection criteria will consider the following for each gateway:")]),e._v(" "),a("ul",[a("li",[a("p",[e._v("Stake Weight (SW): This factor considers how financially committed a gateway is to the network. It is the ratio of the amount of IO tokens staked by the gateway relative to the network minimum and is expressed as SW = Gateway Stake / Minimum Stake.")])]),e._v(" "),a("li",[a("p",[e._v("Tenure Weight (TW): This factor considers how long a gateway has been part of the network, with a maximum value capped at 4. It is calculated as TW = Gateway Network Tenure / 6 block-months. This means that the maximum value is achieved after 2 block-years of participation in the network.")])]),e._v(" "),a("li",[a("p",[e._v("Gateway Reward Ratio Weight (GRRW): This factor is a proxy for a gateway’s performance at resolving ArNS names. The weight represents the ratio of epochs in which a gateway received rewards for correctly resolving names relative to their total time on the network.")])]),e._v(" "),a("li",[a("p",[e._v("Observer Reward Ratio Weight (ORRW): This factor is a proxy for a gateway’s performance at fulfilling observation duties. The weight reflects the ratio of epochs in which a gateway, as an observer, successfully submitted observation reports relative to their total periods of service as an observer.")])])]),e._v(" "),a("h3",{attrs:{id:"weight-calculation-and-normalization"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#weight-calculation-and-normalization"}},[e._v("#")]),e._v(" Weight Calculation and Normalization")]),e._v(" "),a("p",[e._v("For each gateway, a composite weight (CW) is computed, combining the Stake Weight, Tenure Weight, Gateway Reward Ratio Weight, and Observer Reward Ratio Weight.")]),e._v(" "),a("p",[e._v("The formula used is: "),a("code",[e._v("CW = SW x TW x GRRW x ORRW")]),e._v(".")]),e._v(" "),a("p",[e._v("These weights are then normalized across the network to create a continuous range, allowing for proportional random selection based on the weighted scores. The normalized composite weight (N_CW) for each gateway indicates its likelihood of being chosen as an observer and is calculated by dividing the gateway's CW by the sum of all CWs.")]),e._v(" "),a("h3",{attrs:{id:"random-selection-process"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#random-selection-process"}},[e._v("#")]),e._v(" Random Selection Process")]),e._v(" "),a("p",[e._v("The selection of observers is randomized within the framework of these weights. A set of unique random numbers is generated within the total range of normalized weights. For each random number, the gateway whose normalized weight range encompasses this number is selected. This system ensures that while gateways with higher weights are more likely to be chosen, all gateways maintain a non-zero chance of selection, preserving both fairness and meritocracy in the observer assignment process.")]),e._v(" "),a("h2",{attrs:{id:"performance-evaluation"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#performance-evaluation"}},[e._v("#")]),e._v(" Performance Evaluation")]),e._v(" "),a("p",[e._v("Consider the following classifications:")]),e._v(" "),a("ul",[a("li",[a("p",[a("strong",[e._v("Functional or Passed Gateways")]),e._v(": are gateways that meet or surpass the network’s performance and quality standards.")])]),e._v(" "),a("li",[a("p",[a("strong",[e._v("Deficient or Failed Gateways")]),e._v(": are gateways that fall short of the network's performance expectations.")])]),e._v(" "),a("li",[a("p",[a("strong",[e._v("Functional or Submitted Observers")]),e._v(": are selected observers who diligently perform their duties and submit observation reports and contract interactions.")])]),e._v(" "),a("li",[a("p",[a("strong",[e._v("Deficient or Failed Observers")]),e._v(": are selected observers who do not fulfill their duty of submitting observation reports and contract interactions.")])])]),e._v(" "),a("p",[e._v("At the end of an epoch, the smart contract will assess the results from the observers during a “tallying period” and determine a pass / fail score for each gateway:")]),e._v(" "),a("ul",[a("li",[a("p",[e._v("If greater than or equal to 50% of submitted observer contract interactions indicate a PASS score, then that gateway is considered Functional and eligible for gateway rewards.")])]),e._v(" "),a("li",[a("p",[e._v("Else, if greater than 50% of submitted observer contract interactions indicate a FAIL score, then that gateway is considered Deficient and ineligible for gateway rewards.")])])]),e._v(" "),a("p",[e._v("These results will determine how reward distributions are made for that epoch. Rewards shall be distributed after the epoch’s tallying period is complete.")]),e._v(" "),a("h2",{attrs:{id:"reward-distribution"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#reward-distribution"}},[e._v("#")]),e._v(" Reward Distribution")]),e._v(" "),a("p",[e._v("Each epoch, a defined portion of the protocol balance (e.g., 0.05%) is earmarked for distribution as rewards. From this allocation, two distinct reward categories are derived:")]),e._v(" "),a("ol",[a("li",[a("p",[e._v("Base Gateway Reward: This is the portion of the reward allocated to each Functional Gateway within the network and is calculated as:")]),e._v(" "),a("p",[a("code",[e._v("[Epoch Reward Allocation x 90% / Total Gateways in the Network]")])])]),e._v(" "),a("li",[a("p",[e._v("Base Observer Reward: Observers, due to their additional responsibilities, have a separate reward calculated as:")]),e._v(" "),a("p",[a("code",[e._v("[Epoch Reward Allocation x 10% / Total Selected Observers for the Epoch]")])])])]),e._v(" "),a("h3",{attrs:{id:"distribution-based-on-performance"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#distribution-based-on-performance"}},[e._v("#")]),e._v(" Distribution Based on Performance")]),e._v(" "),a("p",[e._v("The reward distribution is contingent on the performance classifications derived from the Performance Evaluation:")]),e._v(" "),a("ul",[a("li",[a("p",[e._v("Functional Gateways: Gateways that meet the performance criteria receive the Base Gateway Reward.")])]),e._v(" "),a("li",[a("p",[e._v("Deficient Gateways: Gateways falling short in performance do not receive any gateway rewards.")])]),e._v(" "),a("li",[a("p",[e._v("Functional Observers: Observers that fulfilled their duty receive the Base Observer Reward.")])]),e._v(" "),a("li",[a("p",[e._v("Deficient Observers: Observers failing to meet their responsibilities do not receive observer rewards. Furthermore, if they are also Functional Gateways, their gateway reward is reduced by 25% for that epoch as a consequence for not performing their observation duty.")])])]),e._v(" "),a("h3",{attrs:{id:"undistributed-rewards"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#undistributed-rewards"}},[e._v("#")]),e._v(" Undistributed Rewards")]),e._v(" "),a("p",[e._v("In cases where rewards are not distributed, either due to the inactivity or deficiency of gateways or observers, the allocated tokens shall remain in the protocol balance and carry forward to the next epoch. This mechanism is in place to discourage observers from frivolously marking their peers as offline in hopes of attaining a higher portion of the reward pool.")]),e._v(" "),a("h2",{attrs:{id:"handling-inactive-gateways"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#handling-inactive-gateways"}},[e._v("#")]),e._v(" Handling Inactive Gateways")]),e._v(" "),a("p",[e._v("To maintain network efficiency and reduce contract state bloat, gateways that are consistently offline, specifically for thirty (30) consecutive epochs, and thus fail to receive rewards, will be automatically removed from the Gateway Active Registry (GAR) as well as have their staked IO tokens unlocked and returned to the gateway operator.")]),e._v(" "),a("h2",{attrs:{id:"observer-report-details"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#observer-report-details"}},[e._v("#")]),e._v(" Observer Report Details")]),e._v(" "),a("p",[e._v("Each observer shall assess the performance of the selected ArNS names (across all AR.IO gateways) and summarize those findings in a report which details the following:")]),e._v(" "),a("h2",{attrs:{id:"general-information"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#general-information"}},[e._v("#")]),e._v(" General Information")]),e._v(" "),a("ul",[a("li",[e._v("The observer's Arweave address.")]),e._v(" "),a("li",[e._v("The starting block height of the epoch.")]),e._v(" "),a("li",[e._v("The block height at which the report was generated.")])]),e._v(" "),a("h2",{attrs:{id:"overall-gateway-operator-assessment"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#overall-gateway-operator-assessment"}},[e._v("#")]),e._v(" Overall Gateway Operator Assessment")]),e._v(" "),a("ul",[a("li",[e._v("Gateway FQDN.")]),e._v(" "),a("li",[e._v("The Arweave address that the observer expects to be the owner / operator of the gateway.")]),e._v(" "),a("li",[e._v("The Arweave address that the observed gateway actually reports.")]),e._v(" "),a("li",[e._v("A final “pass or fail” rollup determination for each observed gateway.")]),e._v(" "),a("li",[e._v("Failure reason (if applicable).")])]),e._v(" "),a("h2",{attrs:{id:"arns-assessments"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#arns-assessments"}},[e._v("#")]),e._v(" ArNS Assessments")]),e._v(" "),a("ul",[a("li",[e._v("Observed ArNS name (for all prescribed and chosen names).")]),e._v(" "),a("li",[e._v("The block height at which the name was assessed.")]),e._v(" "),a("li",[e._v("The expected status code.")]),e._v(" "),a("li",[e._v("The resolved status code.")]),e._v(" "),a("li",[e._v("The transaction ID that the observer expects the associated name to resolve to.")]),e._v(" "),a("li",[e._v("The transaction ID that the gateway actually resolves to.")]),e._v(" "),a("li",[e._v("The data hash that the observer expects the associated name to resolve to.")]),e._v(" "),a("li",[e._v("The data hash that the gateway actually resolves to.")]),e._v(" "),a("li",[e._v("The “pass or fail” score associated with the observed name, at the observer’s discretion.")]),e._v(" "),a("li",[e._v("Failure reason (if applicable).")]),e._v(" "),a("li",[e._v("Timing / performance information associated with the name resolution such as time to first byte and total duration.")])]),e._v(" "),a("p",[e._v("The above is repeated for the entire name pool and across each gateway in the GAR.")]),e._v(" "),a("h2",{attrs:{id:"example-observation-report"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#example-observation-report"}},[e._v("#")]),e._v(" Example Observation Report")]),e._v(" "),a("p",[a("a",{attrs:{href:"https://arweave.net/GG1YCFc7wQxKvQ1qD1lTEp2OAMBs4VzrpfdmeeLyjDI",target:"_blank",rel:"noopener noreferrer"}},[e._v("https://arweave.net/GG1YCFc7wQxKvQ1qD1lTEp2OAMBs4VzrpfdmeeLyjDI "),a("OutboundLink")],1)]),e._v(" "),a("h2",{attrs:{id:"viewing-observation-reports"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#viewing-observation-reports"}},[e._v("#")]),e._v(" Viewing Observation Reports")]),e._v(" "),a("p",[e._v("You can easily view an observation report in a human readable format through your terminal with the following command:")]),e._v(" "),a("div",{staticClass:"language-bash extra-class"},[a("pre",{pre:!0,attrs:{class:"language-bash"}},[a("code",[a("span",{pre:!0,attrs:{class:"token function"}},[e._v("curl")]),e._v(" "),a("span",{pre:!0,attrs:{class:"token parameter variable"}},[e._v("-L")]),e._v(" https://arweave.net/"),a("span",{pre:!0,attrs:{class:"token operator"}},[e._v("<")]),e._v("txId"),a("span",{pre:!0,attrs:{class:"token operator"}},[e._v(">")]),e._v(" "),a("span",{pre:!0,attrs:{class:"token operator"}},[e._v("|")]),e._v(" zcat "),a("span",{pre:!0,attrs:{class:"token operator"}},[e._v("|")]),e._v(" jq "),a("span",{pre:!0,attrs:{class:"token builtin class-name"}},[e._v(".")]),e._v("\n")])])]),a("p",[e._v("Be sure to replace "),a("code",[e._v("")]),e._v(" with the txId of the report you want to view.")]),e._v(" "),a("h3",{attrs:{id:"example"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#example"}},[e._v("#")]),e._v(" example")]),e._v(" "),a("div",{staticClass:"language-bash extra-class"},[a("pre",{pre:!0,attrs:{class:"language-bash"}},[a("code",[a("span",{pre:!0,attrs:{class:"token function"}},[e._v("curl")]),e._v(" "),a("span",{pre:!0,attrs:{class:"token parameter variable"}},[e._v("-L")]),e._v(" https://arweave.net/H3zDmoDkpOg0U95rejBEq6gUnww_CEVscTuQVqfSbxk "),a("span",{pre:!0,attrs:{class:"token operator"}},[e._v("|")]),e._v(" zcat "),a("span",{pre:!0,attrs:{class:"token operator"}},[e._v("|")]),e._v(" jq "),a("span",{pre:!0,attrs:{class:"token builtin class-name"}},[e._v(".")]),e._v("\n")])])])])}),[],!1,null,null,null);a.default=s.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[41],{343:function(e,a,t){"use strict";t.r(a);var r=t(10),s=Object(r.a)({},(function(){var e=this,a=e._self._c;return a("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[a("h1",{attrs:{id:"observation-and-incentives"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#observation-and-incentives"}},[e._v("#")]),e._v(" Observation and Incentives")]),e._v(" "),a("h2",{attrs:{id:"overview"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#overview"}},[e._v("#")]),e._v(" Overview")]),e._v(" "),a("p",[e._v('The Observation and Incentive Protocol is designed to maintain and enhance the operational integrity of gateways on the AR.IO Network. It achieves this through a combination of incentivizing gateways for good performance and tasking those gateways to fulfill the role of "observers". The protocol is intentionally simple and adaptable, employing a smart contract-based method for onchain “voting” to assess peer performance while being flexible on how that performance is measured. This setup permits gateway and observer nodes to experiment and evolve best practices for performance evaluation, all while operating within the bounds of the network\'s immutable smart contract, thus eliminating the need for frequent contract updates (forks).')]),e._v(" "),a("p",[e._v("In this protocol, observers evaluate their gateway peers' performance to resolve ArNS names. Their aim is to ensure each gateway in the network accurately resolves a subset of names and assigning a pass / fail score based on their findings.")]),e._v(" "),a("p",[e._v('A key component of the protocol is its reward mechanism. This system is predicated on gateway performance and compliance with observation duties. Gateways that excel are tagged as "Functional Gateways" and earn rewards, while those that do not meet the criteria, “Deficient Gateways” risk facing penalties – namely, the lack of rewards.')]),e._v(" "),a("p",[e._v("Funds for incentive rewards are derived from the protocol balance, which consists of IO tokens collected from ArNS asset purchases. Every epoch, this balance is utilized to distribute rewards to qualifying gateways and observers based on certain performance metrics.")]),e._v(" "),a("h2",{attrs:{id:"observation-protocol"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#observation-protocol"}},[e._v("#")]),e._v(" Observation Protocol")]),e._v(" "),a("p",[e._v("The Observation protocol is organized around epochs, periods of time that are broken into an observation reporting and tallying phase. The protocol is followed across each epoch, promoting consistent healthy network activity that can form pro-social behaviors and react to malicious circumstances.")]),e._v(" "),a("img",{staticClass:"amazingdiagram",attrs:{src:e.$withBase("/images/observer-1.png")}}),e._v(" "),a("div",{staticClass:"caption"},[e._v("Observation and Incentive Protocol")]),e._v(" "),a("ul",[a("li",[e._v("To participate in the epoch, a gateway must have already staked IO tokens and joined the network before it starts.")]),e._v(" "),a("li",[e._v("Each epoch (approximately 7 block-days), a random pool of active gateways will be selected (prescribed) to perform observation duties.")]),e._v(" "),a("li",[e._v("Within the epoch, observers are tasked with evaluating a subset of ArNS names for each gateway in the network.")]),e._v(" "),a("li",[e._v("By the end of the epoch’s observation reporting period, the observer must upload its standardized health observation report to Arweave.")]),e._v(" "),a("li",[e._v("The observer must also submit an interaction to the AR.IO contract to save its report transaction ID and a summary of all failed gateways for tallying by the incentive protocol.")]),e._v(" "),a("li",[e._v("After the observation reporting period and tallying periods have closed, the payout is performed on the next contract state tick.\n"),a("ul",[a("li",[e._v("This payout rewards gateways and observers who have performed their duties.")]),e._v(" "),a("li",[e._v("Gateways that did not meet the performance threshold will not receive rewards.")]),e._v(" "),a("li",[e._v("Observers that did not perform their duties are not rewarded and in addition, are penalized on any gateway rewards received.")])])]),e._v(" "),a("li",[e._v("Community builders and application users can verify and leverage the report and distribution information to make more informed decisions on which gateway to use.")])]),e._v(" "),a("h2",{attrs:{id:"onchain-reports"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#onchain-reports"}},[e._v("#")]),e._v(" Onchain Reports")]),e._v(" "),a("p",[e._v("The to-be-evaluated ArNS names include a set of names randomly determined by the protocol, known as “prescribed names”, which are common across all observers within the epoch, as well as a set of “chosen names” picked at the discretion of each individual observer. “Prescribed names” are assigned to act as a common denominator / baseline while “chosen names” allow each observer to evaluate names that may be important to their operation.")]),e._v(" "),a("p",[e._v("Each observer shall assess the performance of the selected ArNS names (across all gateways) and summarize those findings in a report which details the following:")]),e._v(" "),a("ul",[a("li",[a("p",[e._v("General Information: Observer's Arweave address, starting and concluding block heights for the epoch.")])]),e._v(" "),a("li",[a("p",[e._v("Gateway Operator Assessment: The expected and actual Arweave addresses of observed gateways, along with a summary verdict (pass or fail), and accompanying reasons for failure.")])]),e._v(" "),a("li",[a("p",[e._v('Detailed ArNS Evaluations: For each gateway, it includes the domain name, evaluated ArNS names, the associated block height, transaction IDs, data hashes, a "pass or fail" score, reasons for failure (if any), and performance metrics like time to the first byte.')])])]),e._v(" "),a("p",[e._v("A comprehensive list of report criteria can be found in the Appendix.")]),e._v(" "),a("p",[e._v("Observers shall upload their completed reports (in JSON format) to the Arweave network as an onchain audit trail. In addition, observers shall submit an interaction to the AR.IO smart contact detailing each gateway that they observed to have “failed” their assessments. This is tallied and used to determine the reward distribution.")]),e._v(" "),a("h2",{attrs:{id:"selection-of-observers"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#selection-of-observers"}},[e._v("#")]),e._v(" Selection of Observers")]),e._v(" "),a("p",[e._v("The observer selection process employs a random-weighted selection method. By combining random selection with weighted criteria like stake, tenure, and past rewards, the process aims to ensure both fairness and acknowledgment of consistent performance. This method allows for a systematic yet randomized approach to selecting gateways for observation tasks.")]),e._v(" "),a("h3",{attrs:{id:"criteria-for-selection"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#criteria-for-selection"}},[e._v("#")]),e._v(" Criteria for Selection")]),e._v(" "),a("p",[e._v("Up to 50 gateways can be chosen as observers per epoch. If the GAR contains 50 or fewer gateways, then every gateway is designated as an observer for that epoch. If there are greater than 50, then randomized selection shall be utilized.")]),e._v(" "),a("p",[e._v("The weighted selection criteria will consider the following for each gateway:")]),e._v(" "),a("ul",[a("li",[a("p",[e._v("Stake Weight (SW): This factor considers how financially committed a gateway is to the network. It is the ratio of the amount of IO tokens staked by the gateway relative to the network minimum and is expressed as SW = Gateway Stake / Minimum Stake.")])]),e._v(" "),a("li",[a("p",[e._v("Tenure Weight (TW): This factor considers how long a gateway has been part of the network, with a maximum value capped at 4. It is calculated as TW = Gateway Network Tenure / 6 block-months. This means that the maximum value is achieved after 2 block-years of participation in the network.")])]),e._v(" "),a("li",[a("p",[e._v("Gateway Reward Ratio Weight (GRRW): This factor is a proxy for a gateway’s performance at resolving ArNS names. The weight represents the ratio of epochs in which a gateway received rewards for correctly resolving names relative to their total time on the network.")])]),e._v(" "),a("li",[a("p",[e._v("Observer Reward Ratio Weight (ORRW): This factor is a proxy for a gateway’s performance at fulfilling observation duties. The weight reflects the ratio of epochs in which a gateway, as an observer, successfully submitted observation reports relative to their total periods of service as an observer.")])])]),e._v(" "),a("h3",{attrs:{id:"weight-calculation-and-normalization"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#weight-calculation-and-normalization"}},[e._v("#")]),e._v(" Weight Calculation and Normalization")]),e._v(" "),a("p",[e._v("For each gateway, a composite weight (CW) is computed, combining the Stake Weight, Tenure Weight, Gateway Reward Ratio Weight, and Observer Reward Ratio Weight.")]),e._v(" "),a("p",[e._v("The formula used is: "),a("code",[e._v("CW = SW x TW x GRRW x ORRW")]),e._v(".")]),e._v(" "),a("p",[e._v("These weights are then normalized across the network to create a continuous range, allowing for proportional random selection based on the weighted scores. The normalized composite weight (N_CW) for each gateway indicates its likelihood of being chosen as an observer and is calculated by dividing the gateway's CW by the sum of all CWs.")]),e._v(" "),a("h3",{attrs:{id:"random-selection-process"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#random-selection-process"}},[e._v("#")]),e._v(" Random Selection Process")]),e._v(" "),a("p",[e._v("The selection of observers is randomized within the framework of these weights. A set of unique random numbers is generated within the total range of normalized weights. For each random number, the gateway whose normalized weight range encompasses this number is selected. This system ensures that while gateways with higher weights are more likely to be chosen, all gateways maintain a non-zero chance of selection, preserving both fairness and meritocracy in the observer assignment process.")]),e._v(" "),a("h2",{attrs:{id:"performance-evaluation"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#performance-evaluation"}},[e._v("#")]),e._v(" Performance Evaluation")]),e._v(" "),a("p",[e._v("Consider the following classifications:")]),e._v(" "),a("ul",[a("li",[a("p",[a("strong",[e._v("Functional or Passed Gateways")]),e._v(": are gateways that meet or surpass the network’s performance and quality standards.")])]),e._v(" "),a("li",[a("p",[a("strong",[e._v("Deficient or Failed Gateways")]),e._v(": are gateways that fall short of the network's performance expectations.")])]),e._v(" "),a("li",[a("p",[a("strong",[e._v("Functional or Submitted Observers")]),e._v(": are selected observers who diligently perform their duties and submit observation reports and contract interactions.")])]),e._v(" "),a("li",[a("p",[a("strong",[e._v("Deficient or Failed Observers")]),e._v(": are selected observers who do not fulfill their duty of submitting observation reports and contract interactions.")])])]),e._v(" "),a("p",[e._v("At the end of an epoch, the smart contract will assess the results from the observers during a “tallying period” and determine a pass / fail score for each gateway:")]),e._v(" "),a("ul",[a("li",[a("p",[e._v("If greater than or equal to 50% of submitted observer contract interactions indicate a PASS score, then that gateway is considered Functional and eligible for gateway rewards.")])]),e._v(" "),a("li",[a("p",[e._v("Else, if greater than 50% of submitted observer contract interactions indicate a FAIL score, then that gateway is considered Deficient and ineligible for gateway rewards.")])])]),e._v(" "),a("p",[e._v("These results will determine how reward distributions are made for that epoch. Rewards shall be distributed after the epoch’s tallying period is complete.")]),e._v(" "),a("h2",{attrs:{id:"reward-distribution"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#reward-distribution"}},[e._v("#")]),e._v(" Reward Distribution")]),e._v(" "),a("p",[e._v("Each epoch, a defined portion of the protocol balance (e.g., 0.05%) is earmarked for distribution as rewards. From this allocation, two distinct reward categories are derived:")]),e._v(" "),a("ol",[a("li",[a("p",[e._v("Base Gateway Reward: This is the portion of the reward allocated to each Functional Gateway within the network and is calculated as:")]),e._v(" "),a("p",[a("code",[e._v("[Epoch Reward Allocation x 90% / Total Gateways in the Network]")])])]),e._v(" "),a("li",[a("p",[e._v("Base Observer Reward: Observers, due to their additional responsibilities, have a separate reward calculated as:")]),e._v(" "),a("p",[a("code",[e._v("[Epoch Reward Allocation x 10% / Total Selected Observers for the Epoch]")])])])]),e._v(" "),a("h3",{attrs:{id:"distribution-based-on-performance"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#distribution-based-on-performance"}},[e._v("#")]),e._v(" Distribution Based on Performance")]),e._v(" "),a("p",[e._v("The reward distribution is contingent on the performance classifications derived from the Performance Evaluation:")]),e._v(" "),a("ul",[a("li",[a("p",[e._v("Functional Gateways: Gateways that meet the performance criteria receive the Base Gateway Reward.")])]),e._v(" "),a("li",[a("p",[e._v("Deficient Gateways: Gateways falling short in performance do not receive any gateway rewards.")])]),e._v(" "),a("li",[a("p",[e._v("Functional Observers: Observers that fulfilled their duty receive the Base Observer Reward.")])]),e._v(" "),a("li",[a("p",[e._v("Deficient Observers: Observers failing to meet their responsibilities do not receive observer rewards. Furthermore, if they are also Functional Gateways, their gateway reward is reduced by 25% for that epoch as a consequence for not performing their observation duty.")])])]),e._v(" "),a("h3",{attrs:{id:"undistributed-rewards"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#undistributed-rewards"}},[e._v("#")]),e._v(" Undistributed Rewards")]),e._v(" "),a("p",[e._v("In cases where rewards are not distributed, either due to the inactivity or deficiency of gateways or observers, the allocated tokens shall remain in the protocol balance and carry forward to the next epoch. This mechanism is in place to discourage observers from frivolously marking their peers as offline in hopes of attaining a higher portion of the reward pool.")]),e._v(" "),a("h2",{attrs:{id:"handling-inactive-gateways"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#handling-inactive-gateways"}},[e._v("#")]),e._v(" Handling Inactive Gateways")]),e._v(" "),a("p",[e._v("To maintain network efficiency and reduce contract state bloat, gateways that are consistently offline, specifically for thirty (30) consecutive epochs, and thus fail to receive rewards, will be automatically removed from the Gateway Active Registry (GAR) as well as have their staked IO tokens unlocked and returned to the gateway operator.")]),e._v(" "),a("h2",{attrs:{id:"observer-report-details"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#observer-report-details"}},[e._v("#")]),e._v(" Observer Report Details")]),e._v(" "),a("p",[e._v("Each observer shall assess the performance of the selected ArNS names (across all AR.IO gateways) and summarize those findings in a report which details the following:")]),e._v(" "),a("h2",{attrs:{id:"general-information"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#general-information"}},[e._v("#")]),e._v(" General Information")]),e._v(" "),a("ul",[a("li",[e._v("The observer's Arweave address.")]),e._v(" "),a("li",[e._v("The starting block height of the epoch.")]),e._v(" "),a("li",[e._v("The block height at which the report was generated.")])]),e._v(" "),a("h2",{attrs:{id:"overall-gateway-operator-assessment"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#overall-gateway-operator-assessment"}},[e._v("#")]),e._v(" Overall Gateway Operator Assessment")]),e._v(" "),a("ul",[a("li",[e._v("Gateway FQDN.")]),e._v(" "),a("li",[e._v("The Arweave address that the observer expects to be the owner / operator of the gateway.")]),e._v(" "),a("li",[e._v("The Arweave address that the observed gateway actually reports.")]),e._v(" "),a("li",[e._v("A final “pass or fail” rollup determination for each observed gateway.")]),e._v(" "),a("li",[e._v("Failure reason (if applicable).")])]),e._v(" "),a("h2",{attrs:{id:"arns-assessments"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#arns-assessments"}},[e._v("#")]),e._v(" ArNS Assessments")]),e._v(" "),a("ul",[a("li",[e._v("Observed ArNS name (for all prescribed and chosen names).")]),e._v(" "),a("li",[e._v("The block height at which the name was assessed.")]),e._v(" "),a("li",[e._v("The expected status code.")]),e._v(" "),a("li",[e._v("The resolved status code.")]),e._v(" "),a("li",[e._v("The transaction ID that the observer expects the associated name to resolve to.")]),e._v(" "),a("li",[e._v("The transaction ID that the gateway actually resolves to.")]),e._v(" "),a("li",[e._v("The data hash that the observer expects the associated name to resolve to.")]),e._v(" "),a("li",[e._v("The data hash that the gateway actually resolves to.")]),e._v(" "),a("li",[e._v("The “pass or fail” score associated with the observed name, at the observer’s discretion.")]),e._v(" "),a("li",[e._v("Failure reason (if applicable).")]),e._v(" "),a("li",[e._v("Timing / performance information associated with the name resolution such as time to first byte and total duration.")])]),e._v(" "),a("p",[e._v("The above is repeated for the entire name pool and across each gateway in the GAR.")]),e._v(" "),a("h2",{attrs:{id:"example-observation-report"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#example-observation-report"}},[e._v("#")]),e._v(" Example Observation Report")]),e._v(" "),a("p",[a("a",{attrs:{href:"https://arweave.net/GG1YCFc7wQxKvQ1qD1lTEp2OAMBs4VzrpfdmeeLyjDI",target:"_blank",rel:"noopener noreferrer"}},[e._v("https://arweave.net/GG1YCFc7wQxKvQ1qD1lTEp2OAMBs4VzrpfdmeeLyjDI "),a("OutboundLink")],1)]),e._v(" "),a("h2",{attrs:{id:"viewing-observation-reports"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#viewing-observation-reports"}},[e._v("#")]),e._v(" Viewing Observation Reports")]),e._v(" "),a("p",[e._v("You can easily view an observation report in a human readable format through your terminal with the following command:")]),e._v(" "),a("div",{staticClass:"language-bash extra-class"},[a("pre",{pre:!0,attrs:{class:"language-bash"}},[a("code",[a("span",{pre:!0,attrs:{class:"token function"}},[e._v("curl")]),e._v(" "),a("span",{pre:!0,attrs:{class:"token parameter variable"}},[e._v("-L")]),e._v(" https://arweave.net/"),a("span",{pre:!0,attrs:{class:"token operator"}},[e._v("<")]),e._v("txId"),a("span",{pre:!0,attrs:{class:"token operator"}},[e._v(">")]),e._v(" "),a("span",{pre:!0,attrs:{class:"token operator"}},[e._v("|")]),e._v(" zcat "),a("span",{pre:!0,attrs:{class:"token operator"}},[e._v("|")]),e._v(" jq "),a("span",{pre:!0,attrs:{class:"token builtin class-name"}},[e._v(".")]),e._v("\n")])])]),a("p",[e._v("Be sure to replace "),a("code",[e._v("")]),e._v(" with the txId of the report you want to view.")]),e._v(" "),a("h3",{attrs:{id:"example"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#example"}},[e._v("#")]),e._v(" example")]),e._v(" "),a("div",{staticClass:"language-bash extra-class"},[a("pre",{pre:!0,attrs:{class:"language-bash"}},[a("code",[a("span",{pre:!0,attrs:{class:"token function"}},[e._v("curl")]),e._v(" "),a("span",{pre:!0,attrs:{class:"token parameter variable"}},[e._v("-L")]),e._v(" https://arweave.net/H3zDmoDkpOg0U95rejBEq6gUnww_CEVscTuQVqfSbxk "),a("span",{pre:!0,attrs:{class:"token operator"}},[e._v("|")]),e._v(" zcat "),a("span",{pre:!0,attrs:{class:"token operator"}},[e._v("|")]),e._v(" jq "),a("span",{pre:!0,attrs:{class:"token builtin class-name"}},[e._v(".")]),e._v("\n")])])])])}),[],!1,null,null,null);a.default=s.exports}}]); \ No newline at end of file diff --git a/assets/js/42.8bb2bf5b.js b/assets/js/42.b584eda1.js similarity index 99% rename from assets/js/42.8bb2bf5b.js rename to assets/js/42.b584eda1.js index 3aba1035..d4af24dd 100644 --- a/assets/js/42.8bb2bf5b.js +++ b/assets/js/42.b584eda1.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[42],{343:function(e,a,t){"use strict";t.r(a);var s=t(10),r=Object(s.a)({},(function(){var e=this,a=e._self._c;return a("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[a("h1",{attrs:{id:"bundler"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#bundler"}},[e._v("#")]),e._v(" Bundler")]),e._v(" "),a("h2",{attrs:{id:"overview"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#overview"}},[e._v("#")]),e._v(" Overview")]),e._v(" "),a("p",[e._v("A "),a("a",{attrs:{href:"https://github.com/ardriveapp/turbo-upload-service/",target:"_blank",rel:"noopener noreferrer"}},[e._v("Turbo ANS-104"),a("OutboundLink")],1),e._v(" data item bundler can be run alongside an ar.io gateway. This allows gateways the ability to accept data items to be submit to the Arweave blockweave.")]),e._v(" "),a("p",[e._v("The bundler service can be easily run inside Docker in the same way that the gateway is. It utilizes a separate docker compose file for configuration and deployment, which also allows for the use of a separate file for environmental variables specific to the bundler service. Additionally, the separation allows operators to spin their bundler service up or down at any time without affecting their core gateway service. Despite the use of separate docker compose files, the bundler service shares a docker network with the ar.io gateway, and so is able to directly interact with the gateway service and data.")]),e._v(" "),a("h2",{attrs:{id:"getting-started"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#getting-started"}},[e._v("#")]),e._v(" Getting Started")]),e._v(" "),a("p",[a("strong",[e._v("NOTE")]),e._v(": The bundler service relies on GraphQL indexing of recently bundled and uploaded data to manage its pipeline operations. The ar.io gateway should have its indexes synced up to Arweave's current block height before starting the bundler's service stack.")]),e._v(" "),a("h3",{attrs:{id:"environmental-variables"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#environmental-variables"}},[e._v("#")]),e._v(" Environmental Variables")]),e._v(" "),a("p",[e._v("Environmental variables must be provided for the bundler to function and integrate properly with an existing ar.io gateway. The gateway repository provides a "),a("code",[e._v(".env.bundler.example")]),e._v(" file that can be renamed to "),a("code",[e._v(".env.bundler")]),e._v(" and used as a starting point. It contains the following:")]),e._v(" "),a("div",{staticClass:"language-bash extra-class"},[a("pre",{pre:!0,attrs:{class:"language-bash"}},[a("code",[a("span",{pre:!0,attrs:{class:"token assign-left variable"}},[e._v("BUNDLER_ARWEAVE_WALLET")]),a("span",{pre:!0,attrs:{class:"token operator"}},[e._v("=")]),a("span",{pre:!0,attrs:{class:"token string"}},[e._v("'Stringified JWK wallet. e.g: '")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("{")]),e._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[e._v('"n"')]),a("span",{pre:!0,attrs:{class:"token builtin class-name"}},[e._v(":")]),e._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[e._v('"..."')]),e._v(", "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("..")]),e._v(". "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("}")]),a("span",{pre:!0,attrs:{class:"token string"}},[e._v("'\nBUNDLER_ARWEAVE_ADDRESS='")]),e._v("Address "),a("span",{pre:!0,attrs:{class:"token keyword"}},[e._v("for")]),e._v(" above wallet"),a("span",{pre:!0,attrs:{class:"token string"}},[e._v("'\n\nAPP_NAME='")]),e._v("ar.io bundler "),a("span",{pre:!0,attrs:{class:"token function"}},[e._v("service")]),a("span",{pre:!0,attrs:{class:"token string"}},[e._v("'\n\n# Use localstack s3 bucket for shared data source between ar.io gateway and bundler\nAWS_S3_BUCKET=ar.io\nAWS_S3_PREFIX='")]),e._v("data"),a("span",{pre:!0,attrs:{class:"token string"}},[e._v("'\nAWS_ACCESS_KEY_ID='")]),a("span",{pre:!0,attrs:{class:"token builtin class-name"}},[e._v("test")]),a("span",{pre:!0,attrs:{class:"token string"}},[e._v("'\nAWS_SECRET_ACCESS_KEY='")]),a("span",{pre:!0,attrs:{class:"token builtin class-name"}},[e._v("test")]),a("span",{pre:!0,attrs:{class:"token string"}},[e._v("'\nAWS_REGION='")]),e._v("us-east-1"),a("span",{pre:!0,attrs:{class:"token string"}},[e._v("'\nAWS_ENDPOINT='")]),e._v("http://localstack:4566'\n")])])]),a("ul",[a("li",[a("code",[e._v("BUNDLER_ARWEAVE_WALLET")]),e._v(" must be the entire jwk of an Arweave wallet's keyfile, stringified. All uploads of bundled data items to Arweave will be signed and paid for by this wallet, so it must maintain a balance of AR tokens sufficient to handle the uploads.")]),e._v(" "),a("li",[a("code",[e._v("BUNDLER_ARWEAVE_ADDRESS")]),e._v(" must be the "),a("RouterLink",{attrs:{to:"/glossary.html#normalized-address"}},[e._v("normalized public address")]),e._v(" for the provided Arweave wallet.")],1),e._v(" "),a("li",[a("code",[e._v("APP_NAME")]),e._v(" is a GraphQL tag that will be added to uploaded bundles.")])]),e._v(" "),a("p",[e._v("The remaining lines in the "),a("code",[e._v(".env.bundler.example")]),e._v(" file control settings that allow the bundler service to share data with the ar.io gateway. Data sharing of contiguous data between a bundler and a gateway allows the gateway to serve optimistically cached data without waiting for it to fully settle on chain.")]),e._v(" "),a("h3",{attrs:{id:"managing-bundler-access"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#managing-bundler-access"}},[e._v("#")]),e._v(" Managing Bundler Access")]),e._v(" "),a("p",[e._v("By default, the bundler will only accept data items uploaded by data item signers whose "),a("RouterLink",{attrs:{to:"/glossary.html#normalized-address"}},[e._v("normalized wallet addresses")]),e._v(" are in the "),a("code",[e._v("ALLOW_LISTED_ADDRESSES")]),e._v(" list. This is an additional environmental variable that can be added to your "),a("code",[e._v(".env.bundler")]),e._v(" file, and must be a comma separated list of normalized public wallet addresses for wallets that should be allowed to bundle and upload data through your gateway.")],1),e._v(" "),a("div",{staticClass:"language-bash extra-class"},[a("pre",{pre:!0,attrs:{class:"language-bash"}},[a("code",[a("span",{pre:!0,attrs:{class:"token assign-left variable"}},[e._v("ALLOW_LISTED_ADDRESSES")]),a("span",{pre:!0,attrs:{class:"token operator"}},[e._v("=")]),a("span",{pre:!0,attrs:{class:"token operator"}},[e._v("<")]),e._v("address"),a("span",{pre:!0,attrs:{class:"token operator"}},[a("span",{pre:!0,attrs:{class:"token file-descriptor important"}},[e._v("1")]),e._v(">")]),e._v(","),a("span",{pre:!0,attrs:{class:"token operator"}},[e._v("<")]),e._v("address"),a("span",{pre:!0,attrs:{class:"token operator"}},[a("span",{pre:!0,attrs:{class:"token file-descriptor important"}},[e._v("2")]),e._v(">")]),e._v("\n")])])]),a("p",[e._v("The following permissioning configurations schemes are also possible:")]),e._v(" "),a("div",{staticStyle:{"text-align":"center"}},[a("table",{staticClass:"inline-table",attrs:{id:"gateway-table"}},[a("tr",[a("th",[e._v("Scheme")]),e._v(" "),a("th",[e._v("ALLOW_LISTED_ADDRESSES")]),e._v(" "),a("th",[e._v("SKIP_BALANCE_CHECKS")]),e._v(" "),a("th",[e._v("ALLOW_LISTED_SIGNATURE_TYPES")]),e._v(" "),a("th",[e._v("PAYMENT_SERVICE_BASE_URL")])]),e._v(" "),a("tr",[a("th",[e._v("Allow Specific Wallets")]),e._v(" "),a("td",[e._v("Comma-separated normalized wallet addresses")]),e._v(" "),a("td",[e._v("false")]),e._v(" "),a("td",[e._v("EMPTY or supplied")]),e._v(" "),a("td",[e._v("EMPTY")])]),e._v(" "),a("tr",[a("th",[e._v("Allow Specific chains")]),e._v(" "),a("td",[e._v("EMPTY or supplied")]),e._v(" "),a("td",[e._v("false")]),e._v(" "),a("td",[e._v("arbundles sigtype int")]),e._v(" "),a("td",[e._v("EMPTY")])]),e._v(" "),a("tr",[a("th",[e._v("Allow All")]),e._v(" "),a("td",[e._v("n/a")]),e._v(" "),a("td",[e._v("true")]),e._v(" "),a("td",[e._v("n/a")]),e._v(" "),a("td",[e._v("n/a")])]),e._v(" "),a("tr",[a("th",[e._v("Allow None")]),e._v(" "),a("td",[e._v("EMPTY")]),e._v(" "),a("td",[e._v("false")]),e._v(" "),a("td",[e._v("EMPTY")]),e._v(" "),a("td",[e._v("EMPTY")])]),e._v(" "),a("tr",[a("th",[e._v("Allow Payers")]),e._v(" "),a("td",[e._v("EMPTY or supplied")]),e._v(" "),a("td",[e._v("false")]),e._v(" "),a("td",[e._v("EMPTY or supplied")]),e._v(" "),a("td",[e._v("Your payment service url")])])])]),e._v(" "),a("h3",{attrs:{id:"indexing"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#indexing"}},[e._v("#")]),e._v(" Indexing")]),e._v(" "),a("p",[e._v("Bundlers submit data to the Arweave network as an "),a("a",{attrs:{href:"https://github.com/ArweaveTeam/arweave-standards/blob/master/ans/ANS-104.md",target:"_blank",rel:"noopener noreferrer"}},[e._v("ANS-104 data item bundle"),a("OutboundLink")],1),e._v(". This means it is several transactions wrapped into one. A gateway will need to unbundle these transactions in order to index them. A gateway should include the following ANS-104 filters in order to unbundle and index transactions from a particular bundler:")]),e._v(" "),a("div",{staticClass:"language-bash extra-class"},[a("pre",{pre:!0,attrs:{class:"language-bash"}},[a("code",[a("span",{pre:!0,attrs:{class:"token assign-left variable"}},[e._v("ANS104_INDEX_FILTER")]),a("span",{pre:!0,attrs:{class:"token operator"}},[e._v("=")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("{")]),e._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[e._v('"always"')]),a("span",{pre:!0,attrs:{class:"token builtin class-name"}},[e._v(":")]),e._v(" "),a("span",{pre:!0,attrs:{class:"token boolean"}},[e._v("true")]),e._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("}")]),e._v("\n"),a("span",{pre:!0,attrs:{class:"token assign-left variable"}},[e._v("ANS104_UNBUNDLE_FILTER")]),a("span",{pre:!0,attrs:{class:"token operator"}},[e._v("=")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("{")]),e._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[e._v('"attributes"')]),a("span",{pre:!0,attrs:{class:"token builtin class-name"}},[e._v(":")]),e._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("{")]),e._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[e._v('"owner_address"')]),a("span",{pre:!0,attrs:{class:"token builtin class-name"}},[e._v(":")]),e._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[e._v('"'),a("span",{pre:!0,attrs:{class:"token variable"}},[e._v("$BUNDLER_ARWEAVE_ADDRESS")]),e._v('"')]),e._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("}")]),e._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("}")]),e._v("\n")])])]),a("p",[a("code",[e._v("$BUNDLER_ARWEAVE_ADDRESS")]),e._v(" should be replaced with the "),a("RouterLink",{attrs:{to:"/glossary.html#normalized-address"}},[e._v("normalized public wallet address")]),e._v(" associated with the bundler.")],1),e._v(" "),a("p",[a("strong",[e._v("NOTE")]),e._v(": The above filters must be placed in the "),a("code",[e._v(".env")]),e._v(" file for the core gateway service, not the bundler.")]),e._v(" "),a("p",[e._v("Gateways handle data item indexing asynchronously. This means they establish a queue of items to index, and work on processing the queue in the background while the gateway continues with its normal operations. If a gateway has broad indexing filters, there can be some latency in indexing data items from the bundler while the gateway works through its queue.")]),e._v(" "),a("h4",{attrs:{id:"optimistic-indexing"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#optimistic-indexing"}},[e._v("#")]),e._v(" Optimistic Indexing")]),e._v(" "),a("p",[e._v("Gateway operators control access to their "),a("RouterLink",{attrs:{to:"/glossary.html#optimistic-indexing"}},[e._v("optimistic data item indexing")]),e._v(" API via an admin key that must be supplied by all bundling clients in order for their requests to be accepted. This key should be made available in the environment configuration files for BOTH the core gateway, and the bundler, and should be provided as "),a("code",[e._v("AR_IO_ADMIN_KEY")]),e._v(":")],1),e._v(" "),a("div",{staticClass:"language-bash extra-class"},[a("pre",{pre:!0,attrs:{class:"language-bash"}},[a("code",[a("span",{pre:!0,attrs:{class:"token assign-left variable"}},[e._v("AR_IO_ADMIN_KEY")]),a("span",{pre:!0,attrs:{class:"token operator"}},[e._v("=")]),a("span",{pre:!0,attrs:{class:"token string"}},[e._v('"Admin password"')]),e._v("\n")])])]),a("p",[a("strong",[e._v("NOTE")]),e._v(": If a gateway is started without providing the admin key, a random string will be generated to protect the gateway's admin endpoints. This can be reset by restarting the gateway with the admin key provided in the "),a("code",[e._v(".env")]),e._v(" file.")]),e._v(" "),a("h2",{attrs:{id:"starting-and-stopping-the-bundler"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#starting-and-stopping-the-bundler"}},[e._v("#")]),e._v(" Starting and Stopping the Bundler")]),e._v(" "),a("h3",{attrs:{id:"starting"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#starting"}},[e._v("#")]),e._v(" Starting")]),e._v(" "),a("p",[e._v("The bundler service is designed to run in conjunction with an ar.io gateway, and so relies on the "),a("code",[e._v("ar-io-network")]),e._v(" network created in Docker when the core gateway services are spun up. It is possible to spin up the bundler while the core services are down, but the network must exist in Docker.")]),e._v(" "),a("p",[e._v("To start the bundler, specify the env and docker-compose files being used in a "),a("code",[e._v("docker compose up")]),e._v(" command:")]),e._v(" "),a("div",{staticClass:"language-bash extra-class"},[a("pre",{pre:!0,attrs:{class:"language-bash"}},[a("code",[a("span",{pre:!0,attrs:{class:"token function"}},[e._v("docker")]),e._v(" compose --env-file ./.env.bundler "),a("span",{pre:!0,attrs:{class:"token parameter variable"}},[e._v("--file")]),e._v(" docker-compose.bundler.yaml up "),a("span",{pre:!0,attrs:{class:"token parameter variable"}},[e._v("-d")]),e._v("\n")])])]),a("p",[e._v("The "),a("code",[e._v("-d")]),e._v(' flag runs the command in "detached" mode, so it will run in the background without requiring the terminal to remain active.')]),e._v(" "),a("h3",{attrs:{id:"stopping"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#stopping"}},[e._v("#")]),e._v(" Stopping")]),e._v(" "),a("p",[e._v("To spin the bundler service down, specify the docker-compose file in a "),a("code",[e._v("docker compose down")]),e._v(" command:")]),e._v(" "),a("div",{staticClass:"language-bash extra-class"},[a("pre",{pre:!0,attrs:{class:"language-bash"}},[a("code",[a("span",{pre:!0,attrs:{class:"token function"}},[e._v("docker")]),e._v(" compose "),a("span",{pre:!0,attrs:{class:"token parameter variable"}},[e._v("--file")]),e._v(" docker-compose.bundler.yaml down\n")])])]),a("h3",{attrs:{id:"logs"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#logs"}},[e._v("#")]),e._v(" logs")]),e._v(" "),a("p",[e._v("While the bundler service is running in detached mode, logs can be checked by specifying the docker-compose file in a "),a("code",[e._v("docker compose logs")]),e._v(" command:")]),e._v(" "),a("div",{staticClass:"language-bash extra-class"},[a("pre",{pre:!0,attrs:{class:"language-bash"}},[a("code",[a("span",{pre:!0,attrs:{class:"token function"}},[e._v("docker")]),e._v(" compose "),a("span",{pre:!0,attrs:{class:"token parameter variable"}},[e._v("--file")]),e._v(" docker-compose.bundler.yaml logs "),a("span",{pre:!0,attrs:{class:"token parameter variable"}},[e._v("-f")]),e._v(" "),a("span",{pre:!0,attrs:{class:"token parameter variable"}},[e._v("--tail")]),a("span",{pre:!0,attrs:{class:"token operator"}},[e._v("=")]),a("span",{pre:!0,attrs:{class:"token number"}},[e._v("0")]),e._v("\n")])])]),a("ul",[a("li",[a("code",[e._v("-f")]),e._v(' runs the command in "follow" mode, so the terminal will continue to watch and display new logs.')]),e._v(" "),a("li",[a("code",[e._v("--tail=")]),e._v(" defines the number of logs to display that existed prior to running the command. "),a("code",[e._v("0")]),e._v(" displays only new logs.")])])])}),[],!1,null,null,null);a.default=r.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[42],{342:function(e,a,t){"use strict";t.r(a);var s=t(10),r=Object(s.a)({},(function(){var e=this,a=e._self._c;return a("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[a("h1",{attrs:{id:"bundler"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#bundler"}},[e._v("#")]),e._v(" Bundler")]),e._v(" "),a("h2",{attrs:{id:"overview"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#overview"}},[e._v("#")]),e._v(" Overview")]),e._v(" "),a("p",[e._v("A "),a("a",{attrs:{href:"https://github.com/ardriveapp/turbo-upload-service/",target:"_blank",rel:"noopener noreferrer"}},[e._v("Turbo ANS-104"),a("OutboundLink")],1),e._v(" data item bundler can be run alongside an ar.io gateway. This allows gateways the ability to accept data items to be submit to the Arweave blockweave.")]),e._v(" "),a("p",[e._v("The bundler service can be easily run inside Docker in the same way that the gateway is. It utilizes a separate docker compose file for configuration and deployment, which also allows for the use of a separate file for environmental variables specific to the bundler service. Additionally, the separation allows operators to spin their bundler service up or down at any time without affecting their core gateway service. Despite the use of separate docker compose files, the bundler service shares a docker network with the ar.io gateway, and so is able to directly interact with the gateway service and data.")]),e._v(" "),a("h2",{attrs:{id:"getting-started"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#getting-started"}},[e._v("#")]),e._v(" Getting Started")]),e._v(" "),a("p",[a("strong",[e._v("NOTE")]),e._v(": The bundler service relies on GraphQL indexing of recently bundled and uploaded data to manage its pipeline operations. The ar.io gateway should have its indexes synced up to Arweave's current block height before starting the bundler's service stack.")]),e._v(" "),a("h3",{attrs:{id:"environmental-variables"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#environmental-variables"}},[e._v("#")]),e._v(" Environmental Variables")]),e._v(" "),a("p",[e._v("Environmental variables must be provided for the bundler to function and integrate properly with an existing ar.io gateway. The gateway repository provides a "),a("code",[e._v(".env.bundler.example")]),e._v(" file that can be renamed to "),a("code",[e._v(".env.bundler")]),e._v(" and used as a starting point. It contains the following:")]),e._v(" "),a("div",{staticClass:"language-bash extra-class"},[a("pre",{pre:!0,attrs:{class:"language-bash"}},[a("code",[a("span",{pre:!0,attrs:{class:"token assign-left variable"}},[e._v("BUNDLER_ARWEAVE_WALLET")]),a("span",{pre:!0,attrs:{class:"token operator"}},[e._v("=")]),a("span",{pre:!0,attrs:{class:"token string"}},[e._v("'Stringified JWK wallet. e.g: '")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("{")]),e._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[e._v('"n"')]),a("span",{pre:!0,attrs:{class:"token builtin class-name"}},[e._v(":")]),e._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[e._v('"..."')]),e._v(", "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("..")]),e._v(". "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("}")]),a("span",{pre:!0,attrs:{class:"token string"}},[e._v("'\nBUNDLER_ARWEAVE_ADDRESS='")]),e._v("Address "),a("span",{pre:!0,attrs:{class:"token keyword"}},[e._v("for")]),e._v(" above wallet"),a("span",{pre:!0,attrs:{class:"token string"}},[e._v("'\n\nAPP_NAME='")]),e._v("ar.io bundler "),a("span",{pre:!0,attrs:{class:"token function"}},[e._v("service")]),a("span",{pre:!0,attrs:{class:"token string"}},[e._v("'\n\n# Use localstack s3 bucket for shared data source between ar.io gateway and bundler\nAWS_S3_BUCKET=ar.io\nAWS_S3_PREFIX='")]),e._v("data"),a("span",{pre:!0,attrs:{class:"token string"}},[e._v("'\nAWS_ACCESS_KEY_ID='")]),a("span",{pre:!0,attrs:{class:"token builtin class-name"}},[e._v("test")]),a("span",{pre:!0,attrs:{class:"token string"}},[e._v("'\nAWS_SECRET_ACCESS_KEY='")]),a("span",{pre:!0,attrs:{class:"token builtin class-name"}},[e._v("test")]),a("span",{pre:!0,attrs:{class:"token string"}},[e._v("'\nAWS_REGION='")]),e._v("us-east-1"),a("span",{pre:!0,attrs:{class:"token string"}},[e._v("'\nAWS_ENDPOINT='")]),e._v("http://localstack:4566'\n")])])]),a("ul",[a("li",[a("code",[e._v("BUNDLER_ARWEAVE_WALLET")]),e._v(" must be the entire jwk of an Arweave wallet's keyfile, stringified. All uploads of bundled data items to Arweave will be signed and paid for by this wallet, so it must maintain a balance of AR tokens sufficient to handle the uploads.")]),e._v(" "),a("li",[a("code",[e._v("BUNDLER_ARWEAVE_ADDRESS")]),e._v(" must be the "),a("RouterLink",{attrs:{to:"/glossary.html#normalized-address"}},[e._v("normalized public address")]),e._v(" for the provided Arweave wallet.")],1),e._v(" "),a("li",[a("code",[e._v("APP_NAME")]),e._v(" is a GraphQL tag that will be added to uploaded bundles.")])]),e._v(" "),a("p",[e._v("The remaining lines in the "),a("code",[e._v(".env.bundler.example")]),e._v(" file control settings that allow the bundler service to share data with the ar.io gateway. Data sharing of contiguous data between a bundler and a gateway allows the gateway to serve optimistically cached data without waiting for it to fully settle on chain.")]),e._v(" "),a("h3",{attrs:{id:"managing-bundler-access"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#managing-bundler-access"}},[e._v("#")]),e._v(" Managing Bundler Access")]),e._v(" "),a("p",[e._v("By default, the bundler will only accept data items uploaded by data item signers whose "),a("RouterLink",{attrs:{to:"/glossary.html#normalized-address"}},[e._v("normalized wallet addresses")]),e._v(" are in the "),a("code",[e._v("ALLOW_LISTED_ADDRESSES")]),e._v(" list. This is an additional environmental variable that can be added to your "),a("code",[e._v(".env.bundler")]),e._v(" file, and must be a comma separated list of normalized public wallet addresses for wallets that should be allowed to bundle and upload data through your gateway.")],1),e._v(" "),a("div",{staticClass:"language-bash extra-class"},[a("pre",{pre:!0,attrs:{class:"language-bash"}},[a("code",[a("span",{pre:!0,attrs:{class:"token assign-left variable"}},[e._v("ALLOW_LISTED_ADDRESSES")]),a("span",{pre:!0,attrs:{class:"token operator"}},[e._v("=")]),a("span",{pre:!0,attrs:{class:"token operator"}},[e._v("<")]),e._v("address"),a("span",{pre:!0,attrs:{class:"token operator"}},[a("span",{pre:!0,attrs:{class:"token file-descriptor important"}},[e._v("1")]),e._v(">")]),e._v(","),a("span",{pre:!0,attrs:{class:"token operator"}},[e._v("<")]),e._v("address"),a("span",{pre:!0,attrs:{class:"token operator"}},[a("span",{pre:!0,attrs:{class:"token file-descriptor important"}},[e._v("2")]),e._v(">")]),e._v("\n")])])]),a("p",[e._v("The following permissioning configurations schemes are also possible:")]),e._v(" "),a("div",{staticStyle:{"text-align":"center"}},[a("table",{staticClass:"inline-table",attrs:{id:"gateway-table"}},[a("tr",[a("th",[e._v("Scheme")]),e._v(" "),a("th",[e._v("ALLOW_LISTED_ADDRESSES")]),e._v(" "),a("th",[e._v("SKIP_BALANCE_CHECKS")]),e._v(" "),a("th",[e._v("ALLOW_LISTED_SIGNATURE_TYPES")]),e._v(" "),a("th",[e._v("PAYMENT_SERVICE_BASE_URL")])]),e._v(" "),a("tr",[a("th",[e._v("Allow Specific Wallets")]),e._v(" "),a("td",[e._v("Comma-separated normalized wallet addresses")]),e._v(" "),a("td",[e._v("false")]),e._v(" "),a("td",[e._v("EMPTY or supplied")]),e._v(" "),a("td",[e._v("EMPTY")])]),e._v(" "),a("tr",[a("th",[e._v("Allow Specific chains")]),e._v(" "),a("td",[e._v("EMPTY or supplied")]),e._v(" "),a("td",[e._v("false")]),e._v(" "),a("td",[e._v("arbundles sigtype int")]),e._v(" "),a("td",[e._v("EMPTY")])]),e._v(" "),a("tr",[a("th",[e._v("Allow All")]),e._v(" "),a("td",[e._v("n/a")]),e._v(" "),a("td",[e._v("true")]),e._v(" "),a("td",[e._v("n/a")]),e._v(" "),a("td",[e._v("n/a")])]),e._v(" "),a("tr",[a("th",[e._v("Allow None")]),e._v(" "),a("td",[e._v("EMPTY")]),e._v(" "),a("td",[e._v("false")]),e._v(" "),a("td",[e._v("EMPTY")]),e._v(" "),a("td",[e._v("EMPTY")])]),e._v(" "),a("tr",[a("th",[e._v("Allow Payers")]),e._v(" "),a("td",[e._v("EMPTY or supplied")]),e._v(" "),a("td",[e._v("false")]),e._v(" "),a("td",[e._v("EMPTY or supplied")]),e._v(" "),a("td",[e._v("Your payment service url")])])])]),e._v(" "),a("h3",{attrs:{id:"indexing"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#indexing"}},[e._v("#")]),e._v(" Indexing")]),e._v(" "),a("p",[e._v("Bundlers submit data to the Arweave network as an "),a("a",{attrs:{href:"https://github.com/ArweaveTeam/arweave-standards/blob/master/ans/ANS-104.md",target:"_blank",rel:"noopener noreferrer"}},[e._v("ANS-104 data item bundle"),a("OutboundLink")],1),e._v(". This means it is several transactions wrapped into one. A gateway will need to unbundle these transactions in order to index them. A gateway should include the following ANS-104 filters in order to unbundle and index transactions from a particular bundler:")]),e._v(" "),a("div",{staticClass:"language-bash extra-class"},[a("pre",{pre:!0,attrs:{class:"language-bash"}},[a("code",[a("span",{pre:!0,attrs:{class:"token assign-left variable"}},[e._v("ANS104_INDEX_FILTER")]),a("span",{pre:!0,attrs:{class:"token operator"}},[e._v("=")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("{")]),e._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[e._v('"always"')]),a("span",{pre:!0,attrs:{class:"token builtin class-name"}},[e._v(":")]),e._v(" "),a("span",{pre:!0,attrs:{class:"token boolean"}},[e._v("true")]),e._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("}")]),e._v("\n"),a("span",{pre:!0,attrs:{class:"token assign-left variable"}},[e._v("ANS104_UNBUNDLE_FILTER")]),a("span",{pre:!0,attrs:{class:"token operator"}},[e._v("=")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("{")]),e._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[e._v('"attributes"')]),a("span",{pre:!0,attrs:{class:"token builtin class-name"}},[e._v(":")]),e._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("{")]),e._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[e._v('"owner_address"')]),a("span",{pre:!0,attrs:{class:"token builtin class-name"}},[e._v(":")]),e._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[e._v('"'),a("span",{pre:!0,attrs:{class:"token variable"}},[e._v("$BUNDLER_ARWEAVE_ADDRESS")]),e._v('"')]),e._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("}")]),e._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("}")]),e._v("\n")])])]),a("p",[a("code",[e._v("$BUNDLER_ARWEAVE_ADDRESS")]),e._v(" should be replaced with the "),a("RouterLink",{attrs:{to:"/glossary.html#normalized-address"}},[e._v("normalized public wallet address")]),e._v(" associated with the bundler.")],1),e._v(" "),a("p",[a("strong",[e._v("NOTE")]),e._v(": The above filters must be placed in the "),a("code",[e._v(".env")]),e._v(" file for the core gateway service, not the bundler.")]),e._v(" "),a("p",[e._v("Gateways handle data item indexing asynchronously. This means they establish a queue of items to index, and work on processing the queue in the background while the gateway continues with its normal operations. If a gateway has broad indexing filters, there can be some latency in indexing data items from the bundler while the gateway works through its queue.")]),e._v(" "),a("h4",{attrs:{id:"optimistic-indexing"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#optimistic-indexing"}},[e._v("#")]),e._v(" Optimistic Indexing")]),e._v(" "),a("p",[e._v("Gateway operators control access to their "),a("RouterLink",{attrs:{to:"/glossary.html#optimistic-indexing"}},[e._v("optimistic data item indexing")]),e._v(" API via an admin key that must be supplied by all bundling clients in order for their requests to be accepted. This key should be made available in the environment configuration files for BOTH the core gateway, and the bundler, and should be provided as "),a("code",[e._v("AR_IO_ADMIN_KEY")]),e._v(":")],1),e._v(" "),a("div",{staticClass:"language-bash extra-class"},[a("pre",{pre:!0,attrs:{class:"language-bash"}},[a("code",[a("span",{pre:!0,attrs:{class:"token assign-left variable"}},[e._v("AR_IO_ADMIN_KEY")]),a("span",{pre:!0,attrs:{class:"token operator"}},[e._v("=")]),a("span",{pre:!0,attrs:{class:"token string"}},[e._v('"Admin password"')]),e._v("\n")])])]),a("p",[a("strong",[e._v("NOTE")]),e._v(": If a gateway is started without providing the admin key, a random string will be generated to protect the gateway's admin endpoints. This can be reset by restarting the gateway with the admin key provided in the "),a("code",[e._v(".env")]),e._v(" file.")]),e._v(" "),a("h2",{attrs:{id:"starting-and-stopping-the-bundler"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#starting-and-stopping-the-bundler"}},[e._v("#")]),e._v(" Starting and Stopping the Bundler")]),e._v(" "),a("h3",{attrs:{id:"starting"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#starting"}},[e._v("#")]),e._v(" Starting")]),e._v(" "),a("p",[e._v("The bundler service is designed to run in conjunction with an ar.io gateway, and so relies on the "),a("code",[e._v("ar-io-network")]),e._v(" network created in Docker when the core gateway services are spun up. It is possible to spin up the bundler while the core services are down, but the network must exist in Docker.")]),e._v(" "),a("p",[e._v("To start the bundler, specify the env and docker-compose files being used in a "),a("code",[e._v("docker compose up")]),e._v(" command:")]),e._v(" "),a("div",{staticClass:"language-bash extra-class"},[a("pre",{pre:!0,attrs:{class:"language-bash"}},[a("code",[a("span",{pre:!0,attrs:{class:"token function"}},[e._v("docker")]),e._v(" compose --env-file ./.env.bundler "),a("span",{pre:!0,attrs:{class:"token parameter variable"}},[e._v("--file")]),e._v(" docker-compose.bundler.yaml up "),a("span",{pre:!0,attrs:{class:"token parameter variable"}},[e._v("-d")]),e._v("\n")])])]),a("p",[e._v("The "),a("code",[e._v("-d")]),e._v(' flag runs the command in "detached" mode, so it will run in the background without requiring the terminal to remain active.')]),e._v(" "),a("h3",{attrs:{id:"stopping"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#stopping"}},[e._v("#")]),e._v(" Stopping")]),e._v(" "),a("p",[e._v("To spin the bundler service down, specify the docker-compose file in a "),a("code",[e._v("docker compose down")]),e._v(" command:")]),e._v(" "),a("div",{staticClass:"language-bash extra-class"},[a("pre",{pre:!0,attrs:{class:"language-bash"}},[a("code",[a("span",{pre:!0,attrs:{class:"token function"}},[e._v("docker")]),e._v(" compose "),a("span",{pre:!0,attrs:{class:"token parameter variable"}},[e._v("--file")]),e._v(" docker-compose.bundler.yaml down\n")])])]),a("h3",{attrs:{id:"logs"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#logs"}},[e._v("#")]),e._v(" logs")]),e._v(" "),a("p",[e._v("While the bundler service is running in detached mode, logs can be checked by specifying the docker-compose file in a "),a("code",[e._v("docker compose logs")]),e._v(" command:")]),e._v(" "),a("div",{staticClass:"language-bash extra-class"},[a("pre",{pre:!0,attrs:{class:"language-bash"}},[a("code",[a("span",{pre:!0,attrs:{class:"token function"}},[e._v("docker")]),e._v(" compose "),a("span",{pre:!0,attrs:{class:"token parameter variable"}},[e._v("--file")]),e._v(" docker-compose.bundler.yaml logs "),a("span",{pre:!0,attrs:{class:"token parameter variable"}},[e._v("-f")]),e._v(" "),a("span",{pre:!0,attrs:{class:"token parameter variable"}},[e._v("--tail")]),a("span",{pre:!0,attrs:{class:"token operator"}},[e._v("=")]),a("span",{pre:!0,attrs:{class:"token number"}},[e._v("0")]),e._v("\n")])])]),a("ul",[a("li",[a("code",[e._v("-f")]),e._v(' runs the command in "follow" mode, so the terminal will continue to watch and display new logs.')]),e._v(" "),a("li",[a("code",[e._v("--tail=")]),e._v(" defines the number of logs to display that existed prior to running the command. "),a("code",[e._v("0")]),e._v(" displays only new logs.")])])])}),[],!1,null,null,null);a.default=r.exports}}]); \ No newline at end of file diff --git a/assets/js/43.b09ee109.js b/assets/js/43.c8d5e35e.js similarity index 94% rename from assets/js/43.b09ee109.js rename to assets/js/43.c8d5e35e.js index 4f83906f..aa253c89 100644 --- a/assets/js/43.b09ee109.js +++ b/assets/js/43.c8d5e35e.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[43],{342:function(e,t,a){"use strict";a.r(t);var s=a(10),o=Object(s.a)({},(function(){var e=this,t=e._self._c;return t("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[t("h1",{attrs:{id:"delegated-staking-settings"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#delegated-staking-settings"}},[e._v("#")]),e._v(" Delegated Staking Settings")]),e._v(" "),t("h2",{attrs:{id:"overview"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#overview"}},[e._v("#")]),e._v(" Overview")]),e._v(" "),t("p",[e._v("Gateway operators can choose to allow other people to stake tokens on their gateway. This is called “delegated staking”, and it increases the number of tokens staked for a given gateway. The additionally staked tokens result in a greater "),t("code",[e._v("stakeWeight")]),e._v(" for the gateway - increasing it’s likelihood chosen as an observer and potentially receive additional rewards for a given epoch (assuming that the gateway’s observer is working properly). To incentivize this, you can set a portion of your gateway and observer rewards to be given to the people who stake on your gateway.")]),e._v(" "),e._v(" --\x3e")])}),[],!1,null,null,null);t.default=o.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[43],{344:function(e,t,a){"use strict";a.r(t);var s=a(10),o=Object(s.a)({},(function(){var e=this,t=e._self._c;return t("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[t("h1",{attrs:{id:"delegated-staking-settings"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#delegated-staking-settings"}},[e._v("#")]),e._v(" Delegated Staking Settings")]),e._v(" "),t("h2",{attrs:{id:"overview"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#overview"}},[e._v("#")]),e._v(" Overview")]),e._v(" "),t("p",[e._v("Gateway operators can choose to allow other people to stake tokens on their gateway. This is called “delegated staking”, and it increases the number of tokens staked for a given gateway. The additionally staked tokens result in a greater "),t("code",[e._v("stakeWeight")]),e._v(" for the gateway - increasing it’s likelihood chosen as an observer and potentially receive additional rewards for a given epoch (assuming that the gateway’s observer is working properly). To incentivize this, you can set a portion of your gateway and observer rewards to be given to the people who stake on your gateway.")]),e._v(" "),e._v(" --\x3e")])}),[],!1,null,null,null);t.default=o.exports}}]); \ No newline at end of file diff --git a/assets/js/44.3e8e429c.js b/assets/js/44.bfc26f79.js similarity index 99% rename from assets/js/44.3e8e429c.js rename to assets/js/44.bfc26f79.js index 5ccdecc7..f4eb218f 100644 --- a/assets/js/44.3e8e429c.js +++ b/assets/js/44.bfc26f79.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[44],{344:function(t,e,_){"use strict";_.r(e);var v=_(10),r=Object(v.a)({},(function(){var t=this,e=t._self._c;return e("ContentSlotsDistributor",{attrs:{"slot-key":t.$parent.slotKey}},[e("h1",{attrs:{id:"environmental-variables"}},[e("a",{staticClass:"header-anchor",attrs:{href:"#environmental-variables"}},[t._v("#")]),t._v(" Environmental Variables")]),t._v(" "),e("h2",{attrs:{id:"overview"}},[e("a",{staticClass:"header-anchor",attrs:{href:"#overview"}},[t._v("#")]),t._v(" Overview")]),t._v(" "),e("p",[t._v("The AR.IO Gateway allows configuration customization through environmental variables. These variables dictate the gateway's behavior, from block synchronization settings to log formatting. Detailed below is a table enumerating all available environmental variables, their respective types, default values, and a brief description. Note that certain variables, such as "),e("code",[t._v("SANDBOX_PROTOCOL")]),t._v(", rely on others (e.g., "),e("code",[t._v("ARNS_ROOT_HOST")]),t._v(") to function effectively. Ensure proper understanding of these dependencies when configuring.")]),t._v(" "),e("h2",{attrs:{id:"variables"}},[e("a",{staticClass:"header-anchor",attrs:{href:"#variables"}},[t._v("#")]),t._v(" Variables")]),t._v(" "),e("div",{staticStyle:{"text-align":"center"}},[e("table",{staticClass:"inline-table",attrs:{id:"gateway-table"}},[e("tr",[e("th",[t._v("ENV Name")]),t._v(" "),e("th",[t._v("Type")]),t._v(" "),e("th",[t._v("Default Value")]),t._v(" "),e("th",[t._v("Description")])]),t._v(" "),e("tr",[e("th",[t._v("START_HEIGHT")]),t._v(" "),e("td",[t._v('Number or "Infinity"')]),t._v(" "),e("td",[t._v("0")]),t._v(" "),e("td",[t._v("Starting block height for node synchronization (0 = start from genesis block)")])]),t._v(" "),e("tr",[e("th",[t._v("STOP_HEIGHT")]),t._v(" "),e("td",[t._v('Number or "Infinity"')]),t._v(" "),e("td",[t._v('"Infinity"')]),t._v(" "),e("td",[t._v("Stop block height for node synchronization (Infinity = keep syncing until stopped)")])]),t._v(" "),e("tr",[e("th",[t._v("TRUSTED_NODE_URL")]),t._v(" "),e("td",[t._v("String")]),t._v(" "),e("td",[t._v('"https://arweave.net"')]),t._v(" "),e("td",[t._v("Arweave node to use for fetching data")])]),t._v(" "),e("tr",[e("th",[t._v("TRUSTED_GATEWAY_URL")]),t._v(" "),e("td",[t._v("String")]),t._v(" "),e("td",[t._v('"https://arweave.net"')]),t._v(" "),e("td",[t._v("Arweave node to use for proxying reqeusts")])]),t._v(" "),e("tr",[e("th",[t._v("TRUSTED_ARNS_GATEWAY_URL")]),t._v(" "),e("td",[t._v("String")]),t._v(" "),e("td",[t._v("https://NAME.arweave.dev")]),t._v(" "),e("td",[t._v("ArNS gateway")])]),t._v(" "),e("tr",[e("th",[t._v("INSTANCE_ID")]),t._v(" "),e("td",[t._v("String")]),t._v(" "),e("td",[t._v('""')]),t._v(" "),e("td",[t._v('Adds an "INSTANCE_ID" field to output logs')])]),t._v(" "),e("tr",[e("th",[t._v("LOG_FORMAT")]),t._v(" "),e("td",[t._v("String")]),t._v(" "),e("td",[t._v('"simple"')]),t._v(" "),e("td",[t._v('Sets the format of output logs, accepts "simple" and "json"')])]),t._v(" "),e("tr",[e("th",[t._v("SKIP_CACHE")]),t._v(" "),e("td",[t._v("Boolean")]),t._v(" "),e("td",[t._v("false")]),t._v(" "),e("td",[t._v("If true, skips the local cache and always fetches headers from the node")])]),t._v(" "),e("tr",[e("th",[t._v("PORT")]),t._v(" "),e("td",[t._v("Number")]),t._v(" "),e("td",[t._v("4000")]),t._v(" "),e("td",[t._v("AR.IO node exposed port number")])]),t._v(" "),e("tr",[e("th",[t._v("SIMULATED_REQUEST_FAILURE_RATE")]),t._v(" "),e("td",[t._v("Number")]),t._v(" "),e("td",[t._v("0")]),t._v(" "),e("td",[t._v("Number from 0 to 1, representing the probability of a request failing")])]),t._v(" "),e("tr",[e("th",[t._v("AR_IO_WALLET")]),t._v(" "),e("td",[t._v("String")]),t._v(" "),e("td",[t._v('""')]),t._v(" "),e("td",[t._v("Arweave wallet address used for staking and rewards")])]),t._v(" "),e("tr",[e("th",[t._v("ADMIN_API_KEY")]),t._v(" "),e("td",[t._v("String")]),t._v(" "),e("td",[t._v("Generated")]),t._v(" "),e("td",[t._v("API key used for admin API requests (if not set, it is generated and logged into the console)")])]),t._v(" "),e("tr",[e("th",[t._v("BACKFILL_BUNDLE_RECORDS")]),t._v(" "),e("td",[t._v("Boolean")]),t._v(" "),e("td",[t._v("false")]),t._v(" "),e("td",[t._v("If true, AR.IO node will start indexing missing bundles")])]),t._v(" "),e("tr",[e("th",[t._v("FILTER_CHANGE_REPROCESS")]),t._v(" "),e("td",[t._v("Boolean")]),t._v(" "),e("td",[t._v("false")]),t._v(" "),e("td",[t._v("If true, all indexed bundles will be reprocessed with the new filters (you can use this when you change the filters)")])]),t._v(" "),e("tr",[e("th",[t._v("ANS104_UNBUNDLE_FILTER")]),t._v(" "),e("td",[t._v("String")]),t._v(" "),e("td",[t._v('{"never": true}')]),t._v(" "),e("td",[t._v("Only bundles compliant with this filter will be unbundled")])]),t._v(" "),e("tr",[e("th",[t._v("ANS104_INDEX_FILTER")]),t._v(" "),e("td",[t._v("String")]),t._v(" "),e("td",[t._v('{"never": true}')]),t._v(" "),e("td",[t._v("Only bundles compliant with this filter will be indexed")])]),t._v(" "),e("tr",[e("th",[t._v("ARNS_ROOT_HOST")]),t._v(" "),e("td",[t._v("String")]),t._v(" "),e("td",[t._v("undefined")]),t._v(" "),e("td",[t._v("Domain name for ArNS host")])]),t._v(" "),e("tr",[e("th",[t._v("SANDBOX_PROTOCOL")]),t._v(" "),e("td",[t._v("String")]),t._v(" "),e("td",[t._v("undefined")]),t._v(" "),e("td",[t._v('Protocol setting in process of creating sandbox domains in ArNS (ARNS_ROOT_HOST needs to be set for this env to have any effect) accepts "http" or "https"')])]),t._v(" "),e("tr",[e("th",[t._v("START_WRITERS")]),t._v(" "),e("td",[t._v("Boolean")]),t._v(" "),e("td",[t._v("true")]),t._v(" "),e("td",[t._v("If true, start indexing blocks, tx, ANS104 bundles")])]),t._v(" "),e("tr",[e("th",[t._v("RUN_OBSERVER")]),t._v(" "),e("td",[t._v("Boolean")]),t._v(" "),e("td",[t._v("true")]),t._v(" "),e("td",[t._v("If true, runs the Observer alongside the gateway to generate Network compliance reports")])]),t._v(" "),e("tr",[e("th",[t._v("MIN_RELEASE_NUMBER")]),t._v(" "),e("td",[t._v("string")]),t._v(" "),e("td",[t._v('"0"')]),t._v(" "),t._v("Sets the minimum Gateway release version to check while doing a gateway version assessment")]),t._v(" "),e("tr",[e("th",[t._v("AR_IO_NODE_RELEASE")]),t._v(" "),e("td",[t._v("string")]),t._v(" "),e("td",[t._v('"0"')]),t._v(" "),t._v("Sets the current ar.io node version to be set on X-AR-IO-Node-Release header on requests to the reference gateway")]),t._v(" "),e("tr",[e("th",[t._v("OBSERVER_WALLET")]),t._v(" "),e("td",[t._v("String")]),t._v(" "),e("td",[t._v("undefined")]),t._v(" "),e("td",[t._v("The public wallet address of the wallet being used to sign report upload transactions for Observer")])]),t._v(" "),e("tr",[e("th",[t._v("CHUNKS_DATA_PATH")]),t._v(" "),e("td",[t._v("string")]),t._v(" "),e("td",[t._v('"data/chunks"')]),t._v(" "),t._v("Sets the location for chunked data to be saved. If omitted, chunked data will be stored in the `data` directory")]),t._v(" "),e("tr",[e("th",[t._v("CONTIGUOUS_DATA_PATH")]),t._v(" "),e("td",[t._v("string")]),t._v(" "),e("td",[t._v('"data/contiguous"')]),t._v(" "),t._v("Sets the location for contiguous data to be saved. If omitted, contiguous data will be stored in the `data` directory")]),t._v(" "),e("tr",[e("th",[t._v("HEADERS_DATA_PATH")]),t._v(" "),e("td",[t._v("string")]),t._v(" "),e("td",[t._v('"data/headers"')]),t._v(" "),t._v("Sets the location for header data to be saved. If omitted, header data will be stored in the `data` directory")]),t._v(" "),e("tr",[e("th",[t._v("SQLITE_DATA_PATH")]),t._v(" "),e("td",[t._v("string")]),t._v(" "),e("td",[t._v('"data/sqlite"')]),t._v(" "),t._v("Sets the location for sqlite indexed data to be saved. If omitted, sqlite data will be stored in the `data` directory")]),t._v(" "),e("tr",[e("th",[t._v("TEMP_DATA_PATH")]),t._v(" "),e("td",[t._v("string")]),t._v(" "),e("td",[t._v('"data/tmp"')]),t._v(" "),t._v("Sets the location for temporary data to be saved. If omitted, temporary data will be stored in the `data` directory")]),t._v(" "),e("tr",[e("th",[t._v("LMDB_DATA_PATH")]),t._v(" "),e("td",[t._v("string")]),t._v(" "),e("td",[t._v('"data/LMDB"')]),t._v(" "),t._v("Sets the location for LMDB data to be saved. If omitted, LMDB data will be stored in the `data` directory")]),t._v(" "),e("tr",[e("th",[t._v("CHAIN_CACHE_TYPE")]),t._v(" "),e("td",[t._v("String")]),t._v(" "),e("td",[t._v('"redis"')]),t._v(" "),e("td",[t._v("Sets the method for caching chain data, defaults to redis if gateway is started with docker-compose, otherwise defaults to LMDB")])]),t._v(" "),e("tr",[e("th",[t._v("REDIS_CACHE_URL")]),t._v(" "),e("td",[t._v("String (URL)")]),t._v(" "),e("td",[t._v('"redis://localhost:6379"')]),t._v(" "),e("td",[t._v("URL of Redis database to be used for caching")])]),t._v(" "),e("tr",[e("th",[t._v("REDIS_CACHE_TTL_SECONDS")]),t._v(" "),e("td",[t._v("Number")]),t._v(" "),e("td",[t._v("28800")]),t._v(" "),e("td",[t._v("TTL value for Redis cache, defaults to 8 hours (28800 seconds)")])]),t._v(" "),e("tr",[e("th",[t._v("ENABLE_FS_HEADER_CACHE_CLEANUP")]),t._v(" "),e("td",[t._v("Boolean")]),t._v(" "),e("td",[t._v("false")]),t._v(" "),e("td",[t._v("If true, periodically deletes cached header data")])]),t._v(" "),e("tr",[e("th",[t._v("NODE_JS_MAX_OLD_SPACE_SIZE")]),t._v(" "),e("td",[t._v("Number")]),t._v(" "),e("td",[t._v("system default")]),t._v(" "),e("td",[t._v("Sets the memory limit, in Megabytes, for NodeJs. Default value depends on hardware")])]),t._v(" "),e("tr",[e("th",[t._v("SUBMIT_CONTRACT_INTERACTIONS")]),t._v(" "),e("td",[t._v("Boolean")]),t._v(" "),e("td",[t._v("true")]),t._v(" "),e("td",[t._v("If true, Observer will submit its generated reports to the ar.io Network. If false, reports will be generated but not submitted")])]),t._v(" "),e("tr",[e("th",[t._v("REDIS_MAX_MEMORY")]),t._v(" "),e("td",[t._v("String")]),t._v(" "),e("td",[t._v("256mb")]),t._v(" "),e("td",[t._v("Sets the max memory allocated to Redis")])]),t._v(" "),e("tr",[e("th",[t._v("REDIS_EXTRA_FLAGS")]),t._v(" "),e("td",[t._v("String")]),t._v(" "),e("td",[t._v('--save "" --appendonly no')]),t._v(" "),e("td",[t._v("Additional CLI flags passed to Redis")])]),t._v(" "),e("tr",[e("th",[t._v("WEBHOOK_TARGET_SERVERS")]),t._v(" "),e("td",[t._v("String")]),t._v(" "),e("td",[t._v("undefined")]),t._v(" "),e("td",[t._v("Target servers for webhooks")])]),t._v(" "),e("tr",[e("th",[t._v("WEBHOOK_INDEX_FILTER")]),t._v(" "),e("td",[t._v("String")]),t._v(" "),e("td",[t._v('{"never": true}')]),t._v(" "),e("td",[t._v("Only emit webhooks for transactions and data items compliant with this filter")])]),t._v(" "),e("tr",[e("th",[t._v("WEBHOOK_BLOCK_FILTER")]),t._v(" "),e("td",[t._v("String")]),t._v(" "),e("td",[t._v('{"never": true}')]),t._v(" "),e("td",[t._v("Only emit webhooks for blocks compliant with this filter")])]),t._v(" "),e("tr",[e("th",[t._v("CONTIGUOUS_DATA_CACHE_CLEANUP_THRESHOLD")]),t._v(" "),e("td",[t._v("Number")]),t._v(" "),e("td",[t._v("undefined")]),t._v(" "),e("td",[t._v("Sets the age threshold in seconds; files older than this are candidates for contiguous data cache cleanup")])]),t._v(" "),e("tr",[e("th",[t._v("RUN_RESOLVER")]),t._v(" "),e("td",[t._v("Boolean")]),t._v(" "),e("td",[t._v("false")]),t._v(" "),e("td",[t._v("If true, enables the experimental local ArNS resolver service")])]),t._v(" "),e("tr",[e("th",[t._v("TRUSTED_ARNS_RESOLVER_TYPE")]),t._v(" "),e("td",[t._v("String")]),t._v(" "),e("td",[t._v("gateway")]),t._v(" "),e("td",[t._v("Sets the type of ArNS resolver the gateway will use, either `gateway` or `resolver`. Set `resolver` to use experimental local ArNS resolver.")])]),t._v(" "),e("tr",[e("th",[t._v("TRUSTED_ARNS_RESOLVER_URL")]),t._v(" "),e("td",[t._v("String")]),t._v(" "),e("td",[t._v("https:__NAME__.arweave.dev")]),t._v(" "),e("td",[t._v("Sets the url a gateway will use to request ArNS name resolution when type is set to `resolver`")])]),t._v(" "),e("tr",[e("th",[t._v("ENABLE_MEMPOOL_WATCHER")]),t._v(" "),e("td",[t._v("Boolean")]),t._v(" "),e("td",[t._v("false")]),t._v(" "),e("td",[t._v("If true, the gateway will start indexing pending tx from the mempool")])]),t._v(" "),e("tr",[e("th",[t._v("MEMPOOL_POLLING_INTERVAL_MS")]),t._v(" "),e("td",[t._v("Number")]),t._v(" "),e("td",[t._v("30000")]),t._v(" "),e("td",[t._v("Sets the mempool Polling interval, in milliseconds")])])])])])}),[],!1,null,null,null);e.default=r.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[44],{345:function(t,e,_){"use strict";_.r(e);var v=_(10),r=Object(v.a)({},(function(){var t=this,e=t._self._c;return e("ContentSlotsDistributor",{attrs:{"slot-key":t.$parent.slotKey}},[e("h1",{attrs:{id:"environmental-variables"}},[e("a",{staticClass:"header-anchor",attrs:{href:"#environmental-variables"}},[t._v("#")]),t._v(" Environmental Variables")]),t._v(" "),e("h2",{attrs:{id:"overview"}},[e("a",{staticClass:"header-anchor",attrs:{href:"#overview"}},[t._v("#")]),t._v(" Overview")]),t._v(" "),e("p",[t._v("The AR.IO Gateway allows configuration customization through environmental variables. These variables dictate the gateway's behavior, from block synchronization settings to log formatting. Detailed below is a table enumerating all available environmental variables, their respective types, default values, and a brief description. Note that certain variables, such as "),e("code",[t._v("SANDBOX_PROTOCOL")]),t._v(", rely on others (e.g., "),e("code",[t._v("ARNS_ROOT_HOST")]),t._v(") to function effectively. Ensure proper understanding of these dependencies when configuring.")]),t._v(" "),e("h2",{attrs:{id:"variables"}},[e("a",{staticClass:"header-anchor",attrs:{href:"#variables"}},[t._v("#")]),t._v(" Variables")]),t._v(" "),e("div",{staticStyle:{"text-align":"center"}},[e("table",{staticClass:"inline-table",attrs:{id:"gateway-table"}},[e("tr",[e("th",[t._v("ENV Name")]),t._v(" "),e("th",[t._v("Type")]),t._v(" "),e("th",[t._v("Default Value")]),t._v(" "),e("th",[t._v("Description")])]),t._v(" "),e("tr",[e("th",[t._v("START_HEIGHT")]),t._v(" "),e("td",[t._v('Number or "Infinity"')]),t._v(" "),e("td",[t._v("0")]),t._v(" "),e("td",[t._v("Starting block height for node synchronization (0 = start from genesis block)")])]),t._v(" "),e("tr",[e("th",[t._v("STOP_HEIGHT")]),t._v(" "),e("td",[t._v('Number or "Infinity"')]),t._v(" "),e("td",[t._v('"Infinity"')]),t._v(" "),e("td",[t._v("Stop block height for node synchronization (Infinity = keep syncing until stopped)")])]),t._v(" "),e("tr",[e("th",[t._v("TRUSTED_NODE_URL")]),t._v(" "),e("td",[t._v("String")]),t._v(" "),e("td",[t._v('"https://arweave.net"')]),t._v(" "),e("td",[t._v("Arweave node to use for fetching data")])]),t._v(" "),e("tr",[e("th",[t._v("TRUSTED_GATEWAY_URL")]),t._v(" "),e("td",[t._v("String")]),t._v(" "),e("td",[t._v('"https://arweave.net"')]),t._v(" "),e("td",[t._v("Arweave node to use for proxying reqeusts")])]),t._v(" "),e("tr",[e("th",[t._v("TRUSTED_ARNS_GATEWAY_URL")]),t._v(" "),e("td",[t._v("String")]),t._v(" "),e("td",[t._v("https://NAME.arweave.dev")]),t._v(" "),e("td",[t._v("ArNS gateway")])]),t._v(" "),e("tr",[e("th",[t._v("INSTANCE_ID")]),t._v(" "),e("td",[t._v("String")]),t._v(" "),e("td",[t._v('""')]),t._v(" "),e("td",[t._v('Adds an "INSTANCE_ID" field to output logs')])]),t._v(" "),e("tr",[e("th",[t._v("LOG_FORMAT")]),t._v(" "),e("td",[t._v("String")]),t._v(" "),e("td",[t._v('"simple"')]),t._v(" "),e("td",[t._v('Sets the format of output logs, accepts "simple" and "json"')])]),t._v(" "),e("tr",[e("th",[t._v("SKIP_CACHE")]),t._v(" "),e("td",[t._v("Boolean")]),t._v(" "),e("td",[t._v("false")]),t._v(" "),e("td",[t._v("If true, skips the local cache and always fetches headers from the node")])]),t._v(" "),e("tr",[e("th",[t._v("PORT")]),t._v(" "),e("td",[t._v("Number")]),t._v(" "),e("td",[t._v("4000")]),t._v(" "),e("td",[t._v("AR.IO node exposed port number")])]),t._v(" "),e("tr",[e("th",[t._v("SIMULATED_REQUEST_FAILURE_RATE")]),t._v(" "),e("td",[t._v("Number")]),t._v(" "),e("td",[t._v("0")]),t._v(" "),e("td",[t._v("Number from 0 to 1, representing the probability of a request failing")])]),t._v(" "),e("tr",[e("th",[t._v("AR_IO_WALLET")]),t._v(" "),e("td",[t._v("String")]),t._v(" "),e("td",[t._v('""')]),t._v(" "),e("td",[t._v("Arweave wallet address used for staking and rewards")])]),t._v(" "),e("tr",[e("th",[t._v("ADMIN_API_KEY")]),t._v(" "),e("td",[t._v("String")]),t._v(" "),e("td",[t._v("Generated")]),t._v(" "),e("td",[t._v("API key used for admin API requests (if not set, it is generated and logged into the console)")])]),t._v(" "),e("tr",[e("th",[t._v("BACKFILL_BUNDLE_RECORDS")]),t._v(" "),e("td",[t._v("Boolean")]),t._v(" "),e("td",[t._v("false")]),t._v(" "),e("td",[t._v("If true, AR.IO node will start indexing missing bundles")])]),t._v(" "),e("tr",[e("th",[t._v("FILTER_CHANGE_REPROCESS")]),t._v(" "),e("td",[t._v("Boolean")]),t._v(" "),e("td",[t._v("false")]),t._v(" "),e("td",[t._v("If true, all indexed bundles will be reprocessed with the new filters (you can use this when you change the filters)")])]),t._v(" "),e("tr",[e("th",[t._v("ANS104_UNBUNDLE_FILTER")]),t._v(" "),e("td",[t._v("String")]),t._v(" "),e("td",[t._v('{"never": true}')]),t._v(" "),e("td",[t._v("Only bundles compliant with this filter will be unbundled")])]),t._v(" "),e("tr",[e("th",[t._v("ANS104_INDEX_FILTER")]),t._v(" "),e("td",[t._v("String")]),t._v(" "),e("td",[t._v('{"never": true}')]),t._v(" "),e("td",[t._v("Only bundles compliant with this filter will be indexed")])]),t._v(" "),e("tr",[e("th",[t._v("ARNS_ROOT_HOST")]),t._v(" "),e("td",[t._v("String")]),t._v(" "),e("td",[t._v("undefined")]),t._v(" "),e("td",[t._v("Domain name for ArNS host")])]),t._v(" "),e("tr",[e("th",[t._v("SANDBOX_PROTOCOL")]),t._v(" "),e("td",[t._v("String")]),t._v(" "),e("td",[t._v("undefined")]),t._v(" "),e("td",[t._v('Protocol setting in process of creating sandbox domains in ArNS (ARNS_ROOT_HOST needs to be set for this env to have any effect) accepts "http" or "https"')])]),t._v(" "),e("tr",[e("th",[t._v("START_WRITERS")]),t._v(" "),e("td",[t._v("Boolean")]),t._v(" "),e("td",[t._v("true")]),t._v(" "),e("td",[t._v("If true, start indexing blocks, tx, ANS104 bundles")])]),t._v(" "),e("tr",[e("th",[t._v("RUN_OBSERVER")]),t._v(" "),e("td",[t._v("Boolean")]),t._v(" "),e("td",[t._v("true")]),t._v(" "),e("td",[t._v("If true, runs the Observer alongside the gateway to generate Network compliance reports")])]),t._v(" "),e("tr",[e("th",[t._v("MIN_RELEASE_NUMBER")]),t._v(" "),e("td",[t._v("string")]),t._v(" "),e("td",[t._v('"0"')]),t._v(" "),t._v("Sets the minimum Gateway release version to check while doing a gateway version assessment")]),t._v(" "),e("tr",[e("th",[t._v("AR_IO_NODE_RELEASE")]),t._v(" "),e("td",[t._v("string")]),t._v(" "),e("td",[t._v('"0"')]),t._v(" "),t._v("Sets the current ar.io node version to be set on X-AR-IO-Node-Release header on requests to the reference gateway")]),t._v(" "),e("tr",[e("th",[t._v("OBSERVER_WALLET")]),t._v(" "),e("td",[t._v("String")]),t._v(" "),e("td",[t._v("undefined")]),t._v(" "),e("td",[t._v("The public wallet address of the wallet being used to sign report upload transactions for Observer")])]),t._v(" "),e("tr",[e("th",[t._v("CHUNKS_DATA_PATH")]),t._v(" "),e("td",[t._v("string")]),t._v(" "),e("td",[t._v('"data/chunks"')]),t._v(" "),t._v("Sets the location for chunked data to be saved. If omitted, chunked data will be stored in the `data` directory")]),t._v(" "),e("tr",[e("th",[t._v("CONTIGUOUS_DATA_PATH")]),t._v(" "),e("td",[t._v("string")]),t._v(" "),e("td",[t._v('"data/contiguous"')]),t._v(" "),t._v("Sets the location for contiguous data to be saved. If omitted, contiguous data will be stored in the `data` directory")]),t._v(" "),e("tr",[e("th",[t._v("HEADERS_DATA_PATH")]),t._v(" "),e("td",[t._v("string")]),t._v(" "),e("td",[t._v('"data/headers"')]),t._v(" "),t._v("Sets the location for header data to be saved. If omitted, header data will be stored in the `data` directory")]),t._v(" "),e("tr",[e("th",[t._v("SQLITE_DATA_PATH")]),t._v(" "),e("td",[t._v("string")]),t._v(" "),e("td",[t._v('"data/sqlite"')]),t._v(" "),t._v("Sets the location for sqlite indexed data to be saved. If omitted, sqlite data will be stored in the `data` directory")]),t._v(" "),e("tr",[e("th",[t._v("TEMP_DATA_PATH")]),t._v(" "),e("td",[t._v("string")]),t._v(" "),e("td",[t._v('"data/tmp"')]),t._v(" "),t._v("Sets the location for temporary data to be saved. If omitted, temporary data will be stored in the `data` directory")]),t._v(" "),e("tr",[e("th",[t._v("LMDB_DATA_PATH")]),t._v(" "),e("td",[t._v("string")]),t._v(" "),e("td",[t._v('"data/LMDB"')]),t._v(" "),t._v("Sets the location for LMDB data to be saved. If omitted, LMDB data will be stored in the `data` directory")]),t._v(" "),e("tr",[e("th",[t._v("CHAIN_CACHE_TYPE")]),t._v(" "),e("td",[t._v("String")]),t._v(" "),e("td",[t._v('"redis"')]),t._v(" "),e("td",[t._v("Sets the method for caching chain data, defaults to redis if gateway is started with docker-compose, otherwise defaults to LMDB")])]),t._v(" "),e("tr",[e("th",[t._v("REDIS_CACHE_URL")]),t._v(" "),e("td",[t._v("String (URL)")]),t._v(" "),e("td",[t._v('"redis://localhost:6379"')]),t._v(" "),e("td",[t._v("URL of Redis database to be used for caching")])]),t._v(" "),e("tr",[e("th",[t._v("REDIS_CACHE_TTL_SECONDS")]),t._v(" "),e("td",[t._v("Number")]),t._v(" "),e("td",[t._v("28800")]),t._v(" "),e("td",[t._v("TTL value for Redis cache, defaults to 8 hours (28800 seconds)")])]),t._v(" "),e("tr",[e("th",[t._v("ENABLE_FS_HEADER_CACHE_CLEANUP")]),t._v(" "),e("td",[t._v("Boolean")]),t._v(" "),e("td",[t._v("false")]),t._v(" "),e("td",[t._v("If true, periodically deletes cached header data")])]),t._v(" "),e("tr",[e("th",[t._v("NODE_JS_MAX_OLD_SPACE_SIZE")]),t._v(" "),e("td",[t._v("Number")]),t._v(" "),e("td",[t._v("system default")]),t._v(" "),e("td",[t._v("Sets the memory limit, in Megabytes, for NodeJs. Default value depends on hardware")])]),t._v(" "),e("tr",[e("th",[t._v("SUBMIT_CONTRACT_INTERACTIONS")]),t._v(" "),e("td",[t._v("Boolean")]),t._v(" "),e("td",[t._v("true")]),t._v(" "),e("td",[t._v("If true, Observer will submit its generated reports to the ar.io Network. If false, reports will be generated but not submitted")])]),t._v(" "),e("tr",[e("th",[t._v("REDIS_MAX_MEMORY")]),t._v(" "),e("td",[t._v("String")]),t._v(" "),e("td",[t._v("256mb")]),t._v(" "),e("td",[t._v("Sets the max memory allocated to Redis")])]),t._v(" "),e("tr",[e("th",[t._v("REDIS_EXTRA_FLAGS")]),t._v(" "),e("td",[t._v("String")]),t._v(" "),e("td",[t._v('--save "" --appendonly no')]),t._v(" "),e("td",[t._v("Additional CLI flags passed to Redis")])]),t._v(" "),e("tr",[e("th",[t._v("WEBHOOK_TARGET_SERVERS")]),t._v(" "),e("td",[t._v("String")]),t._v(" "),e("td",[t._v("undefined")]),t._v(" "),e("td",[t._v("Target servers for webhooks")])]),t._v(" "),e("tr",[e("th",[t._v("WEBHOOK_INDEX_FILTER")]),t._v(" "),e("td",[t._v("String")]),t._v(" "),e("td",[t._v('{"never": true}')]),t._v(" "),e("td",[t._v("Only emit webhooks for transactions and data items compliant with this filter")])]),t._v(" "),e("tr",[e("th",[t._v("WEBHOOK_BLOCK_FILTER")]),t._v(" "),e("td",[t._v("String")]),t._v(" "),e("td",[t._v('{"never": true}')]),t._v(" "),e("td",[t._v("Only emit webhooks for blocks compliant with this filter")])]),t._v(" "),e("tr",[e("th",[t._v("CONTIGUOUS_DATA_CACHE_CLEANUP_THRESHOLD")]),t._v(" "),e("td",[t._v("Number")]),t._v(" "),e("td",[t._v("undefined")]),t._v(" "),e("td",[t._v("Sets the age threshold in seconds; files older than this are candidates for contiguous data cache cleanup")])]),t._v(" "),e("tr",[e("th",[t._v("RUN_RESOLVER")]),t._v(" "),e("td",[t._v("Boolean")]),t._v(" "),e("td",[t._v("false")]),t._v(" "),e("td",[t._v("If true, enables the experimental local ArNS resolver service")])]),t._v(" "),e("tr",[e("th",[t._v("TRUSTED_ARNS_RESOLVER_TYPE")]),t._v(" "),e("td",[t._v("String")]),t._v(" "),e("td",[t._v("gateway")]),t._v(" "),e("td",[t._v("Sets the type of ArNS resolver the gateway will use, either `gateway` or `resolver`. Set `resolver` to use experimental local ArNS resolver.")])]),t._v(" "),e("tr",[e("th",[t._v("TRUSTED_ARNS_RESOLVER_URL")]),t._v(" "),e("td",[t._v("String")]),t._v(" "),e("td",[t._v("https:__NAME__.arweave.dev")]),t._v(" "),e("td",[t._v("Sets the url a gateway will use to request ArNS name resolution when type is set to `resolver`")])]),t._v(" "),e("tr",[e("th",[t._v("ENABLE_MEMPOOL_WATCHER")]),t._v(" "),e("td",[t._v("Boolean")]),t._v(" "),e("td",[t._v("false")]),t._v(" "),e("td",[t._v("If true, the gateway will start indexing pending tx from the mempool")])]),t._v(" "),e("tr",[e("th",[t._v("MEMPOOL_POLLING_INTERVAL_MS")]),t._v(" "),e("td",[t._v("Number")]),t._v(" "),e("td",[t._v("30000")]),t._v(" "),e("td",[t._v("Sets the mempool Polling interval, in milliseconds")])])])])])}),[],!1,null,null,null);e.default=r.exports}}]); \ No newline at end of file diff --git a/assets/js/45.d3bea9da.js b/assets/js/45.d33d7b87.js similarity index 98% rename from assets/js/45.d3bea9da.js rename to assets/js/45.d33d7b87.js index ac1dc07a..084e555c 100644 --- a/assets/js/45.d3bea9da.js +++ b/assets/js/45.d33d7b87.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[45],{345:function(e,a,t){"use strict";t.r(a);var r=t(10),s=Object(r.a)({},(function(){var e=this,a=e._self._c;return a("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[a("h1",{attrs:{id:"farcaster-frames"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#farcaster-frames"}},[e._v("#")]),e._v(" Farcaster Frames")]),e._v(" "),a("h2",{attrs:{id:"overview"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#overview"}},[e._v("#")]),e._v(" Overview")]),e._v(" "),a("p",[a("a",{attrs:{href:"https://docs.farcaster.xyz/learn/what-is-farcaster/frames",target:"_blank",rel:"noopener noreferrer"}},[e._v("Frames by Farcaster"),a("OutboundLink")],1),e._v(' is a standard for posts, or "casts", that allows them to be interactive and easily authenticated self contained apps. Because the standard relies on HTML Meta tags, they can easily be integrated into dApps hosted permanently on Arweave. Until recently, the full capabilities of Frames hosted on Arweave were not accessible through ar.io gateways. This is because a specific type of interaction between the frame and the hosting server, a '),a("code",[e._v("POST")]),e._v(", is needed to facilitate interactivity, and ar.io gateways did not support this interaction type.")]),e._v(" "),a("h2",{attrs:{id:"experimental-gateway-support"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#experimental-gateway-support"}},[e._v("#")]),e._v(" Experimental Gateway Support")]),e._v(" "),a("p",[e._v("With "),a("RouterLink",{attrs:{to:"/gateways/ar-io-node/release-notes.html#release-9---2024-04-10"}},[e._v("Release 9")]),e._v(" of the ar.io gateways, a new experimental endpoint was added that supports the "),a("code",[e._v("POST")]),e._v(" requests needed by frames. The "),a("code",[e._v("/local")]),e._v(" endpoint on a gateway is used to facilitate experimental new features, as well as features which may be specific to an individual gateway. Operators and users should be fully aware that all endpoints stemming from "),a("code",[e._v("/local")]),e._v(" are experimental, and may not always perform exactly as expected.")],1),e._v(" "),a("h2",{attrs:{id:"using-frames"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#using-frames"}},[e._v("#")]),e._v(" Using Frames")]),e._v(" "),a("p",[e._v("The full path for accessing a frame hosted on Arweave is "),a("code",[e._v("https:///local/farcaster/frame/")]),e._v(" where "),a("code",[e._v("")]),e._v(" represents any ar.io gateway using release 9 or higher, and "),a("code",[e._v("")]),e._v(" represents the txId of the frame on Arweave. Since frames require full, absolute url paths, you will need to choose specific, supported gateway when you are embedding the frame in your cast.")]),e._v(" "),a("p",[e._v("Beyond that, simply embed the url for a frame in a cast and farcaster will be able to render it.")]),e._v(" "),a("h2",{attrs:{id:"example"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#example"}},[e._v("#")]),e._v(" Example")]),e._v(" "),a("p",[e._v("Arweave community member K, who is a pioneer in permaweb frames, created the below frame to demonstrate how permaweb frames can be interactive when embedded from ar.io gateways.")]),e._v(" "),a("p",[e._v("The ID for the frame he uploaded to Arweave is "),a("code",[e._v("JFfYkpW5--I5UOxnJTYHhY9-F8X6WrvDsXQv8jYr0WE")]),e._v(". Using this, He made a Farcaster cast with the embedded url "),a("code",[e._v("https://erl5reuvxh56eokq5rtsknqhqwhx4f6f7jnlxq5roqx7enrl2fqq.ar-io.dev/local/farcaster/frame/JFfYkpW5--I5UOxnJTYHhY9-F8X6WrvDsXQv8jYr0WE/")]),e._v(". This full url includes the "),a("RouterLink",{attrs:{to:"/concepts/sandboxing.html"}},[e._v("sandbox")]),e._v(" prefix generated by an ar.io gateway when serving content.")],1),e._v(" "),a("p",[e._v("When embedding this full url in a cast, farcaster will render the content into a frame:")]),e._v(" "),a("center",[a("img",{attrs:{src:e.$withBase("/images/frame.png")}})]),e._v(" "),a("p",[e._v("View the original post "),a("a",{attrs:{href:"https://warpcast.com/fllstck/0x3d5fb763",target:"_blank",rel:"noopener noreferrer"}},[e._v("here"),a("OutboundLink")],1),e._v(" to experience the interactivity first hand.")])],1)}),[],!1,null,null,null);a.default=s.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[45],{346:function(e,a,t){"use strict";t.r(a);var r=t(10),s=Object(r.a)({},(function(){var e=this,a=e._self._c;return a("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[a("h1",{attrs:{id:"farcaster-frames"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#farcaster-frames"}},[e._v("#")]),e._v(" Farcaster Frames")]),e._v(" "),a("h2",{attrs:{id:"overview"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#overview"}},[e._v("#")]),e._v(" Overview")]),e._v(" "),a("p",[a("a",{attrs:{href:"https://docs.farcaster.xyz/learn/what-is-farcaster/frames",target:"_blank",rel:"noopener noreferrer"}},[e._v("Frames by Farcaster"),a("OutboundLink")],1),e._v(' is a standard for posts, or "casts", that allows them to be interactive and easily authenticated self contained apps. Because the standard relies on HTML Meta tags, they can easily be integrated into dApps hosted permanently on Arweave. Until recently, the full capabilities of Frames hosted on Arweave were not accessible through ar.io gateways. This is because a specific type of interaction between the frame and the hosting server, a '),a("code",[e._v("POST")]),e._v(", is needed to facilitate interactivity, and ar.io gateways did not support this interaction type.")]),e._v(" "),a("h2",{attrs:{id:"experimental-gateway-support"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#experimental-gateway-support"}},[e._v("#")]),e._v(" Experimental Gateway Support")]),e._v(" "),a("p",[e._v("With "),a("RouterLink",{attrs:{to:"/gateways/ar-io-node/release-notes.html#release-9---2024-04-10"}},[e._v("Release 9")]),e._v(" of the ar.io gateways, a new experimental endpoint was added that supports the "),a("code",[e._v("POST")]),e._v(" requests needed by frames. The "),a("code",[e._v("/local")]),e._v(" endpoint on a gateway is used to facilitate experimental new features, as well as features which may be specific to an individual gateway. Operators and users should be fully aware that all endpoints stemming from "),a("code",[e._v("/local")]),e._v(" are experimental, and may not always perform exactly as expected.")],1),e._v(" "),a("h2",{attrs:{id:"using-frames"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#using-frames"}},[e._v("#")]),e._v(" Using Frames")]),e._v(" "),a("p",[e._v("The full path for accessing a frame hosted on Arweave is "),a("code",[e._v("https:///local/farcaster/frame/")]),e._v(" where "),a("code",[e._v("")]),e._v(" represents any ar.io gateway using release 9 or higher, and "),a("code",[e._v("")]),e._v(" represents the txId of the frame on Arweave. Since frames require full, absolute url paths, you will need to choose specific, supported gateway when you are embedding the frame in your cast.")]),e._v(" "),a("p",[e._v("Beyond that, simply embed the url for a frame in a cast and farcaster will be able to render it.")]),e._v(" "),a("h2",{attrs:{id:"example"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#example"}},[e._v("#")]),e._v(" Example")]),e._v(" "),a("p",[e._v("Arweave community member K, who is a pioneer in permaweb frames, created the below frame to demonstrate how permaweb frames can be interactive when embedded from ar.io gateways.")]),e._v(" "),a("p",[e._v("The ID for the frame he uploaded to Arweave is "),a("code",[e._v("JFfYkpW5--I5UOxnJTYHhY9-F8X6WrvDsXQv8jYr0WE")]),e._v(". Using this, He made a Farcaster cast with the embedded url "),a("code",[e._v("https://erl5reuvxh56eokq5rtsknqhqwhx4f6f7jnlxq5roqx7enrl2fqq.ar-io.dev/local/farcaster/frame/JFfYkpW5--I5UOxnJTYHhY9-F8X6WrvDsXQv8jYr0WE/")]),e._v(". This full url includes the "),a("RouterLink",{attrs:{to:"/concepts/sandboxing.html"}},[e._v("sandbox")]),e._v(" prefix generated by an ar.io gateway when serving content.")],1),e._v(" "),a("p",[e._v("When embedding this full url in a cast, farcaster will render the content into a frame:")]),e._v(" "),a("center",[a("img",{attrs:{src:e.$withBase("/images/frame.png")}})]),e._v(" "),a("p",[e._v("View the original post "),a("a",{attrs:{href:"https://warpcast.com/fllstck/0x3d5fb763",target:"_blank",rel:"noopener noreferrer"}},[e._v("here"),a("OutboundLink")],1),e._v(" to experience the interactivity first hand.")])],1)}),[],!1,null,null,null);a.default=s.exports}}]); \ No newline at end of file diff --git a/assets/js/48.7fcf51c8.js b/assets/js/48.90c83ae1.js similarity index 98% rename from assets/js/48.7fcf51c8.js rename to assets/js/48.90c83ae1.js index 3e8f29b0..80c41637 100644 --- a/assets/js/48.7fcf51c8.js +++ b/assets/js/48.90c83ae1.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[48],{351:function(e,t,o){"use strict";o.r(t);var r=o(10),a=Object(r.a)({},(function(){var e=this,t=e._self._c;return t("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[t("h1",{attrs:{id:"upgrading-to-the-observer-module"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#upgrading-to-the-observer-module"}},[e._v("#")]),e._v(" Upgrading to the Observer Module")]),e._v(" "),t("h2",{attrs:{id:"overview"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#overview"}},[e._v("#")]),e._v(" Overview")]),e._v(" "),t("p",[e._v('From time to time, significant updates to the AR.IO Gateway node software might necessitate additional configuration steps to harness the entirety of the new features. The recent addition of the "Observer" module, designed to monitor the health of the AR.IO network, is a case in point. To integrate this module successfully, users will need to undertake two supplementary steps beyond the conventional upgrade routine:')]),e._v(" "),t("ol",[t("li",[t("p",[e._v("Supply the keyfile for an active Arweave wallet.")])]),e._v(" "),t("li",[t("p",[e._v("Configure specific environmental variables.")])])]),e._v(" "),t("p",[e._v("Both of these steps can be completed during the "),t("RouterLink",{attrs:{to:"/gateways/ar-io-node/upgrading.html"}},[e._v("normal upgrade process")]),e._v(" "),t("strong",[e._v("BEFORE")]),e._v(" you rebuild your gateway (step #5).")],1),e._v(" "),t("h2",{attrs:{id:"supply-a-keyfile"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#supply-a-keyfile"}},[e._v("#")]),e._v(" Supply a Keyfile")]),e._v(" "),t("p",[e._v("A primary function of the Observer Module is to upload reports on the health of the AR.IO network to the Arweave blockweave. In order to do this, transactions must be signed and paid for. This requires the keyfile for an Arweave wallet be provided to your gateway.")]),e._v(" "),t("p",[e._v("You may use the same wallet linked to your gateway in the AR.IO network ("),t("code",[e._v("AR_IO_WALLET")]),e._v(" in your "),t("code",[e._v(".env")]),e._v(' file) but in most situations it is safer to use a separate fresh wallet, or a "hot" wallet you use for safely interacting with Dapps, especially if you host your gateway on a remote server where other people may have access. Find more information about creating fresh wallets '),t("a",{attrs:{href:"https://ar.io/wallet/",target:"_blank",rel:"noopener noreferrer"}},[e._v("here"),t("OutboundLink")],1),e._v(".")]),e._v(" "),t("p",[e._v("Remember, your keyfile contains the public keys to your Arweave wallet, always be extremely careful not to expose it to unsafe conditions.")]),e._v(" "),t("p",[e._v("Your keyfile must be saved in the new "),t("code",[e._v("wallets")]),e._v(" directory in the root of the gateway repository, with the name "),t("code",[e._v(".json")])]),e._v(" "),t("p",[e._v("For example: "),t("code",[e._v("QGWqtJdLLgm2ehFWiiPzMaoFLD50CnGuzZIPEdoDRGQ.json")])]),e._v(" "),t("h2",{attrs:{id:"environmental-variables"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#environmental-variables"}},[e._v("#")]),e._v(" Environmental variables")]),e._v(" "),t("p",[e._v("There are two new environmental variables that should be set when upgrading to Observer. Both of these should be added to the "),t("code",[e._v(".env")]),e._v(" file prior to rebuilding your gateway:")]),e._v(" "),t("ul",[t("li",[t("code",[e._v("RUN_OBSERVER")]),e._v(" (optional) - This is the on/off switch for Observer. The default value is "),t("code",[e._v("true")]),e._v(", so omitting this from your environmental variables will not prevent Observer from running. Set the value to "),t("code",[e._v("false")]),e._v(" if you want your gateway to run without Observer.\n"),t("ul",[t("li",[t("code",[e._v("RUN_OBSERVER=true")])])])]),e._v(" "),t("li",[t("code",[e._v("OBSERVER_WALLET")]),e._v(" - This should be set to the public address of the wallet you are using to sign Observer transactions.\n"),t("ul",[t("li",[t("code",[e._v("OBSERVER_WALLET=QGWqtJdLLgm2ehFWiiPzMaoFLD50CnGuzZIPEdoDRGQ")])])])])]),e._v(" "),t("p",[t("strong",[e._v("Note")]),e._v(": If you encounter any issues during the upgrade process, please seek assistance from the "),t("a",{attrs:{href:"https://discord.gg/QbryG7QukD",target:"_blank",rel:"noopener noreferrer"}},[e._v("AR.IO community"),t("OutboundLink")],1),e._v(".")])])}),[],!1,null,null,null);t.default=a.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[48],{348:function(e,t,o){"use strict";o.r(t);var r=o(10),a=Object(r.a)({},(function(){var e=this,t=e._self._c;return t("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[t("h1",{attrs:{id:"upgrading-to-the-observer-module"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#upgrading-to-the-observer-module"}},[e._v("#")]),e._v(" Upgrading to the Observer Module")]),e._v(" "),t("h2",{attrs:{id:"overview"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#overview"}},[e._v("#")]),e._v(" Overview")]),e._v(" "),t("p",[e._v('From time to time, significant updates to the AR.IO Gateway node software might necessitate additional configuration steps to harness the entirety of the new features. The recent addition of the "Observer" module, designed to monitor the health of the AR.IO network, is a case in point. To integrate this module successfully, users will need to undertake two supplementary steps beyond the conventional upgrade routine:')]),e._v(" "),t("ol",[t("li",[t("p",[e._v("Supply the keyfile for an active Arweave wallet.")])]),e._v(" "),t("li",[t("p",[e._v("Configure specific environmental variables.")])])]),e._v(" "),t("p",[e._v("Both of these steps can be completed during the "),t("RouterLink",{attrs:{to:"/gateways/ar-io-node/upgrading.html"}},[e._v("normal upgrade process")]),e._v(" "),t("strong",[e._v("BEFORE")]),e._v(" you rebuild your gateway (step #5).")],1),e._v(" "),t("h2",{attrs:{id:"supply-a-keyfile"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#supply-a-keyfile"}},[e._v("#")]),e._v(" Supply a Keyfile")]),e._v(" "),t("p",[e._v("A primary function of the Observer Module is to upload reports on the health of the AR.IO network to the Arweave blockweave. In order to do this, transactions must be signed and paid for. This requires the keyfile for an Arweave wallet be provided to your gateway.")]),e._v(" "),t("p",[e._v("You may use the same wallet linked to your gateway in the AR.IO network ("),t("code",[e._v("AR_IO_WALLET")]),e._v(" in your "),t("code",[e._v(".env")]),e._v(' file) but in most situations it is safer to use a separate fresh wallet, or a "hot" wallet you use for safely interacting with Dapps, especially if you host your gateway on a remote server where other people may have access. Find more information about creating fresh wallets '),t("a",{attrs:{href:"https://ar.io/wallet/",target:"_blank",rel:"noopener noreferrer"}},[e._v("here"),t("OutboundLink")],1),e._v(".")]),e._v(" "),t("p",[e._v("Remember, your keyfile contains the public keys to your Arweave wallet, always be extremely careful not to expose it to unsafe conditions.")]),e._v(" "),t("p",[e._v("Your keyfile must be saved in the new "),t("code",[e._v("wallets")]),e._v(" directory in the root of the gateway repository, with the name "),t("code",[e._v(".json")])]),e._v(" "),t("p",[e._v("For example: "),t("code",[e._v("QGWqtJdLLgm2ehFWiiPzMaoFLD50CnGuzZIPEdoDRGQ.json")])]),e._v(" "),t("h2",{attrs:{id:"environmental-variables"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#environmental-variables"}},[e._v("#")]),e._v(" Environmental variables")]),e._v(" "),t("p",[e._v("There are two new environmental variables that should be set when upgrading to Observer. Both of these should be added to the "),t("code",[e._v(".env")]),e._v(" file prior to rebuilding your gateway:")]),e._v(" "),t("ul",[t("li",[t("code",[e._v("RUN_OBSERVER")]),e._v(" (optional) - This is the on/off switch for Observer. The default value is "),t("code",[e._v("true")]),e._v(", so omitting this from your environmental variables will not prevent Observer from running. Set the value to "),t("code",[e._v("false")]),e._v(" if you want your gateway to run without Observer.\n"),t("ul",[t("li",[t("code",[e._v("RUN_OBSERVER=true")])])])]),e._v(" "),t("li",[t("code",[e._v("OBSERVER_WALLET")]),e._v(" - This should be set to the public address of the wallet you are using to sign Observer transactions.\n"),t("ul",[t("li",[t("code",[e._v("OBSERVER_WALLET=QGWqtJdLLgm2ehFWiiPzMaoFLD50CnGuzZIPEdoDRGQ")])])])])]),e._v(" "),t("p",[t("strong",[e._v("Note")]),e._v(": If you encounter any issues during the upgrade process, please seek assistance from the "),t("a",{attrs:{href:"https://discord.gg/QbryG7QukD",target:"_blank",rel:"noopener noreferrer"}},[e._v("AR.IO community"),t("OutboundLink")],1),e._v(".")])])}),[],!1,null,null,null);t.default=a.exports}}]); \ No newline at end of file diff --git a/assets/js/50.d2a870bf.js b/assets/js/50.14982568.js similarity index 91% rename from assets/js/50.d2a870bf.js rename to assets/js/50.14982568.js index bf77f827..76e1fa38 100644 --- a/assets/js/50.d2a870bf.js +++ b/assets/js/50.14982568.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[50],{348:function(e,t,s){"use strict";s.r(t);var n=s(10),o=Object(n.a)({},(function(){var e=this._self._c;return e("ContentSlotsDistributor",{attrs:{"slot-key":this.$parent.slotKey}},[e("h1",{attrs:{id:"overview"}},[e("a",{staticClass:"header-anchor",attrs:{href:"#overview"}},[this._v("#")]),this._v(" Overview")]),this._v(" "),e("p",[this._v("Easy setup guides have been designed to get your AR.IO Gateway up and running correctly and quickly. These guides only go through some basic configurations, while more advanced options can be found "),e("RouterLink",{attrs:{to:"/gateways/ar-io-node/advanced-config.html"}},[this._v("here")])],1)])}),[],!1,null,null,null);t.default=o.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[50],{350:function(e,t,s){"use strict";s.r(t);var n=s(10),o=Object(n.a)({},(function(){var e=this._self._c;return e("ContentSlotsDistributor",{attrs:{"slot-key":this.$parent.slotKey}},[e("h1",{attrs:{id:"overview"}},[e("a",{staticClass:"header-anchor",attrs:{href:"#overview"}},[this._v("#")]),this._v(" Overview")]),this._v(" "),e("p",[this._v("Easy setup guides have been designed to get your AR.IO Gateway up and running correctly and quickly. These guides only go through some basic configurations, while more advanced options can be found "),e("RouterLink",{attrs:{to:"/gateways/ar-io-node/advanced-config.html"}},[this._v("here")])],1)])}),[],!1,null,null,null);t.default=o.exports}}]); \ No newline at end of file diff --git a/assets/js/51.50845030.js b/assets/js/51.748d35ca.js similarity index 85% rename from assets/js/51.50845030.js rename to assets/js/51.748d35ca.js index 1e14b7b5..2451cf7a 100644 --- a/assets/js/51.50845030.js +++ b/assets/js/51.748d35ca.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[51],{350:function(e,t,a){"use strict";a.r(t);var r=a(10),o=Object(r.a)({},(function(){var e=this,t=e._self._c;return t("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[t("h1",{attrs:{id:"ar-io-release-notes"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#ar-io-release-notes"}},[e._v("#")]),e._v(" ar.io Release Notes")]),e._v(" "),t("h2",{attrs:{id:"overview"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#overview"}},[e._v("#")]),e._v(" Overview")]),e._v(" "),t("p",[e._v("Welcome to the documentation page for the ar.io gateway release notes. Here, you will find detailed information about each version of the ar.io gateway, including the enhancements, bug fixes, and any other changes introduced in every release. This page serves as a comprehensive resource to keep you informed about the latest developments and updates in the ar.io gateway. For those interested in exploring the source code, each release's code is readily accessible at our GitHub repository: ar.io gateway "),t("a",{attrs:{href:"https://github.com/ar-io/ar-io-node/blob/main/CHANGELOG.md",target:"_blank",rel:"noopener noreferrer"}},[e._v("change logs"),t("OutboundLink")],1),e._v(". Stay updated with the continuous improvements and advancements in the ar.io gateway by referring to this page for all release-related information.")]),e._v(" "),t("h2",{attrs:{id:"release-16-2024-08-09"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#release-16-2024-08-09"}},[e._v("#")]),e._v(" [Release 16] - 2024-08-09")]),e._v(" "),t("ul",[t("li",[t("p",[t("strong",[e._v("Fixed")])]),e._v(" "),t("ul",[t("li",[e._v("Fixed promise leak caused by missing await when saving data items to the DB.")]),e._v(" "),t("li",[e._v("Modified ArNS middleware to not attempt resolution when receiving requests for a different hostname than the one specified by "),t("code",[e._v("ARNS_ROOT_HOST")]),e._v(".")])])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Added")])]),e._v(" "),t("ul",[t("li",[e._v("Added support for returning "),t("code",[e._v("Content-Encoding")]),e._v(" HTTP headers based on user specified Content-Encoding tags.")]),e._v(" "),t("li",[e._v("Added "),t("code",[e._v("isNestedBundle")]),e._v(" filter enables that matches any nested bundle when indexing. This enables composite unbundling filters that match a set of L1 tags and bundles nested under them.")]),e._v(" "),t("li",[e._v("Added ability to skip writing ANS-104 signatures to the DB and load them based on offsets from the data instead. This significantly reduces the size of the bundles DB. It can be enabled by setting the "),t("code",[e._v("WRITE_ANS104_DATA_ITEM_DB_SIGNATURES")]),e._v(" environment variable to false.")]),e._v(" "),t("li",[e._v("Added "),t("code",[e._v("data_item_data_indexed_total")]),e._v(" Prometheus counter to count data items with data attributes indexed.")])])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Changed")])]),e._v(" "),t("ul",[t("li",[e._v("Queue data attributes writes when serving data rather than writing them syncronously.")]),e._v(" "),t("li",[e._v("Reduced the default data indexer count to 1 to lessen the load on the data DB.")]),e._v(" "),t("li",[e._v("Switched a number of overly verbose info logs to debug level.")]),e._v(" "),t("li",[e._v("Removed docker-compose on-failure restart limits to ensure that services restart no matter how many times they fail.")]),e._v(" "),t("li",[e._v("Modified the "),t("code",[e._v("data_items_indexed_total")]),e._v(" Prometheus counter to count data items indexed for GraphQL querying instead of data attributes.")]),e._v(" "),t("li",[e._v("Increased aggressiveness of contiguous data cleanup. It now pauses 5 seconds instead of 10 seconds per batch and runs every 4 hours instead of every 24 hours.")])])])]),e._v(" "),t("h2",{attrs:{id:"release-15-2024-07-19"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#release-15-2024-07-19"}},[e._v("#")]),e._v(" [Release 15] - 2024-07-19")]),e._v(" "),t("ul",[t("li",[t("p",[t("strong",[e._v("Fixed")])]),e._v(" "),t("ul",[t("li",[e._v("Fixed query error that was preventing bundles from being marked as fully imported in the database.")])])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Added")])]),e._v(" "),t("ul",[t("li",[e._v("Adjusted data item indexing to record data item signature types in the DB. This helps distinguish between signatures using different key formats, and will enable querying by signature type in the future.")]),e._v(" "),t("li",[e._v("Adjusted data item indexing to record offsets for data items within bundles and signatures and owners within data items. In the future this will allow us to avoid saving owners and signatures in the DB and thus considerably reduce the size of the bundles DB.")]),e._v(" "),t("li",[e._v("Added "),t("code",[e._v("ARNS_CACHE_TTL_MS")]),e._v(" environment variable to control the TTL of ARNS cache entries (defaults to 1 hour).")]),e._v(" "),t("li",[e._v("Added support for multiple ranges in a single HTTP range request.")]),e._v(" "),t("li",[e._v("Added experimental chunk POST endpoint that broadcasts chunks to the comma-separate list of URLS in the "),t("code",[e._v("CHUNK_BROADCAST_URLS")]),e._v(" environment variable. It is available at "),t("code",[e._v("/chunk")]),e._v(" on the internal gateway service port (4000 by default) but is not yet exposed through Envoy.")]),e._v(" "),t("li",[e._v("Added support for running an AO CU adjacent to the gateway (see README.md for details).")]),e._v(" "),t("li",[e._v("Added "),t("code",[e._v("X-ArNS-Process-Id")]),e._v(" to ArNS resolved name headers.")]),e._v(" "),t("li",[e._v("Added a set of "),t("code",[e._v("AO_...")]),e._v(" environment variables for specifying which AO URLs should be used (see "),t("code",[e._v("docker-compose.yaml")]),e._v(" for the complete list). The "),t("code",[e._v("AO_CU_URL")]),e._v(" is of particular use since the core and resolver services only perform AO reads and only the CU is needed for reads.")])])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Changed")])]),e._v(" "),t("ul",[t("li",[e._v("Split the monolithic "),t("code",[e._v("docker-compose.yaml")]),e._v(" into "),t("code",[e._v("docker-compose.yaml")]),e._v(", "),t("code",[e._v("docker-compose.bundler.yaml")]),e._v(", and "),t("code",[e._v("docker-compose.ao.yaml")]),e._v(" (see README for details).")]),e._v(" "),t("li",[e._v("Replaced references to 'docker-compose' with 'docker compose' in the docs since the former is mostly deprecated.")]),e._v(" "),t("li",[e._v("Reduce max fork depth from 50 to 18 inline to reflect Arweave 2.7.2 protocol changes.")]),e._v(" "),t("li",[e._v("Increased the aggressiveness of bundle reprocessing by reducing reprocessing interval from 10 minutes to 5 minutes and raising reprocessing batch size from 100 to 1000.")]),e._v(" "),t("li",[e._v("Use a patched version of Litestream to work around insufficient S3 multipart upload size in the upstream version.")])])])]),e._v(" "),t("h2",{attrs:{id:"release-14-2024-06-26"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#release-14-2024-06-26"}},[e._v("#")]),e._v(" [Release 14] - 2024-06-26")]),e._v(" "),t("ul",[t("li",[t("p",[t("strong",[e._v("Fixed")])]),e._v(" "),t("ul",[t("li",[e._v("Correctly handle manifest "),t("code",[e._v("index")]),e._v(" after "),t("code",[e._v("paths")]),e._v(".")])])])]),e._v(" "),t("h2",{attrs:{id:"release-13-2024-06-24"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#release-13-2024-06-24"}},[e._v("#")]),e._v(" [Release 13] - 2024-06-24")]),e._v(" "),t("ul",[t("li",[t("p",[t("strong",[e._v("Added")])]),e._v(" "),t("ul",[t("li",[e._v("Added support for optimistically reading data items uploaded using the integrated Turbo bundler via the LocalStack S3 interface.")]),e._v(" "),t("li",[e._v("Added "),t("code",[e._v("X-AR-IO-Origin-Node-Release")]),e._v(" header to outbound data requests.")]),e._v(" "),t("li",[e._v("Added "),t("code",[e._v("hops")]),e._v(", "),t("code",[e._v("origin")]),e._v(", and "),t("code",[e._v("originNodeRelease")]),e._v(" query params to outbound data requests.")]),e._v(" "),t("li",[e._v("Added support for "),t("code",[e._v("fallback")]),e._v(" in v0.2 manifests that is used if no path in the manifest is matched.")])])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Changed")])]),e._v(" "),t("ul",[t("li",[e._v("Updated Observer to read prescribed names from and write observations to the ar.io AO network process.")]),e._v(" "),t("li",[e._v("Updated Resolver to read from the ar.io AO network process.")])])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Fixed")])]),e._v(" "),t("ul",[t("li",[e._v("Modified optimistic indexing of data items to use a null "),t("code",[e._v("parent_id")]),e._v(" when inserting into the DB instead of a placeholder value. This prevents unexpected non-null "),t("code",[e._v("bundledIn")]),e._v(" values in GraphQL results for optimistically indexed data items.")]),e._v(" "),t("li",[e._v("Modified GraphQl query logic to require an ID for single block GraphQL queries. Previously queries missing an ID were returning an internal SQLite error. This represents a small departure from arweave.net's query logic which returns the latest block for these queries. We recommend querying "),t("code",[e._v("blocks")]),e._v(" instead of "),t("code",[e._v("block")]),e._v(" in cases where the latest block is desired.")]),e._v(" "),t("li",[e._v("Adjusted Observer health check to reflect port change to 5050.")])])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Security")])]),e._v(" "),t("ul",[t("li",[e._v("Modified docker-compose.yaml to only expose Redis, PostgreSQL, and LocalStack ports internally. This protects gateways that neglect to deploy behind a firewall, reverse proxy, or load balancer.")])])])]),e._v(" "),t("h2",{attrs:{id:"release-12-2024-06-05"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#release-12-2024-06-05"}},[e._v("#")]),e._v(" [Release 12] - 2024-06-05")]),e._v(" "),t("ul",[t("li",[t("p",[t("strong",[e._v("Added")])]),e._v(" "),t("ul",[t("li",[e._v("Added "),t("code",[e._v("/ar-io/admin/queue-data-item")]),e._v(" endpoint for queuing data item headers for indexing before the bundles containing them are processed. This allows trusted bundlers to make their data items quickly available to be queried via GraphQL without having to wait for bundle data submission or unbundling.")]),e._v(" "),t("li",[e._v("Added experimental support for retrieving contiguous data from S3. See "),t("code",[e._v("AWS_*")]),e._v(" "),t("a",{attrs:{href:""}},[e._v("environment variables documentation")]),e._v(" for configuration details. In conjuction with a local Turbo bundler this allows optimistic bundle (but not yet data item) retrieval.")]),e._v(" "),t("li",[e._v("Add experimental support for fetching data from gateway peers. It can be enabled by adding "),t("code",[e._v("ario-peer")]),e._v(" to "),t("code",[e._v("ON_DEMAND_RETRIEVAL_ORDER")]),e._v(". Note: do not expect this work reliably yet! This functionality is in active development and will be improved in future releases.")]),e._v(" "),t("li",[e._v("Add "),t("code",[e._v("import_attempt_count")]),e._v(" to "),t("code",[e._v("bundle")]),e._v(" records to enable future bundle import retry optimizations.")])])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Changed")])]),e._v(" "),t("ul",[t("li",[e._v("Removed "),t("code",[e._v("version")]),e._v(" from "),t("code",[e._v("docker-compose.yaml")]),e._v(" to avoid warnings with recent versions of "),t("code",[e._v("docker-compose")]),e._v(".")]),e._v(" "),t("li",[e._v("Switched default observer port from 5000 to 5050 to avoid conflict on OS X. Since Envoy is used to provide external access to the observer API this should have no user visible effect.")])])])]),e._v(" "),t("h2",{attrs:{id:"release-11-2024-05-21"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#release-11-2024-05-21"}},[e._v("#")]),e._v(" [Release 11] - 2024-05-21")]),e._v(" "),t("ul",[t("li",[t("p",[t("strong",[e._v("Added")])]),e._v(" "),t("ul",[t("li",[e._v("Added "),t("code",[e._v("arweave_tx_fetch_total")]),e._v(" Prometheus metric to track counts of transaction headers fetched from the trusted node and Arweave network peers.")])])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Changed")])]),e._v(" "),t("ul",[t("li",[e._v("Revert to using unnamed bind mounts due to cross platform issues with named volumes.")])])])]),e._v(" "),t("h2",{attrs:{id:"release-10-2024-05-20"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#release-10-2024-05-20"}},[e._v("#")]),e._v(" [Release 10] - 2024-05-20")]),e._v(" "),t("ul",[t("li",[t("p",[t("strong",[e._v("Added")])]),e._v(" "),t("ul",[t("li",[e._v("Added experimental support for streaming SQLite backups to S3 (and compatible services) using "),t("a",{attrs:{href:"https://litestream.io/",target:"_blank",rel:"noopener noreferrer"}},[e._v("Litestream"),t("OutboundLink")],1),e._v('. Start the service using the docker-compose "litestream" profile to use it, and see the '),t("code",[e._v("AR_IO_SQLITE_BACKUP_*")]),e._v(" "),t("a",{attrs:{href:"https://github.com/ar-io/ar-io-node/blob/r10-prep/docs/env.md",target:"_blank",rel:"noopener noreferrer"}},[e._v("environment variables documentation"),t("OutboundLink")],1),e._v(" for further details.")]),e._v(" "),t("li",[e._v("Added "),t("code",[e._v("/ar-io/admin/queue-bundle")]),e._v(" endpoint for queueing bundles for import for import before they're in the mempool. In the future this will enable optimistic indexing when combined with a local trusted bundler.")]),e._v(" "),t("li",[e._v("Added support for triggering webhooks when blocks are imported matching the filter specified by the "),t("code",[e._v("WEBHOOK_BLOCK_FILTER")]),e._v(" environment variable.")]),e._v(" "),t("li",[e._v("Added experimental support for indexing transactions and related data items from the mempool. Enable it by setting "),t("code",[e._v("ENABLE_MEMPOOL_WATCHER")]),e._v(" to 'true'.")]),e._v(" "),t("li",[e._v("Made on-demand data caching circuit breakers configurable via the "),t("code",[e._v("GET_DATA_CIRCUIT_BREAKER_TIMEOUT_MS")]),e._v(" environment variable. This allows gateway operators to decide how much latency they will tolerate when serving data in exchange for more complete data indexing and caching.")]),e._v(" "),t("li",[e._v("Rename cache header from "),t("code",[e._v("X-Cached")]),e._v(" to "),t("code",[e._v("X-Cache")]),e._v(" to mimic typical CDN practices.")]),e._v(" "),t("li",[e._v("Add X-AR-IO-Hops and X-AR-IO-Origin headers in preparation for future peer-to-peer functionality.")]),e._v(" "),t("li",[e._v("Upgrade to Node.js v20 and switch to native test runner.")])])])]),e._v(" "),t("h2",{attrs:{id:"release-9-2024-04-10"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#release-9-2024-04-10"}},[e._v("#")]),e._v(" [Release 9] - 2024-04-10")]),e._v(" "),t("ul",[t("li",[t("strong",[e._v("Added")]),e._v(" "),t("ul",[t("li",[e._v("Added experimental Farcaster Frames support, enabling simple Arweave based Frames with button navigation. Transaction and data item data is now served under "),t("code",[e._v("/local/farcaster/frame/")]),e._v(". "),t("code",[e._v("/local")]),e._v(" is used as a prefix to indicate this functionality is both experimental and local to a particular gateway rather than part of the global gateway API. Both GET and POST requests are supported.")]),e._v(" "),t("li",[e._v("Added an experimental local ArNS resolver. When enabled it removes dependence on arweave.net for ArNS resolution! Enable it by setting "),t("code",[e._v("RUN_RESOLVER=TRUE")]),e._v(", "),t("code",[e._v("TRUSTED_ARNS_RESOLVER_TYPE=resolver")]),e._v(", and "),t("code",[e._v("TRUSTED_ARNS_RESOLVER_URL=http://resolver:6000")]),e._v(" in your "),t("code",[e._v(".env")]),e._v(" file.")]),e._v(" "),t("li",[e._v("Added an "),t("code",[e._v("X-Cached")]),e._v(" header to data responses to indicate when data is served from the local cache rather than being retrieved from an external source. This is helpful for interfacing with external systems, debugging, and end-to-end testing.")]),e._v(" "),t("li",[e._v("Save hashes for unbundled data items during indexing. This enables reduction in data storage via hash based deduplication as well as more efficient peer-to-peer data retrieval in the future.")])])])]),e._v(" "),t("h2",{attrs:{id:"release-8-2024-03-14"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#release-8-2024-03-14"}},[e._v("#")]),e._v(" [Release 8] - 2024-03-14")]),e._v(" "),t("ul",[t("li",[t("p",[t("strong",[e._v("Added")])]),e._v(" "),t("ul",[t("li",[e._v("Added GraphQL SQL query debug logging to support trouble-shooting and performance optimization.")]),e._v(" "),t("li",[e._v("Added support for indexing data items (not GraphQL querying) based solely on tag name. (example use case: indexing all IPFS CID tagged data items).")])])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Changes")])]),e._v(" "),t("ul",[t("li",[e._v("Observer data sampling now uses randomized ranges to generate content hashes.")]),e._v(" "),t("li",[e._v("Reference gateway ArNS resolutions are now cached to improve report generation performance.")]),e._v(" "),t("li",[e._v("Contract interactions are now tested before posting using "),t("code",[e._v("dryWrite")]),e._v(" to avoid submitting interactions that would fail.")]),e._v(" "),t("li",[t("code",[e._v("/ar-io/observer/info")]),e._v(" now reports "),t("code",[e._v("INVALID")]),e._v(" for wallets that fail to load.")])])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Fixed")])]),e._v(" "),t("ul",[t("li",[e._v("Fix data caching failure caused by incorrect method name in "),t("code",[e._v("getData")]),e._v(" circuit breakers.")]),e._v(" "),t("li",[e._v("Fix healthcheck when "),t("code",[e._v("ARNS_ROOT_HOST")]),e._v(" includes a subdomain.")])])])]),e._v(" "),t("h2",{attrs:{id:"release-7-2024-02-14"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#release-7-2024-02-14"}},[e._v("#")]),e._v(" [Release 7] - 2024 - 02 - 14")]),e._v(" "),t("ul",[t("li",[t("p",[t("strong",[e._v("Added")])]),e._v(" "),t("ul",[t("li",[e._v("Add support for notifying other services of transactions and data items using webhooks (see README for details).")]),e._v(" "),t("li",[e._v("Add support for filter negation (particularly useful for excluding large bundles from indexint).")]),e._v(" "),t("li",[e._v("Improve unbundling throughput by decoupling data fetching from unbundling.")]),e._v(" "),t("li",[e._v("Add Envoy and core service ARM builds.")])])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Changed")])]),e._v(" "),t("ul",[t("li",[e._v("Improve resouce cleanup and shutdown behavior.")]),e._v(" "),t("li",[e._v("Don't save Redis data to disk by default to help prevent memory issues on startup for small gateways.")]),e._v(" "),t("li",[e._v("Reduce the amount of data sampled from large files by the observer.")]),e._v(" "),t("li",[e._v("Ensure block poa2 field is not chached to reduce memory consumption.")])])])]),e._v(" "),t("h2",{attrs:{id:"release-6-2024-01-29"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#release-6-2024-01-29"}},[e._v("#")]),e._v(" [Release 6] - 2024-01-29")]),e._v(" "),t("ul",[t("li",[t("strong",[e._v("Fixed")]),e._v(" "),t("ul",[t("li",[e._v("Update observer to improve reliability of contract state synchronization and evaluation.")])])])]),e._v(" "),t("h2",{attrs:{id:"release-5-2024-01-25"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#release-5-2024-01-25"}},[e._v("#")]),e._v(" [Release 5] - 2024-01-25")]),e._v(" "),t("ul",[t("li",[t("p",[t("strong",[e._v("Added")])]),e._v(" "),t("ul",[t("li",[e._v("Added transaction offset indexing to support future data retrieval capabilities.")]),e._v(" "),t("li",[e._v("Enabled IPv6 support in Envoy config.")]),e._v(" "),t("li",[e._v("Added ability to configure observer report generation interval via the "),t("code",[e._v("REPORT_GENERATION_INTERVAL_MS")]),e._v(" environmental variable. (Intended primarily for development and testing)")])])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Changed")])]),e._v(" "),t("ul",[t("li",[e._v("Updated observer to properly handle FQDN conflicts.")]),e._v(" "),t("li",[e._v("Renamed most "),t("code",[e._v("created_at")]),e._v(" columns to index to "),t("code",[e._v("indexed_at")]),e._v(" for consistency and clarity.")])])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Fixed")])]),e._v(" "),t("ul",[t("li",[e._v("Updated LMDB version to remove Buffer workaround and fix occasional block cache errors.")])])])]),e._v(" "),t("h2",{attrs:{id:"release-4-2024-01-11"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#release-4-2024-01-11"}},[e._v("#")]),e._v(" [Release 4] - 2024-01-11")]),e._v(" "),t("ul",[t("li",[t("p",[t("strong",[e._v("Added")])]),e._v(" "),t("ul",[t("li",[e._v("Added circuit breakers around data index access to reduce impact of DB access contention under heavy requests loads.")]),e._v(" "),t("li",[e._v("Added support for configuring data source priority via the ON_DEMAND_RETRIEVAL_ORDER environment variable.")]),e._v(" "),t("li",[e._v("Updated observer to a version that retrieves epoch start and duration from contract state.")])])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Changed")])]),e._v(" "),t("ul",[t("li",[e._v("Set the Redis max memory eviction policy to "),t("code",[e._v("allkeys-lru")]),e._v(".")]),e._v(" "),t("li",[e._v("Reduced default Redis max memory from 2GB to 256MB.")]),e._v(" "),t("li",[e._v("Improved predictability and performance of GraphQL queries.")]),e._v(" "),t("li",[e._v("Eliminated unbundling worker threads when filters are configured to skip indexing ANS-104 bundles.")]),e._v(" "),t("li",[e._v("Reduced the default number of ANS-104 worker threads from 2 to 1 when unbundling is enabled to conserve memory.")]),e._v(" "),t("li",[e._v("Increased nodejs max old space size to 8GB when ANS-104 workers > 1.")])])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Fixed")])]),e._v(" "),t("ul",[t("li",[e._v("Adjusted paths for chunks indexed by data root to include the full data root.")])])])]),e._v(" "),t("h2",{attrs:{id:"release-3-2023-12-05"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#release-3-2023-12-05"}},[e._v("#")]),e._v(" [Release 3] - 2023-12-05")]),e._v(" "),t("ul",[t("li",[t("p",[t("strong",[e._v("Added")])]),e._v(" "),t("ul",[t("li",[e._v("Support range requests ("),t("a",{attrs:{href:"https://github.com/ar-io/ar-io-node/pull/61",target:"_blank",rel:"noopener noreferrer"}},[e._v("PR 61"),t("OutboundLink")],1),e._v(", "),t("a",{attrs:{href:"https://github.com/ar-io/ar-io-node/pull/64",target:"_blank",rel:"noopener noreferrer"}},[e._v("PR 64"),t("OutboundLink")],1),e._v(")\n"),t("ul",[t("li",[e._v("Note: serving multiple ranges in a single request is not yet supported.")])])]),e._v(" "),t("li",[e._v("Release number in "),t("code",[e._v("/ar-io/info")]),e._v(" response.")]),e._v(" "),t("li",[e._v("Redis header cache implementation ("),t("a",{attrs:{href:"https://github.com/ar-io/ar-io-node/pull/62",target:"_blank",rel:"noopener noreferrer"}},[e._v("PR 62"),t("OutboundLink")],1),e._v(").\n"),t("ul",[t("li",[e._v("New default header cache (replaces old FS cache).")])])]),e._v(" "),t("li",[e._v("LMDB header cache implementation ("),t("a",{attrs:{href:"https://github.com/ar-io/ar-io-node/pull/60",target:"_blank",rel:"noopener noreferrer"}},[e._v("PR 60"),t("OutboundLink")],1),e._v(").\n"),t("ul",[t("li",[e._v("Intended for use in development only.")]),e._v(" "),t("li",[e._v("Enable by setting "),t("code",[e._v("CHAIN_CACHE_TYPE=lmdb")]),e._v(".")])])]),e._v(" "),t("li",[e._v("Filesystem header cache cleanup worker ("),t("a",{attrs:{href:"https://github.com/ar-io/ar-io-node/pull/68",target:"_blank",rel:"noopener noreferrer"}},[e._v("PR 68"),t("OutboundLink")],1),e._v(").\n"),t("ul",[t("li",[e._v("Enabled by default to cleanup old filesystem cache now that Redis is the new default.")])])]),e._v(" "),t("li",[e._v("Support for parallel ANS-104 unbundling ("),t("a",{attrs:{href:"https://github.com/ar-io/ar-io-node/pull/65",target:"_blank",rel:"noopener noreferrer"}},[e._v("PR 65"),t("OutboundLink")],1),e._v(").")])])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Changed")])]),e._v(" "),t("ul",[t("li",[e._v("Used pinned container images tags for releases.")]),e._v(" "),t("li",[e._v("Default to Redis header cache when running via docker-compose.")]),e._v(" "),t("li",[e._v("Default to LMDB header cache when running via "),t("code",[e._v("yarn start")]),e._v(".")])])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Fixed")])]),e._v(" "),t("ul",[t("li",[e._v("Correct GraphQL pagination for transactions with duplicate tags.")])])])])])}),[],!1,null,null,null);t.default=o.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[51],{351:function(e,t,a){"use strict";a.r(t);var r=a(10),i=Object(r.a)({},(function(){var e=this,t=e._self._c;return t("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[t("h1",{attrs:{id:"ar-io-release-notes"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#ar-io-release-notes"}},[e._v("#")]),e._v(" ar.io Release Notes")]),e._v(" "),t("h2",{attrs:{id:"overview"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#overview"}},[e._v("#")]),e._v(" Overview")]),e._v(" "),t("p",[e._v("Welcome to the documentation page for the ar.io gateway release notes. Here, you will find detailed information about each version of the ar.io gateway, including the enhancements, bug fixes, and any other changes introduced in every release. This page serves as a comprehensive resource to keep you informed about the latest developments and updates in the ar.io gateway. For those interested in exploring the source code, each release's code is readily accessible at our GitHub repository: ar.io gateway "),t("a",{attrs:{href:"https://github.com/ar-io/ar-io-node/blob/main/CHANGELOG.md",target:"_blank",rel:"noopener noreferrer"}},[e._v("change logs"),t("OutboundLink")],1),e._v(". Stay updated with the continuous improvements and advancements in the ar.io gateway by referring to this page for all release-related information.")]),e._v(" "),t("h2",{attrs:{id:"release-17-2024-09-09"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#release-17-2024-09-09"}},[e._v("#")]),e._v(" [Release 17] - 2024-09-09")]),e._v(" "),t("h3",{attrs:{id:"fixed"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#fixed"}},[e._v("#")]),e._v(" Fixed")]),e._v(" "),t("ul",[t("li",[e._v("Use the correct environment variable to populate WEBHOOK_BLOCK_FILTER in\n"),t("code",[e._v("docker-compose.yaml")]),e._v(".")]),e._v(" "),t("li",[e._v("Don't cache data regions retrieved to satisfy range requests to avoid\nunnecessary storage overhead and prevent inserting invalid ID to hash\nmappings into the data DB.")])]),e._v(" "),t("h3",{attrs:{id:"added"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#added"}},[e._v("#")]),e._v(" Added")]),e._v(" "),t("ul",[t("li",[e._v("Added a new ClickHouse based DB backend. It can be used in combination with\nthe SQLite DB backend to enable batch loading of historical data from\nParquet. It also opens up the possibility of higher DB performance and\nscalability. In its current state it should be considered a technology\npreview. It won't be useful to most users until we either provide Parquet\nfiles to load into it or automate flushing of the SQLite DB to it (both are\nplanned in future release). It is not intended to be standalone solution. It\nsupports bulk loading and efficient GraphQL querying of transactions and data\nitems, but it relies on SQLite (or potentially another OLTP in the future) to\nindex recent data. These limitations allow greatly simplified schema and\nquery construction. Querying the new ClickHouse DB for transaction and data\nitems via GraphQL is enabled by setting the 'CLICKHOUSE_URL' environment\nvariable.")]),e._v(" "),t("li",[e._v("Added the ability to skip storing transaction signatures in the DB by setting\nWRITE_TRANSACTION_DB_SIGNATURES to false. Missing signatures are fetched from\nthe trusted Arweave node when needed for GraphQL results.")]),e._v(" "),t("li",[e._v("Added a Redis backed signature cache to support retrieving optimistically\nindexed data item signatures in GraphQL queries when writing data items\nsignatures to the DB has been disabled.")]),e._v(" "),t("li",[e._v("Added on-demand and composite ArNS resolvers. The on-demand resolver\nfetches results directly from an AO CU. The composite resolver attempts\nresolution in the order specified by the ARNS_RESOLVER_PRIORITY_ORDER\nenvironment variable (defaults to 'on-demand,gateway').")]),e._v(" "),t("li",[e._v("Added a queue_length Prometheus metric to facilitate monitoring queues and\ninform future optimizations")]),e._v(" "),t("li",[e._v("Added SQLite WAL cleanup worker to help manage the size of the "),t("code",[e._v("data.db-wal")]),e._v("\nfile. Future improvements to "),t("code",[e._v("data.db")]),e._v(" usage are also planned to further\nimprove WAL management.")])]),e._v(" "),t("h3",{attrs:{id:"changed"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#changed"}},[e._v("#")]),e._v(" Changed")]),e._v(" "),t("ul",[t("li",[e._v("Handle data requests by ID on ArNS sites. This enables ArNS sites to use\nrelative links to data by ID.")]),e._v(" "),t("li",[e._v("Replaced ARNS_RESOLVER_TYPE with ARNS_RESOLVER_PRIORITY_ORDER (defaults to\n'on-demand,gateway').")]),e._v(" "),t("li",[e._v("Introduced unbundling back pressure. When either data item data or GraphQL\nindexing queue depths are more than the value specified by the\nMAX_DATA_ITEM_QUEUE_SIZE environment variable (defaults to 100000),\nunbundling is paused until the queues length falls bellow that threshold.\nThis prevents the gateway from running out of memory when the unbundling rate\nexceeds the indexing rate while avoiding wasteful bundle reprocessing.")]),e._v(" "),t("li",[e._v("Prioritized optimistic data item indexing by inserting optimistic data items\nat the front of the indexing queues.")]),e._v(" "),t("li",[e._v("Prioritized nested bundle indexing by inserting nested bundles at the front\nof the unbundling queue.")])]),e._v(" "),t("h2",{attrs:{id:"release-16-2024-08-09"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#release-16-2024-08-09"}},[e._v("#")]),e._v(" [Release 16] - 2024-08-09")]),e._v(" "),t("ul",[t("li",[t("p",[t("strong",[e._v("Fixed")])]),e._v(" "),t("ul",[t("li",[e._v("Fixed promise leak caused by missing await when saving data items to the DB.")]),e._v(" "),t("li",[e._v("Modified ArNS middleware to not attempt resolution when receiving requests for a different hostname than the one specified by "),t("code",[e._v("ARNS_ROOT_HOST")]),e._v(".")])])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Added")])]),e._v(" "),t("ul",[t("li",[e._v("Added support for returning "),t("code",[e._v("Content-Encoding")]),e._v(" HTTP headers based on user specified Content-Encoding tags.")]),e._v(" "),t("li",[e._v("Added "),t("code",[e._v("isNestedBundle")]),e._v(" filter enables that matches any nested bundle when indexing. This enables composite unbundling filters that match a set of L1 tags and bundles nested under them.")]),e._v(" "),t("li",[e._v("Added ability to skip writing ANS-104 signatures to the DB and load them based on offsets from the data instead. This significantly reduces the size of the bundles DB. It can be enabled by setting the "),t("code",[e._v("WRITE_ANS104_DATA_ITEM_DB_SIGNATURES")]),e._v(" environment variable to false.")]),e._v(" "),t("li",[e._v("Added "),t("code",[e._v("data_item_data_indexed_total")]),e._v(" Prometheus counter to count data items with data attributes indexed.")])])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Changed")])]),e._v(" "),t("ul",[t("li",[e._v("Queue data attributes writes when serving data rather than writing them syncronously.")]),e._v(" "),t("li",[e._v("Reduced the default data indexer count to 1 to lessen the load on the data DB.")]),e._v(" "),t("li",[e._v("Switched a number of overly verbose info logs to debug level.")]),e._v(" "),t("li",[e._v("Removed docker-compose on-failure restart limits to ensure that services restart no matter how many times they fail.")]),e._v(" "),t("li",[e._v("Modified the "),t("code",[e._v("data_items_indexed_total")]),e._v(" Prometheus counter to count data items indexed for GraphQL querying instead of data attributes.")]),e._v(" "),t("li",[e._v("Increased aggressiveness of contiguous data cleanup. It now pauses 5 seconds instead of 10 seconds per batch and runs every 4 hours instead of every 24 hours.")])])])]),e._v(" "),t("h2",{attrs:{id:"release-15-2024-07-19"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#release-15-2024-07-19"}},[e._v("#")]),e._v(" [Release 15] - 2024-07-19")]),e._v(" "),t("ul",[t("li",[t("p",[t("strong",[e._v("Fixed")])]),e._v(" "),t("ul",[t("li",[e._v("Fixed query error that was preventing bundles from being marked as fully imported in the database.")])])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Added")])]),e._v(" "),t("ul",[t("li",[e._v("Adjusted data item indexing to record data item signature types in the DB. This helps distinguish between signatures using different key formats, and will enable querying by signature type in the future.")]),e._v(" "),t("li",[e._v("Adjusted data item indexing to record offsets for data items within bundles and signatures and owners within data items. In the future this will allow us to avoid saving owners and signatures in the DB and thus considerably reduce the size of the bundles DB.")]),e._v(" "),t("li",[e._v("Added "),t("code",[e._v("ARNS_CACHE_TTL_MS")]),e._v(" environment variable to control the TTL of ARNS cache entries (defaults to 1 hour).")]),e._v(" "),t("li",[e._v("Added support for multiple ranges in a single HTTP range request.")]),e._v(" "),t("li",[e._v("Added experimental chunk POST endpoint that broadcasts chunks to the comma-separate list of URLS in the "),t("code",[e._v("CHUNK_BROADCAST_URLS")]),e._v(" environment variable. It is available at "),t("code",[e._v("/chunk")]),e._v(" on the internal gateway service port (4000 by default) but is not yet exposed through Envoy.")]),e._v(" "),t("li",[e._v("Added support for running an AO CU adjacent to the gateway (see README.md for details).")]),e._v(" "),t("li",[e._v("Added "),t("code",[e._v("X-ArNS-Process-Id")]),e._v(" to ArNS resolved name headers.")]),e._v(" "),t("li",[e._v("Added a set of "),t("code",[e._v("AO_...")]),e._v(" environment variables for specifying which AO URLs should be used (see "),t("code",[e._v("docker-compose.yaml")]),e._v(" for the complete list). The "),t("code",[e._v("AO_CU_URL")]),e._v(" is of particular use since the core and resolver services only perform AO reads and only the CU is needed for reads.")])])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Changed")])]),e._v(" "),t("ul",[t("li",[e._v("Split the monolithic "),t("code",[e._v("docker-compose.yaml")]),e._v(" into "),t("code",[e._v("docker-compose.yaml")]),e._v(", "),t("code",[e._v("docker-compose.bundler.yaml")]),e._v(", and "),t("code",[e._v("docker-compose.ao.yaml")]),e._v(" (see README for details).")]),e._v(" "),t("li",[e._v("Replaced references to 'docker-compose' with 'docker compose' in the docs since the former is mostly deprecated.")]),e._v(" "),t("li",[e._v("Reduce max fork depth from 50 to 18 inline to reflect Arweave 2.7.2 protocol changes.")]),e._v(" "),t("li",[e._v("Increased the aggressiveness of bundle reprocessing by reducing reprocessing interval from 10 minutes to 5 minutes and raising reprocessing batch size from 100 to 1000.")]),e._v(" "),t("li",[e._v("Use a patched version of Litestream to work around insufficient S3 multipart upload size in the upstream version.")])])])]),e._v(" "),t("h2",{attrs:{id:"release-14-2024-06-26"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#release-14-2024-06-26"}},[e._v("#")]),e._v(" [Release 14] - 2024-06-26")]),e._v(" "),t("ul",[t("li",[t("p",[t("strong",[e._v("Fixed")])]),e._v(" "),t("ul",[t("li",[e._v("Correctly handle manifest "),t("code",[e._v("index")]),e._v(" after "),t("code",[e._v("paths")]),e._v(".")])])])]),e._v(" "),t("h2",{attrs:{id:"release-13-2024-06-24"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#release-13-2024-06-24"}},[e._v("#")]),e._v(" [Release 13] - 2024-06-24")]),e._v(" "),t("ul",[t("li",[t("p",[t("strong",[e._v("Added")])]),e._v(" "),t("ul",[t("li",[e._v("Added support for optimistically reading data items uploaded using the integrated Turbo bundler via the LocalStack S3 interface.")]),e._v(" "),t("li",[e._v("Added "),t("code",[e._v("X-AR-IO-Origin-Node-Release")]),e._v(" header to outbound data requests.")]),e._v(" "),t("li",[e._v("Added "),t("code",[e._v("hops")]),e._v(", "),t("code",[e._v("origin")]),e._v(", and "),t("code",[e._v("originNodeRelease")]),e._v(" query params to outbound data requests.")]),e._v(" "),t("li",[e._v("Added support for "),t("code",[e._v("fallback")]),e._v(" in v0.2 manifests that is used if no path in the manifest is matched.")])])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Changed")])]),e._v(" "),t("ul",[t("li",[e._v("Updated Observer to read prescribed names from and write observations to the ar.io AO network process.")]),e._v(" "),t("li",[e._v("Updated Resolver to read from the ar.io AO network process.")])])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Fixed")])]),e._v(" "),t("ul",[t("li",[e._v("Modified optimistic indexing of data items to use a null "),t("code",[e._v("parent_id")]),e._v(" when inserting into the DB instead of a placeholder value. This prevents unexpected non-null "),t("code",[e._v("bundledIn")]),e._v(" values in GraphQL results for optimistically indexed data items.")]),e._v(" "),t("li",[e._v("Modified GraphQl query logic to require an ID for single block GraphQL queries. Previously queries missing an ID were returning an internal SQLite error. This represents a small departure from arweave.net's query logic which returns the latest block for these queries. We recommend querying "),t("code",[e._v("blocks")]),e._v(" instead of "),t("code",[e._v("block")]),e._v(" in cases where the latest block is desired.")]),e._v(" "),t("li",[e._v("Adjusted Observer health check to reflect port change to 5050.")])])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Security")])]),e._v(" "),t("ul",[t("li",[e._v("Modified docker-compose.yaml to only expose Redis, PostgreSQL, and LocalStack ports internally. This protects gateways that neglect to deploy behind a firewall, reverse proxy, or load balancer.")])])])]),e._v(" "),t("h2",{attrs:{id:"release-12-2024-06-05"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#release-12-2024-06-05"}},[e._v("#")]),e._v(" [Release 12] - 2024-06-05")]),e._v(" "),t("ul",[t("li",[t("p",[t("strong",[e._v("Added")])]),e._v(" "),t("ul",[t("li",[e._v("Added "),t("code",[e._v("/ar-io/admin/queue-data-item")]),e._v(" endpoint for queuing data item headers for indexing before the bundles containing them are processed. This allows trusted bundlers to make their data items quickly available to be queried via GraphQL without having to wait for bundle data submission or unbundling.")]),e._v(" "),t("li",[e._v("Added experimental support for retrieving contiguous data from S3. See "),t("code",[e._v("AWS_*")]),e._v(" "),t("a",{attrs:{href:""}},[e._v("environment variables documentation")]),e._v(" for configuration details. In conjuction with a local Turbo bundler this allows optimistic bundle (but not yet data item) retrieval.")]),e._v(" "),t("li",[e._v("Add experimental support for fetching data from gateway peers. It can be enabled by adding "),t("code",[e._v("ario-peer")]),e._v(" to "),t("code",[e._v("ON_DEMAND_RETRIEVAL_ORDER")]),e._v(". Note: do not expect this work reliably yet! This functionality is in active development and will be improved in future releases.")]),e._v(" "),t("li",[e._v("Add "),t("code",[e._v("import_attempt_count")]),e._v(" to "),t("code",[e._v("bundle")]),e._v(" records to enable future bundle import retry optimizations.")])])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Changed")])]),e._v(" "),t("ul",[t("li",[e._v("Removed "),t("code",[e._v("version")]),e._v(" from "),t("code",[e._v("docker-compose.yaml")]),e._v(" to avoid warnings with recent versions of "),t("code",[e._v("docker-compose")]),e._v(".")]),e._v(" "),t("li",[e._v("Switched default observer port from 5000 to 5050 to avoid conflict on OS X. Since Envoy is used to provide external access to the observer API this should have no user visible effect.")])])])]),e._v(" "),t("h2",{attrs:{id:"release-11-2024-05-21"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#release-11-2024-05-21"}},[e._v("#")]),e._v(" [Release 11] - 2024-05-21")]),e._v(" "),t("ul",[t("li",[t("p",[t("strong",[e._v("Added")])]),e._v(" "),t("ul",[t("li",[e._v("Added "),t("code",[e._v("arweave_tx_fetch_total")]),e._v(" Prometheus metric to track counts of transaction headers fetched from the trusted node and Arweave network peers.")])])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Changed")])]),e._v(" "),t("ul",[t("li",[e._v("Revert to using unnamed bind mounts due to cross platform issues with named volumes.")])])])]),e._v(" "),t("h2",{attrs:{id:"release-10-2024-05-20"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#release-10-2024-05-20"}},[e._v("#")]),e._v(" [Release 10] - 2024-05-20")]),e._v(" "),t("ul",[t("li",[t("p",[t("strong",[e._v("Added")])]),e._v(" "),t("ul",[t("li",[e._v("Added experimental support for streaming SQLite backups to S3 (and compatible services) using "),t("a",{attrs:{href:"https://litestream.io/",target:"_blank",rel:"noopener noreferrer"}},[e._v("Litestream"),t("OutboundLink")],1),e._v('. Start the service using the docker-compose "litestream" profile to use it, and see the '),t("code",[e._v("AR_IO_SQLITE_BACKUP_*")]),e._v(" "),t("a",{attrs:{href:"https://github.com/ar-io/ar-io-node/blob/r10-prep/docs/env.md",target:"_blank",rel:"noopener noreferrer"}},[e._v("environment variables documentation"),t("OutboundLink")],1),e._v(" for further details.")]),e._v(" "),t("li",[e._v("Added "),t("code",[e._v("/ar-io/admin/queue-bundle")]),e._v(" endpoint for queueing bundles for import for import before they're in the mempool. In the future this will enable optimistic indexing when combined with a local trusted bundler.")]),e._v(" "),t("li",[e._v("Added support for triggering webhooks when blocks are imported matching the filter specified by the "),t("code",[e._v("WEBHOOK_BLOCK_FILTER")]),e._v(" environment variable.")]),e._v(" "),t("li",[e._v("Added experimental support for indexing transactions and related data items from the mempool. Enable it by setting "),t("code",[e._v("ENABLE_MEMPOOL_WATCHER")]),e._v(" to 'true'.")]),e._v(" "),t("li",[e._v("Made on-demand data caching circuit breakers configurable via the "),t("code",[e._v("GET_DATA_CIRCUIT_BREAKER_TIMEOUT_MS")]),e._v(" environment variable. This allows gateway operators to decide how much latency they will tolerate when serving data in exchange for more complete data indexing and caching.")]),e._v(" "),t("li",[e._v("Rename cache header from "),t("code",[e._v("X-Cached")]),e._v(" to "),t("code",[e._v("X-Cache")]),e._v(" to mimic typical CDN practices.")]),e._v(" "),t("li",[e._v("Add X-AR-IO-Hops and X-AR-IO-Origin headers in preparation for future peer-to-peer functionality.")]),e._v(" "),t("li",[e._v("Upgrade to Node.js v20 and switch to native test runner.")])])])]),e._v(" "),t("h2",{attrs:{id:"release-9-2024-04-10"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#release-9-2024-04-10"}},[e._v("#")]),e._v(" [Release 9] - 2024-04-10")]),e._v(" "),t("ul",[t("li",[t("strong",[e._v("Added")]),e._v(" "),t("ul",[t("li",[e._v("Added experimental Farcaster Frames support, enabling simple Arweave based Frames with button navigation. Transaction and data item data is now served under "),t("code",[e._v("/local/farcaster/frame/")]),e._v(". "),t("code",[e._v("/local")]),e._v(" is used as a prefix to indicate this functionality is both experimental and local to a particular gateway rather than part of the global gateway API. Both GET and POST requests are supported.")]),e._v(" "),t("li",[e._v("Added an experimental local ArNS resolver. When enabled it removes dependence on arweave.net for ArNS resolution! Enable it by setting "),t("code",[e._v("RUN_RESOLVER=TRUE")]),e._v(", "),t("code",[e._v("TRUSTED_ARNS_RESOLVER_TYPE=resolver")]),e._v(", and "),t("code",[e._v("TRUSTED_ARNS_RESOLVER_URL=http://resolver:6000")]),e._v(" in your "),t("code",[e._v(".env")]),e._v(" file.")]),e._v(" "),t("li",[e._v("Added an "),t("code",[e._v("X-Cached")]),e._v(" header to data responses to indicate when data is served from the local cache rather than being retrieved from an external source. This is helpful for interfacing with external systems, debugging, and end-to-end testing.")]),e._v(" "),t("li",[e._v("Save hashes for unbundled data items during indexing. This enables reduction in data storage via hash based deduplication as well as more efficient peer-to-peer data retrieval in the future.")])])])]),e._v(" "),t("h2",{attrs:{id:"release-8-2024-03-14"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#release-8-2024-03-14"}},[e._v("#")]),e._v(" [Release 8] - 2024-03-14")]),e._v(" "),t("ul",[t("li",[t("p",[t("strong",[e._v("Added")])]),e._v(" "),t("ul",[t("li",[e._v("Added GraphQL SQL query debug logging to support trouble-shooting and performance optimization.")]),e._v(" "),t("li",[e._v("Added support for indexing data items (not GraphQL querying) based solely on tag name. (example use case: indexing all IPFS CID tagged data items).")])])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Changes")])]),e._v(" "),t("ul",[t("li",[e._v("Observer data sampling now uses randomized ranges to generate content hashes.")]),e._v(" "),t("li",[e._v("Reference gateway ArNS resolutions are now cached to improve report generation performance.")]),e._v(" "),t("li",[e._v("Contract interactions are now tested before posting using "),t("code",[e._v("dryWrite")]),e._v(" to avoid submitting interactions that would fail.")]),e._v(" "),t("li",[t("code",[e._v("/ar-io/observer/info")]),e._v(" now reports "),t("code",[e._v("INVALID")]),e._v(" for wallets that fail to load.")])])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Fixed")])]),e._v(" "),t("ul",[t("li",[e._v("Fix data caching failure caused by incorrect method name in "),t("code",[e._v("getData")]),e._v(" circuit breakers.")]),e._v(" "),t("li",[e._v("Fix healthcheck when "),t("code",[e._v("ARNS_ROOT_HOST")]),e._v(" includes a subdomain.")])])])]),e._v(" "),t("h2",{attrs:{id:"release-7-2024-02-14"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#release-7-2024-02-14"}},[e._v("#")]),e._v(" [Release 7] - 2024 - 02 - 14")]),e._v(" "),t("ul",[t("li",[t("p",[t("strong",[e._v("Added")])]),e._v(" "),t("ul",[t("li",[e._v("Add support for notifying other services of transactions and data items using webhooks (see README for details).")]),e._v(" "),t("li",[e._v("Add support for filter negation (particularly useful for excluding large bundles from indexint).")]),e._v(" "),t("li",[e._v("Improve unbundling throughput by decoupling data fetching from unbundling.")]),e._v(" "),t("li",[e._v("Add Envoy and core service ARM builds.")])])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Changed")])]),e._v(" "),t("ul",[t("li",[e._v("Improve resouce cleanup and shutdown behavior.")]),e._v(" "),t("li",[e._v("Don't save Redis data to disk by default to help prevent memory issues on startup for small gateways.")]),e._v(" "),t("li",[e._v("Reduce the amount of data sampled from large files by the observer.")]),e._v(" "),t("li",[e._v("Ensure block poa2 field is not chached to reduce memory consumption.")])])])]),e._v(" "),t("h2",{attrs:{id:"release-6-2024-01-29"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#release-6-2024-01-29"}},[e._v("#")]),e._v(" [Release 6] - 2024-01-29")]),e._v(" "),t("ul",[t("li",[t("strong",[e._v("Fixed")]),e._v(" "),t("ul",[t("li",[e._v("Update observer to improve reliability of contract state synchronization and evaluation.")])])])]),e._v(" "),t("h2",{attrs:{id:"release-5-2024-01-25"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#release-5-2024-01-25"}},[e._v("#")]),e._v(" [Release 5] - 2024-01-25")]),e._v(" "),t("ul",[t("li",[t("p",[t("strong",[e._v("Added")])]),e._v(" "),t("ul",[t("li",[e._v("Added transaction offset indexing to support future data retrieval capabilities.")]),e._v(" "),t("li",[e._v("Enabled IPv6 support in Envoy config.")]),e._v(" "),t("li",[e._v("Added ability to configure observer report generation interval via the "),t("code",[e._v("REPORT_GENERATION_INTERVAL_MS")]),e._v(" environmental variable. (Intended primarily for development and testing)")])])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Changed")])]),e._v(" "),t("ul",[t("li",[e._v("Updated observer to properly handle FQDN conflicts.")]),e._v(" "),t("li",[e._v("Renamed most "),t("code",[e._v("created_at")]),e._v(" columns to index to "),t("code",[e._v("indexed_at")]),e._v(" for consistency and clarity.")])])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Fixed")])]),e._v(" "),t("ul",[t("li",[e._v("Updated LMDB version to remove Buffer workaround and fix occasional block cache errors.")])])])]),e._v(" "),t("h2",{attrs:{id:"release-4-2024-01-11"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#release-4-2024-01-11"}},[e._v("#")]),e._v(" [Release 4] - 2024-01-11")]),e._v(" "),t("ul",[t("li",[t("p",[t("strong",[e._v("Added")])]),e._v(" "),t("ul",[t("li",[e._v("Added circuit breakers around data index access to reduce impact of DB access contention under heavy requests loads.")]),e._v(" "),t("li",[e._v("Added support for configuring data source priority via the ON_DEMAND_RETRIEVAL_ORDER environment variable.")]),e._v(" "),t("li",[e._v("Updated observer to a version that retrieves epoch start and duration from contract state.")])])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Changed")])]),e._v(" "),t("ul",[t("li",[e._v("Set the Redis max memory eviction policy to "),t("code",[e._v("allkeys-lru")]),e._v(".")]),e._v(" "),t("li",[e._v("Reduced default Redis max memory from 2GB to 256MB.")]),e._v(" "),t("li",[e._v("Improved predictability and performance of GraphQL queries.")]),e._v(" "),t("li",[e._v("Eliminated unbundling worker threads when filters are configured to skip indexing ANS-104 bundles.")]),e._v(" "),t("li",[e._v("Reduced the default number of ANS-104 worker threads from 2 to 1 when unbundling is enabled to conserve memory.")]),e._v(" "),t("li",[e._v("Increased nodejs max old space size to 8GB when ANS-104 workers > 1.")])])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Fixed")])]),e._v(" "),t("ul",[t("li",[e._v("Adjusted paths for chunks indexed by data root to include the full data root.")])])])]),e._v(" "),t("h2",{attrs:{id:"release-3-2023-12-05"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#release-3-2023-12-05"}},[e._v("#")]),e._v(" [Release 3] - 2023-12-05")]),e._v(" "),t("ul",[t("li",[t("p",[t("strong",[e._v("Added")])]),e._v(" "),t("ul",[t("li",[e._v("Support range requests ("),t("a",{attrs:{href:"https://github.com/ar-io/ar-io-node/pull/61",target:"_blank",rel:"noopener noreferrer"}},[e._v("PR 61"),t("OutboundLink")],1),e._v(", "),t("a",{attrs:{href:"https://github.com/ar-io/ar-io-node/pull/64",target:"_blank",rel:"noopener noreferrer"}},[e._v("PR 64"),t("OutboundLink")],1),e._v(")\n"),t("ul",[t("li",[e._v("Note: serving multiple ranges in a single request is not yet supported.")])])]),e._v(" "),t("li",[e._v("Release number in "),t("code",[e._v("/ar-io/info")]),e._v(" response.")]),e._v(" "),t("li",[e._v("Redis header cache implementation ("),t("a",{attrs:{href:"https://github.com/ar-io/ar-io-node/pull/62",target:"_blank",rel:"noopener noreferrer"}},[e._v("PR 62"),t("OutboundLink")],1),e._v(").\n"),t("ul",[t("li",[e._v("New default header cache (replaces old FS cache).")])])]),e._v(" "),t("li",[e._v("LMDB header cache implementation ("),t("a",{attrs:{href:"https://github.com/ar-io/ar-io-node/pull/60",target:"_blank",rel:"noopener noreferrer"}},[e._v("PR 60"),t("OutboundLink")],1),e._v(").\n"),t("ul",[t("li",[e._v("Intended for use in development only.")]),e._v(" "),t("li",[e._v("Enable by setting "),t("code",[e._v("CHAIN_CACHE_TYPE=lmdb")]),e._v(".")])])]),e._v(" "),t("li",[e._v("Filesystem header cache cleanup worker ("),t("a",{attrs:{href:"https://github.com/ar-io/ar-io-node/pull/68",target:"_blank",rel:"noopener noreferrer"}},[e._v("PR 68"),t("OutboundLink")],1),e._v(").\n"),t("ul",[t("li",[e._v("Enabled by default to cleanup old filesystem cache now that Redis is the new default.")])])]),e._v(" "),t("li",[e._v("Support for parallel ANS-104 unbundling ("),t("a",{attrs:{href:"https://github.com/ar-io/ar-io-node/pull/65",target:"_blank",rel:"noopener noreferrer"}},[e._v("PR 65"),t("OutboundLink")],1),e._v(").")])])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Changed")])]),e._v(" "),t("ul",[t("li",[e._v("Used pinned container images tags for releases.")]),e._v(" "),t("li",[e._v("Default to Redis header cache when running via docker-compose.")]),e._v(" "),t("li",[e._v("Default to LMDB header cache when running via "),t("code",[e._v("yarn start")]),e._v(".")])])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Fixed")])]),e._v(" "),t("ul",[t("li",[e._v("Correct GraphQL pagination for transactions with duplicate tags.")])])])])])}),[],!1,null,null,null);t.default=i.exports}}]); \ No newline at end of file diff --git a/assets/js/52.e2d079d5.js b/assets/js/52.bf4997a6.js similarity index 97% rename from assets/js/52.e2d079d5.js rename to assets/js/52.bf4997a6.js index 8096ddd8..11f06d08 100644 --- a/assets/js/52.e2d079d5.js +++ b/assets/js/52.bf4997a6.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[52],{353:function(t,e,a){"use strict";a.r(e);var r=a(10),n=Object(r.a)({},(function(){var t=this,e=t._self._c;return e("ContentSlotsDistributor",{attrs:{"slot-key":t.$parent.slotKey}},[e("h1",{attrs:{id:"join-the-ar-io-testnet"}},[e("a",{staticClass:"header-anchor",attrs:{href:"#join-the-ar-io-testnet"}},[t._v("#")]),t._v(" Join the AR.IO Testnet")]),t._v(" "),e("h2",{attrs:{id:"prerequisites"}},[e("a",{staticClass:"header-anchor",attrs:{href:"#prerequisites"}},[t._v("#")]),t._v(" Prerequisites")]),t._v(" "),e("ol",[e("li",[e("p",[t._v("Must have a fully functional AR.IO gateway.")]),t._v(" "),e("ul",[e("li",[t._v("This includes the ability to resolve ArNS subdomains.")]),t._v(" "),e("li",[t._v("Follow installation instructions for "),e("a",{attrs:{href:"/gateways/ar-io-node/windows-setup"}},[t._v("windows")]),t._v(" or "),e("a",{attrs:{href:"/gateways/ar-io-node/linux-setup"}},[t._v("linux")]),t._v(" and get help from the "),e("a",{attrs:{href:"https://discord.gg/7zUPfN4D6g",target:"_blank",rel:"noopener noreferrer"}},[t._v("ar.io community"),e("OutboundLink")],1),t._v(".")])])]),t._v(" "),e("li",[e("p",[t._v("Gateway must be associated with an Arweave Wallet.")]),t._v(" "),e("ul",[e("li",[t._v("Learn about creating Arweave wallets "),e("a",{attrs:{href:"https://ar.io/wallet",target:"_blank",rel:"noopener noreferrer"}},[t._v("here"),e("OutboundLink")],1)])])]),t._v(" "),e("li",[e("p",[t._v("Arweave wallet must be funded with enough AR tokens to pay for transaction gas.")])])]),t._v(" "),e("h2",{attrs:{id:"submit-an-application"}},[e("a",{staticClass:"header-anchor",attrs:{href:"#submit-an-application"}},[t._v("#")]),t._v(" Submit an Application")]),t._v(" "),e("p",[t._v("Joining the ar.io Testnet requires staking a minimum of 50,000 Test IO Tokens. You must have Test IO Tokens before you are able to join. Test IO Tokens are currently not being distributed.")]),t._v(" "),e("p",[t._v("New applications for joining the Testnet are not currently being accepted. Be sure to join the "),e("a",{attrs:{href:"https://discord.com/invite/7zUPfN4D6g",target:"_blank",rel:"noopener noreferrer"}},[t._v("ar.io Discord"),e("OutboundLink")],1),t._v(" to stay up to date on Testnet status and possible future availability prior to the launch of the Mainnet. --\x3e")])])}),[],!1,null,null,null);e.default=n.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[52],{352:function(t,e,a){"use strict";a.r(e);var r=a(10),n=Object(r.a)({},(function(){var t=this,e=t._self._c;return e("ContentSlotsDistributor",{attrs:{"slot-key":t.$parent.slotKey}},[e("h1",{attrs:{id:"join-the-ar-io-testnet"}},[e("a",{staticClass:"header-anchor",attrs:{href:"#join-the-ar-io-testnet"}},[t._v("#")]),t._v(" Join the AR.IO Testnet")]),t._v(" "),e("h2",{attrs:{id:"prerequisites"}},[e("a",{staticClass:"header-anchor",attrs:{href:"#prerequisites"}},[t._v("#")]),t._v(" Prerequisites")]),t._v(" "),e("ol",[e("li",[e("p",[t._v("Must have a fully functional AR.IO gateway.")]),t._v(" "),e("ul",[e("li",[t._v("This includes the ability to resolve ArNS subdomains.")]),t._v(" "),e("li",[t._v("Follow installation instructions for "),e("a",{attrs:{href:"/gateways/ar-io-node/windows-setup"}},[t._v("windows")]),t._v(" or "),e("a",{attrs:{href:"/gateways/ar-io-node/linux-setup"}},[t._v("linux")]),t._v(" and get help from the "),e("a",{attrs:{href:"https://discord.gg/7zUPfN4D6g",target:"_blank",rel:"noopener noreferrer"}},[t._v("ar.io community"),e("OutboundLink")],1),t._v(".")])])]),t._v(" "),e("li",[e("p",[t._v("Gateway must be associated with an Arweave Wallet.")]),t._v(" "),e("ul",[e("li",[t._v("Learn about creating Arweave wallets "),e("a",{attrs:{href:"https://ar.io/wallet",target:"_blank",rel:"noopener noreferrer"}},[t._v("here"),e("OutboundLink")],1)])])]),t._v(" "),e("li",[e("p",[t._v("Arweave wallet must be funded with enough AR tokens to pay for transaction gas.")])])]),t._v(" "),e("h2",{attrs:{id:"submit-an-application"}},[e("a",{staticClass:"header-anchor",attrs:{href:"#submit-an-application"}},[t._v("#")]),t._v(" Submit an Application")]),t._v(" "),e("p",[t._v("Joining the ar.io Testnet requires staking a minimum of 50,000 Test IO Tokens. You must have Test IO Tokens before you are able to join. Test IO Tokens are currently not being distributed.")]),t._v(" "),e("p",[t._v("New applications for joining the Testnet are not currently being accepted. Be sure to join the "),e("a",{attrs:{href:"https://discord.com/invite/7zUPfN4D6g",target:"_blank",rel:"noopener noreferrer"}},[t._v("ar.io Discord"),e("OutboundLink")],1),t._v(" to stay up to date on Testnet status and possible future availability prior to the launch of the Mainnet. --\x3e")])])}),[],!1,null,null,null);e.default=n.exports}}]); \ No newline at end of file diff --git a/assets/js/53.5d90925b.js b/assets/js/53.086a38a8.js similarity index 99% rename from assets/js/53.5d90925b.js rename to assets/js/53.086a38a8.js index 21f2b570..a0afcdb7 100644 --- a/assets/js/53.5d90925b.js +++ b/assets/js/53.086a38a8.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[53],{352:function(e,t,a){"use strict";a.r(t);var r=a(10),s=Object(r.a)({},(function(){var e=this,t=e._self._c;return t("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[t("h1",{attrs:{id:"troubleshooting"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#troubleshooting"}},[e._v("#")]),e._v(" Troubleshooting")]),e._v(" "),t("h2",{attrs:{id:"my-gateway-seems-to-be-running-but"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#my-gateway-seems-to-be-running-but"}},[e._v("#")]),e._v(" My Gateway Seems to be Running but...")]),e._v(" "),t("h3",{attrs:{id:""}},[t("a",{staticClass:"header-anchor",attrs:{href:"#"}},[e._v("#")])]),e._v(" "),t("details",[t("summary",[t("strong",[e._v('My release number doesn\'t match the latest version, or includes "-pre"')])]),e._v(" "),t("p",[e._v("If your release number when you go to "),t("code",[e._v("/ar-io/info")]),e._v(" is lower than the current release, you simply need to upgrade your gateway in order to reach the latest release.")]),e._v(" "),t("p",[e._v('If your release number includes the suffix "-pre" it means you are running your gateway from the development branch of the github repository, instead of the main branch. The development branch is used for staging work that the engineering team is in the middle of. Because of this, it can be much less stable than the main branch used for production and can cause significant issues.')]),e._v(" "),t("p",[e._v("Ensure that you are running the latest release, from the main branch, by running the below commands in your terminal:")]),e._v(" "),t("div",{staticClass:"language-console extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("sudo docker-compose down --rmi all\n\ngit checkout main\n\ngit pull\n\nsudo docker-compose up -d\n")])])]),t("p",[e._v("If this doesn't resolve the issue, you can also try a more extreme method of clearing out the incorrect docker images:")]),e._v(" "),t("div",{staticClass:"language-console extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("sudo docker-compose down\n\nsudo docker system prune -a\n\nsudo docker-compose up -d\n")])])])]),e._v(" "),t("h3",{attrs:{id:"-2"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#-2"}},[e._v("#")])]),e._v(" "),t("details",[t("summary",[t("strong",[e._v("It appears offline on "),t("a",{attrs:{target:"_blank",href:"https://viewblock.io/arweave/gateways"}},[e._v("Viewblock")]),e._v(" or "),t("a",{attrs:{target:"_blank",href:"https://gateways.arweave.dev"}},[e._v("ar://gateways")])])]),e._v(" "),t("p",[e._v('Viewblock and ar://gateways use a very simple ping method for determining if a gateway is "up". There are plenty of reasons why this ping may fail while the gateway is running perfectly, so showing as down is not cause for concern. Just verify that your gateway is still running, and wait. Your gateway will show as up again soon.')])]),e._v(" "),t("h3",{attrs:{id:"-3"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#-3"}},[e._v("#")])]),e._v(" "),t("details",[t("summary",[t("strong",[e._v('< gateway >/ar-io/observer/reports/current just says "report pending"')])]),e._v(" "),t("p",[e._v("This is normal. Your Observer is working to generate a report and that report will be displayed once it is complete.")])]),e._v(" "),t("h3",{attrs:{id:"-4"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#-4"}},[e._v("#")])]),e._v(" "),t("details",[t("summary",[t("strong",[e._v('My Observer is showing me the error "error: Error reading interaction: Cannot read properties of undefined"')])]),e._v(" "),t("p",[e._v("This is not an issue with your observer. The short explanation is that your Observer is looking for tasks assigned to it by the ar.io network contract, but there isnt anything there. You can safely ignore this error message.")])]),e._v(" "),t("h3",{attrs:{id:"-5"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#-5"}},[e._v("#")])]),e._v(" "),t("details",[t("summary",[t("strong",[e._v("Observing my gateway shows failures")])]),e._v(" "),t("p",[e._v('When observing a gateway, there are two main pass/fail tests. "Ownership" and "ArNS Assessment"')]),e._v(" "),t("ul",[t("li",[t("p",[e._v("Ownership: This tests to see if the value set in your gateway "),t("code",[e._v("AR_IO_WALLET")]),e._v(" value (in .env) matches the wallet used to join the AR.IO Network. If they don't match, update the value in your .env file and restart your gateway.")])]),e._v(" "),t("li",[t("p",[e._v("ArNS Assessment: This tests to see if a gateway is able to resolve ArNS names correctly. The first thing you should check is if you have the "),t("code",[e._v("ARNS_ROOT_HOST")]),e._v(" value set in your .env file. If not, set the value and restart your gateway. If this value is set, check to make sure you have current DNS records and SSL certificates for wildcard subdomains on your gateway.")])])])]),e._v(" "),t("h3",{attrs:{id:"-6"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#-6"}},[e._v("#")])]),e._v(" "),t("details",[t("summary",[t("strong",[e._v("I updated my .env settings, but nothing changed on my gateway")])]),e._v(" "),t("p",[e._v('Once you edit your .env file, you need to "rebuild" your gateway for the changes to take effect. As of release 3, every time you start your gateway with '),t("code",[e._v("docker-compose")]),e._v(" it is automatically rebuilt. So all you need to do is shut your gateway down and restart it.")])]),e._v(" "),t("h3",{attrs:{id:"-7"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#-7"}},[e._v("#")])]),e._v(" "),t("details",[t("summary",[t("strong",[e._v("I am getting an out of disk space error, but I still have open storage space on my computer")])]),e._v(" "),t("p",[e._v("The most likely cause of this is inode exhaustion. Test this by running the command:")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("df -i\n")])])]),t("p",[e._v("If one of the lines in the output says 100%, you have run out of inodes and so your filesystem is not capable of creating new files, even if you have available space. The solution is to delete files from your "),t("code",[e._v("data")]),e._v(" folder in order to free up inodes.")]),e._v(" "),t("p",[e._v("This was a common issue prior to release #3, when Redis caching was introduced to reduce the number of small files created. If you are using an older version of the gateway, consider upgrading to mitigate the risk of inode exhaustion.")])]),e._v(" "),t("h3",{attrs:{id:"-8"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#-8"}},[e._v("#")])]),e._v(" "),t("details",[t("summary",[t("strong",[e._v("I can't load ArNS names")])]),e._v(" "),t("p",[e._v("The first thing you should check if your gateway is not resolving ArNS names is that you have "),t("code",[e._v("ARNS_ROOT_HOST")]),e._v(" set in your .env file. If not, set it to your domain name used for the gateway. For example, "),t("code",[e._v("ARNS_ROOT_HOST=arweave.dev")]),e._v(".")]),e._v(" "),t("p",[e._v("Once this value is set, restart your gateway for the changes to take effect.")]),e._v(" "),t("p",[e._v("If that doesn't resolve the issue, check your dns records. You need to have a wildcard subdomain ( *.< your-domain > ) set with your domain registrar so that ArNS names will actually point at your gateway. You can set this record, and generate an SSL certificate for it, in the same way you set the records for your primary domain.")])]),e._v(" "),t("br"),e._v(" "),t("h2",{attrs:{id:"my-gateway-was-running-but-now-it-isn-t"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#my-gateway-was-running-but-now-it-isn-t"}},[e._v("#")]),e._v(" My Gateway was Running, but now it isn't")]),e._v(" "),t("h3",{attrs:{id:"-9"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#-9"}},[e._v("#")])]),e._v(" "),t("details",[t("summary",[t("strong",[e._v('When I try to access my gateway in a browser I get a "Your connection is not private" error')])]),e._v(" "),t("p",[e._v("This error message means that your SSL certificates have expired. You need to renew your certificates by running the same certbot command you used when you initially started your gateway:")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("sudo certbot certonly --manual --preferred-challenges dns --email -d .com -d '*..com'\n")])])]),t("p",[e._v("Certbot SSL certificates expire after 90 days, and you will need to rerun this command to renew every time. If you provide an email address, you will receive an email letting you know when it is time to renew.")])]),e._v(" "),t("br"),e._v(" "),t("h2",{attrs:{id:"i-am-having-trouble-getting-my-gateway-set-up"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#i-am-having-trouble-getting-my-gateway-set-up"}},[e._v("#")]),e._v(" I am having Trouble Getting my Gateway Set up")]),e._v(" "),t("br"),e._v(" "),t("h3",{attrs:{id:"-10"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#-10"}},[e._v("#")])]),e._v(" "),t("details",[t("summary",[t("strong",[e._v("I set my gateway up, but when I go to my domain I get a 404/Nginx error")])]),e._v(" "),t("p",[e._v("If you navigate to your domain and see a 404 error from Nginx (the reverse proxy server used in the setup guide) it means that your domain is correctly pointed at the machine running your gateway, but you have not properly configured your Nginx settings (or your gateway is not running).")]),e._v(" "),t("p",[e._v("The "),t("RouterLink",{attrs:{to:"/gateways/ar-io-node/linux-setup.html#set-up-networking"}},[e._v("Set up Networking")]),e._v(" section of the setup guide has detailed instructions on configuring your Nginx server. If all else fails, try restarting Nginx, that usually clears any issues with the server clinging to old configurations.")],1),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("sudo service nginx restart\n")])])])]),e._v(" "),t("h3",{attrs:{id:"-11"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#-11"}},[e._v("#")])]),e._v(" "),t("details",[t("summary",[e._v("When I visit my domain I see a 502 error from Nginx")]),e._v(" "),t("p",[e._v("A 502 error from Nginx means that Nginx is working correctly, but it is receiving an error from your gateway when it tries to forward traffic.")])]),e._v(" "),t("h3",{attrs:{id:"-12"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#-12"}},[e._v("#")])]),e._v(" "),t("details",[t("summary",[t("strong",[e._v("I am having trouble generating my SSL certificates")])]),e._v(" "),t("p",[e._v("When using the manual certbot command provided in the setup guide:")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("sudo certbot certonly --manual --preferred-challenges dns --email -d .com -d '*..com'\n")])])]),t("p",[e._v("You need to be sure that you are waiting after creating your TXT records for them to completely propagate. You can check propagation using a tool like "),t("a",{attrs:{href:"https://dnschecker.org",target:"_blank",rel:"noopener noreferrer"}},[e._v("dnschecker.org"),t("OutboundLink")],1),e._v(".")]),e._v(" "),t("p",[e._v("If you continue to have issues, you can check the "),t("a",{attrs:{href:"https://certbot.eff.org/instructions",target:"_blank",rel:"noopener noreferrer"}},[e._v("official certbot instructions guide"),t("OutboundLink")],1),e._v(".")])]),e._v(" "),t("br"),e._v(" "),t("p",[e._v("If you do not see your issue listed here, or if you were not able to solve your problem with the above information, feel free to reach out in the ar.io discord.")]),e._v(" "),t("h2",{attrs:{id:"quick-lookup"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#quick-lookup"}},[e._v("#")]),e._v(" Quick Lookup")]),e._v(" "),t("p",[e._v("Below is a quick summary of what you should check when troubleshooting your gateway. Find more detailed information in the sections above.")]),e._v(" "),t("div",{staticStyle:{"text-align":"center"}},[t("table",{staticClass:"inline-table",staticStyle:{"text-align":"left"}},[t("tr",{staticStyle:{"text-align":"center"}},[t("th",[e._v("Issue")]),e._v(" "),t("th",[e._v("What to Check")])]),e._v(" "),t("tr",[t("td",[e._v("My release number is wrong")]),e._v(" "),t("td",[e._v("Pull the latest github updates and make sure you are on the "),t("code",[e._v("main")]),e._v(" branch")])]),e._v(" "),t("tr",[t("td",[e._v("Gateway appears offline on Viewblock or ar://gateways")]),e._v(" "),t("td",[e._v("Probably fine, but verify that your gateway is still running.")])]),e._v(" "),t("tr",[t("td",[e._v("'/ar-io/observer/reports/current' just says \"report pending\"")]),e._v(" "),t("td",[e._v("Normal behavior, wait for the report to complete.")])]),e._v(" "),t("tr",[t("td",[e._v('Observer error "Cannot read properties of undefined"')]),e._v(" "),t("td",[e._v("Normal behavior, Observer is checking for data not implemented yet.")])]),e._v(" "),t("tr",[t("td",[e._v("Observing my gateway shows failures")]),e._v(" "),t("td",[e._v("Check "),t("code",[e._v("AR_IO_WALLET")]),e._v(" and "),t("code",[e._v("ARNS_ROOT_HOST")]),e._v(" settings.")])]),e._v(" "),t("tr",[t("td",[e._v("Updated .env settings not reflected on gateway")]),e._v(" "),t("td",[e._v("Rebuild your gateway after editing .env file.")])]),e._v(" "),t("tr",[t("td",[e._v("Out of disk space error")]),e._v(" "),t("td",[e._v("Check for inode exhaustion and delete files if necessary.")])]),e._v(" "),t("tr",[t("td",[e._v("Can't load ArNS names")]),e._v(" "),t("td",[e._v("Check "),t("code",[e._v("ARNS_ROOT_HOST")]),e._v(" setting in .env file, and DNS records.")])]),e._v(" "),t("tr",[t("td",[e._v('"Your connection is not private" error')]),e._v(" "),t("td",[e._v("Generate or renew SSL certificates.")])]),e._v(" "),t("tr",[t("td",[e._v("404/Nginx error when accessing domain")]),e._v(" "),t("td",[e._v("Check Nginx settings and restart Nginx if necessary.")])]),e._v(" "),t("tr",[t("td",[e._v("502 error from Nginx")]),e._v(" "),t("td",[e._v("Check for errors in your gateway.")])]),e._v(" "),t("tr",[t("td",[e._v("Trouble generating SSL certificates")]),e._v(" "),t("td",[e._v("Ensure TXT records have propagated and follow certbot instructions.")])])])])])}),[],!1,null,null,null);t.default=s.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[53],{353:function(e,t,a){"use strict";a.r(t);var r=a(10),s=Object(r.a)({},(function(){var e=this,t=e._self._c;return t("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[t("h1",{attrs:{id:"troubleshooting"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#troubleshooting"}},[e._v("#")]),e._v(" Troubleshooting")]),e._v(" "),t("h2",{attrs:{id:"my-gateway-seems-to-be-running-but"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#my-gateway-seems-to-be-running-but"}},[e._v("#")]),e._v(" My Gateway Seems to be Running but...")]),e._v(" "),t("h3",{attrs:{id:""}},[t("a",{staticClass:"header-anchor",attrs:{href:"#"}},[e._v("#")])]),e._v(" "),t("details",[t("summary",[t("strong",[e._v('My release number doesn\'t match the latest version, or includes "-pre"')])]),e._v(" "),t("p",[e._v("If your release number when you go to "),t("code",[e._v("/ar-io/info")]),e._v(" is lower than the current release, you simply need to upgrade your gateway in order to reach the latest release.")]),e._v(" "),t("p",[e._v('If your release number includes the suffix "-pre" it means you are running your gateway from the development branch of the github repository, instead of the main branch. The development branch is used for staging work that the engineering team is in the middle of. Because of this, it can be much less stable than the main branch used for production and can cause significant issues.')]),e._v(" "),t("p",[e._v("Ensure that you are running the latest release, from the main branch, by running the below commands in your terminal:")]),e._v(" "),t("div",{staticClass:"language-console extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("sudo docker-compose down --rmi all\n\ngit checkout main\n\ngit pull\n\nsudo docker-compose up -d\n")])])]),t("p",[e._v("If this doesn't resolve the issue, you can also try a more extreme method of clearing out the incorrect docker images:")]),e._v(" "),t("div",{staticClass:"language-console extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("sudo docker-compose down\n\nsudo docker system prune -a\n\nsudo docker-compose up -d\n")])])])]),e._v(" "),t("h3",{attrs:{id:"-2"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#-2"}},[e._v("#")])]),e._v(" "),t("details",[t("summary",[t("strong",[e._v("It appears offline on "),t("a",{attrs:{target:"_blank",href:"https://viewblock.io/arweave/gateways"}},[e._v("Viewblock")]),e._v(" or "),t("a",{attrs:{target:"_blank",href:"https://gateways.arweave.dev"}},[e._v("ar://gateways")])])]),e._v(" "),t("p",[e._v('Viewblock and ar://gateways use a very simple ping method for determining if a gateway is "up". There are plenty of reasons why this ping may fail while the gateway is running perfectly, so showing as down is not cause for concern. Just verify that your gateway is still running, and wait. Your gateway will show as up again soon.')])]),e._v(" "),t("h3",{attrs:{id:"-3"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#-3"}},[e._v("#")])]),e._v(" "),t("details",[t("summary",[t("strong",[e._v('< gateway >/ar-io/observer/reports/current just says "report pending"')])]),e._v(" "),t("p",[e._v("This is normal. Your Observer is working to generate a report and that report will be displayed once it is complete.")])]),e._v(" "),t("h3",{attrs:{id:"-4"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#-4"}},[e._v("#")])]),e._v(" "),t("details",[t("summary",[t("strong",[e._v('My Observer is showing me the error "error: Error reading interaction: Cannot read properties of undefined"')])]),e._v(" "),t("p",[e._v("This is not an issue with your observer. The short explanation is that your Observer is looking for tasks assigned to it by the ar.io network contract, but there isnt anything there. You can safely ignore this error message.")])]),e._v(" "),t("h3",{attrs:{id:"-5"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#-5"}},[e._v("#")])]),e._v(" "),t("details",[t("summary",[t("strong",[e._v("Observing my gateway shows failures")])]),e._v(" "),t("p",[e._v('When observing a gateway, there are two main pass/fail tests. "Ownership" and "ArNS Assessment"')]),e._v(" "),t("ul",[t("li",[t("p",[e._v("Ownership: This tests to see if the value set in your gateway "),t("code",[e._v("AR_IO_WALLET")]),e._v(" value (in .env) matches the wallet used to join the AR.IO Network. If they don't match, update the value in your .env file and restart your gateway.")])]),e._v(" "),t("li",[t("p",[e._v("ArNS Assessment: This tests to see if a gateway is able to resolve ArNS names correctly. The first thing you should check is if you have the "),t("code",[e._v("ARNS_ROOT_HOST")]),e._v(" value set in your .env file. If not, set the value and restart your gateway. If this value is set, check to make sure you have current DNS records and SSL certificates for wildcard subdomains on your gateway.")])])])]),e._v(" "),t("h3",{attrs:{id:"-6"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#-6"}},[e._v("#")])]),e._v(" "),t("details",[t("summary",[t("strong",[e._v("I updated my .env settings, but nothing changed on my gateway")])]),e._v(" "),t("p",[e._v('Once you edit your .env file, you need to "rebuild" your gateway for the changes to take effect. As of release 3, every time you start your gateway with '),t("code",[e._v("docker-compose")]),e._v(" it is automatically rebuilt. So all you need to do is shut your gateway down and restart it.")])]),e._v(" "),t("h3",{attrs:{id:"-7"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#-7"}},[e._v("#")])]),e._v(" "),t("details",[t("summary",[t("strong",[e._v("I am getting an out of disk space error, but I still have open storage space on my computer")])]),e._v(" "),t("p",[e._v("The most likely cause of this is inode exhaustion. Test this by running the command:")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("df -i\n")])])]),t("p",[e._v("If one of the lines in the output says 100%, you have run out of inodes and so your filesystem is not capable of creating new files, even if you have available space. The solution is to delete files from your "),t("code",[e._v("data")]),e._v(" folder in order to free up inodes.")]),e._v(" "),t("p",[e._v("This was a common issue prior to release #3, when Redis caching was introduced to reduce the number of small files created. If you are using an older version of the gateway, consider upgrading to mitigate the risk of inode exhaustion.")])]),e._v(" "),t("h3",{attrs:{id:"-8"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#-8"}},[e._v("#")])]),e._v(" "),t("details",[t("summary",[t("strong",[e._v("I can't load ArNS names")])]),e._v(" "),t("p",[e._v("The first thing you should check if your gateway is not resolving ArNS names is that you have "),t("code",[e._v("ARNS_ROOT_HOST")]),e._v(" set in your .env file. If not, set it to your domain name used for the gateway. For example, "),t("code",[e._v("ARNS_ROOT_HOST=arweave.dev")]),e._v(".")]),e._v(" "),t("p",[e._v("Once this value is set, restart your gateway for the changes to take effect.")]),e._v(" "),t("p",[e._v("If that doesn't resolve the issue, check your dns records. You need to have a wildcard subdomain ( *.< your-domain > ) set with your domain registrar so that ArNS names will actually point at your gateway. You can set this record, and generate an SSL certificate for it, in the same way you set the records for your primary domain.")])]),e._v(" "),t("br"),e._v(" "),t("h2",{attrs:{id:"my-gateway-was-running-but-now-it-isn-t"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#my-gateway-was-running-but-now-it-isn-t"}},[e._v("#")]),e._v(" My Gateway was Running, but now it isn't")]),e._v(" "),t("h3",{attrs:{id:"-9"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#-9"}},[e._v("#")])]),e._v(" "),t("details",[t("summary",[t("strong",[e._v('When I try to access my gateway in a browser I get a "Your connection is not private" error')])]),e._v(" "),t("p",[e._v("This error message means that your SSL certificates have expired. You need to renew your certificates by running the same certbot command you used when you initially started your gateway:")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("sudo certbot certonly --manual --preferred-challenges dns --email -d .com -d '*..com'\n")])])]),t("p",[e._v("Certbot SSL certificates expire after 90 days, and you will need to rerun this command to renew every time. If you provide an email address, you will receive an email letting you know when it is time to renew.")])]),e._v(" "),t("br"),e._v(" "),t("h2",{attrs:{id:"i-am-having-trouble-getting-my-gateway-set-up"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#i-am-having-trouble-getting-my-gateway-set-up"}},[e._v("#")]),e._v(" I am having Trouble Getting my Gateway Set up")]),e._v(" "),t("br"),e._v(" "),t("h3",{attrs:{id:"-10"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#-10"}},[e._v("#")])]),e._v(" "),t("details",[t("summary",[t("strong",[e._v("I set my gateway up, but when I go to my domain I get a 404/Nginx error")])]),e._v(" "),t("p",[e._v("If you navigate to your domain and see a 404 error from Nginx (the reverse proxy server used in the setup guide) it means that your domain is correctly pointed at the machine running your gateway, but you have not properly configured your Nginx settings (or your gateway is not running).")]),e._v(" "),t("p",[e._v("The "),t("RouterLink",{attrs:{to:"/gateways/ar-io-node/linux-setup.html#set-up-networking"}},[e._v("Set up Networking")]),e._v(" section of the setup guide has detailed instructions on configuring your Nginx server. If all else fails, try restarting Nginx, that usually clears any issues with the server clinging to old configurations.")],1),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("sudo service nginx restart\n")])])])]),e._v(" "),t("h3",{attrs:{id:"-11"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#-11"}},[e._v("#")])]),e._v(" "),t("details",[t("summary",[e._v("When I visit my domain I see a 502 error from Nginx")]),e._v(" "),t("p",[e._v("A 502 error from Nginx means that Nginx is working correctly, but it is receiving an error from your gateway when it tries to forward traffic.")])]),e._v(" "),t("h3",{attrs:{id:"-12"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#-12"}},[e._v("#")])]),e._v(" "),t("details",[t("summary",[t("strong",[e._v("I am having trouble generating my SSL certificates")])]),e._v(" "),t("p",[e._v("When using the manual certbot command provided in the setup guide:")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("sudo certbot certonly --manual --preferred-challenges dns --email -d .com -d '*..com'\n")])])]),t("p",[e._v("You need to be sure that you are waiting after creating your TXT records for them to completely propagate. You can check propagation using a tool like "),t("a",{attrs:{href:"https://dnschecker.org",target:"_blank",rel:"noopener noreferrer"}},[e._v("dnschecker.org"),t("OutboundLink")],1),e._v(".")]),e._v(" "),t("p",[e._v("If you continue to have issues, you can check the "),t("a",{attrs:{href:"https://certbot.eff.org/instructions",target:"_blank",rel:"noopener noreferrer"}},[e._v("official certbot instructions guide"),t("OutboundLink")],1),e._v(".")])]),e._v(" "),t("br"),e._v(" "),t("p",[e._v("If you do not see your issue listed here, or if you were not able to solve your problem with the above information, feel free to reach out in the ar.io discord.")]),e._v(" "),t("h2",{attrs:{id:"quick-lookup"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#quick-lookup"}},[e._v("#")]),e._v(" Quick Lookup")]),e._v(" "),t("p",[e._v("Below is a quick summary of what you should check when troubleshooting your gateway. Find more detailed information in the sections above.")]),e._v(" "),t("div",{staticStyle:{"text-align":"center"}},[t("table",{staticClass:"inline-table",staticStyle:{"text-align":"left"}},[t("tr",{staticStyle:{"text-align":"center"}},[t("th",[e._v("Issue")]),e._v(" "),t("th",[e._v("What to Check")])]),e._v(" "),t("tr",[t("td",[e._v("My release number is wrong")]),e._v(" "),t("td",[e._v("Pull the latest github updates and make sure you are on the "),t("code",[e._v("main")]),e._v(" branch")])]),e._v(" "),t("tr",[t("td",[e._v("Gateway appears offline on Viewblock or ar://gateways")]),e._v(" "),t("td",[e._v("Probably fine, but verify that your gateway is still running.")])]),e._v(" "),t("tr",[t("td",[e._v("'/ar-io/observer/reports/current' just says \"report pending\"")]),e._v(" "),t("td",[e._v("Normal behavior, wait for the report to complete.")])]),e._v(" "),t("tr",[t("td",[e._v('Observer error "Cannot read properties of undefined"')]),e._v(" "),t("td",[e._v("Normal behavior, Observer is checking for data not implemented yet.")])]),e._v(" "),t("tr",[t("td",[e._v("Observing my gateway shows failures")]),e._v(" "),t("td",[e._v("Check "),t("code",[e._v("AR_IO_WALLET")]),e._v(" and "),t("code",[e._v("ARNS_ROOT_HOST")]),e._v(" settings.")])]),e._v(" "),t("tr",[t("td",[e._v("Updated .env settings not reflected on gateway")]),e._v(" "),t("td",[e._v("Rebuild your gateway after editing .env file.")])]),e._v(" "),t("tr",[t("td",[e._v("Out of disk space error")]),e._v(" "),t("td",[e._v("Check for inode exhaustion and delete files if necessary.")])]),e._v(" "),t("tr",[t("td",[e._v("Can't load ArNS names")]),e._v(" "),t("td",[e._v("Check "),t("code",[e._v("ARNS_ROOT_HOST")]),e._v(" setting in .env file, and DNS records.")])]),e._v(" "),t("tr",[t("td",[e._v('"Your connection is not private" error')]),e._v(" "),t("td",[e._v("Generate or renew SSL certificates.")])]),e._v(" "),t("tr",[t("td",[e._v("404/Nginx error when accessing domain")]),e._v(" "),t("td",[e._v("Check Nginx settings and restart Nginx if necessary.")])]),e._v(" "),t("tr",[t("td",[e._v("502 error from Nginx")]),e._v(" "),t("td",[e._v("Check for errors in your gateway.")])]),e._v(" "),t("tr",[t("td",[e._v("Trouble generating SSL certificates")]),e._v(" "),t("td",[e._v("Ensure TXT records have propagated and follow certbot instructions.")])])])])])}),[],!1,null,null,null);t.default=s.exports}}]); \ No newline at end of file diff --git a/assets/js/54.118e3bf4.js b/assets/js/54.59f50c69.js similarity index 98% rename from assets/js/54.118e3bf4.js rename to assets/js/54.59f50c69.js index 17ba4d77..1d417293 100644 --- a/assets/js/54.118e3bf4.js +++ b/assets/js/54.59f50c69.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[54],{356:function(e,t,a){"use strict";a.r(t);var r=a(10),s=Object(r.a)({},(function(){var e=this,t=e._self._c;return t("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[t("h1",{attrs:{id:"upgrading-your-gateway"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#upgrading-your-gateway"}},[e._v("#")]),e._v(" Upgrading your Gateway")]),e._v(" "),t("p",[e._v("To ensure the optimal performance and security of your AR.IO Gateway, it's essential to regularly upgrade to the latest version. Notably, indexed data resides separate from Docker. As a result, neither upgrading the Gateway nor pruning Docker will erase your data or progress. Here's how you can perform the upgrade:")]),e._v(" "),t("h2",{attrs:{id:"prerequisites"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#prerequisites"}},[e._v("#")]),e._v(" Prerequisites")]),e._v(" "),t("ul",[t("li",[e._v("Your Gateway should have been cloned using git. If you haven't, follow the installation instructions for "),t("a",{attrs:{href:"/gateways/ar-io-node/windows-setup"}},[e._v("windows")]),e._v(" or "),t("a",{attrs:{href:"/gateways/ar-io-node/linux-setup"}},[e._v("linux")]),e._v(".")])]),e._v(" "),t("h2",{attrs:{id:"checking-your-release-number"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#checking-your-release-number"}},[e._v("#")]),e._v(" Checking your Release Number")]),e._v(" "),t("p",[e._v("Effective with release 3, you can view the currently implemented release on any gateway by visiting "),t("code",[e._v("https:///ar-io/info")]),e._v(" in a browser. Be sure to replace "),t("code",[e._v("")]),e._v(" with the domain of the gateway you are checking.")]),e._v(" "),t("p",[e._v("If the release number displayed includes "),t("code",[e._v("-pre")]),e._v(" it means that your gateway is using the "),t("code",[e._v("develop")]),e._v(" branch of the github repo for the gateway code. Follow steps in our "),t("RouterLink",{attrs:{to:"/gateways/ar-io-node/troubleshooting.html"}},[e._v("troubleshooting guide")]),e._v(" to switch over to the more stable "),t("code",[e._v("main")]),e._v(" branch.")],1),e._v(" "),t("p",[e._v("Announcements will be made in our "),t("a",{attrs:{href:"https://discord.gg/7zUPfN4D6g",target:"_blank",rel:"noopener noreferrer"}},[e._v("discord server"),t("OutboundLink")],1),e._v(" showing each new release.")]),e._v(" "),t("h2",{attrs:{id:"upgrade-steps"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#upgrade-steps"}},[e._v("#")]),e._v(" Upgrade Steps")]),e._v(" "),t("ol",[t("li",[t("p",[t("strong",[e._v("Pull the latest changes from the repository")])]),e._v(" "),t("p",[e._v("Navigate to your cloned repository directory and execute the following command:")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("git pull\n")])])])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Shut down Docker")])]),e._v(" "),t("p",[e._v("Depending on your operating system, use the respective commands:")]),e._v(" "),t("details",[t("summary",[e._v("Linux")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("sudo docker-compose down -v\n")])])])]),e._v(" "),t("details",[t("summary",[e._v("Windows")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("\ndocker-compose down -v\n\n")])])])])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Prune Docker")]),e._v(" (Optional)")]),e._v(" "),t("p",[e._v("It's a good practice to clean up unused Docker resources. Again, use the command based on your OS:")]),e._v(" "),t("p",[t("strong",[e._v("NOTE")]),e._v(": This will erase all inactive docker containers on your machine. If you use docker for anything beyond running a gateway be extremely careful using this command.")]),e._v(" "),t("details",[t("summary",[e._v("Linux")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("\nsudo docker system prune\n\n")])])])]),e._v(" "),t("details",[t("summary",[e._v("Windows")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("\ndocker system prune\n\n")])])])])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Check for New Environmental Variables")])]),e._v(" "),t("p",[e._v("Read the update release change logs and community announcements to see if the new version includes any new environmental variables that you should set before restarting your gateway.")])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Restart the Docker container")])]),e._v(" "),t("p",[e._v("Finally, start the Docker container again to implement the changes:")]),e._v(" "),t("details",[t("summary",[e._v("Linux")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("sudo docker-compose up -d\n")])])])]),e._v(" "),t("details",[t("summary",[e._v("Windows")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("docker-compose up -d\n")])])]),t("p",[t("strong",[e._v("NOTE")]),e._v(": Effective with Release #3, it is no longer required to include the "),t("code",[e._v("--build")]),e._v(" flag when starting your gateway. Docker will automatically build using the image specified in the "),t("code",[e._v("docker-commpose.yaml")]),e._v(" file.")])])])]),e._v(" "),t("p",[e._v("That's it! Your AR.IO Gateway is now upgraded to the latest version. Ensure to test and verify that everything is functioning as expected. If you encounter any issues, reach out to the "),t("a",{attrs:{href:"https://discord.gg/7zUPfN4D6g",target:"_blank",rel:"noopener noreferrer"}},[e._v("AR.IO community"),t("OutboundLink")],1),e._v(" for assistance.")])])}),[],!1,null,null,null);t.default=s.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[54],{354:function(e,t,a){"use strict";a.r(t);var r=a(10),s=Object(r.a)({},(function(){var e=this,t=e._self._c;return t("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[t("h1",{attrs:{id:"upgrading-your-gateway"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#upgrading-your-gateway"}},[e._v("#")]),e._v(" Upgrading your Gateway")]),e._v(" "),t("p",[e._v("To ensure the optimal performance and security of your AR.IO Gateway, it's essential to regularly upgrade to the latest version. Notably, indexed data resides separate from Docker. As a result, neither upgrading the Gateway nor pruning Docker will erase your data or progress. Here's how you can perform the upgrade:")]),e._v(" "),t("h2",{attrs:{id:"prerequisites"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#prerequisites"}},[e._v("#")]),e._v(" Prerequisites")]),e._v(" "),t("ul",[t("li",[e._v("Your Gateway should have been cloned using git. If you haven't, follow the installation instructions for "),t("a",{attrs:{href:"/gateways/ar-io-node/windows-setup"}},[e._v("windows")]),e._v(" or "),t("a",{attrs:{href:"/gateways/ar-io-node/linux-setup"}},[e._v("linux")]),e._v(".")])]),e._v(" "),t("h2",{attrs:{id:"checking-your-release-number"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#checking-your-release-number"}},[e._v("#")]),e._v(" Checking your Release Number")]),e._v(" "),t("p",[e._v("Effective with release 3, you can view the currently implemented release on any gateway by visiting "),t("code",[e._v("https:///ar-io/info")]),e._v(" in a browser. Be sure to replace "),t("code",[e._v("")]),e._v(" with the domain of the gateway you are checking.")]),e._v(" "),t("p",[e._v("If the release number displayed includes "),t("code",[e._v("-pre")]),e._v(" it means that your gateway is using the "),t("code",[e._v("develop")]),e._v(" branch of the github repo for the gateway code. Follow steps in our "),t("RouterLink",{attrs:{to:"/gateways/ar-io-node/troubleshooting.html"}},[e._v("troubleshooting guide")]),e._v(" to switch over to the more stable "),t("code",[e._v("main")]),e._v(" branch.")],1),e._v(" "),t("p",[e._v("Announcements will be made in our "),t("a",{attrs:{href:"https://discord.gg/7zUPfN4D6g",target:"_blank",rel:"noopener noreferrer"}},[e._v("discord server"),t("OutboundLink")],1),e._v(" showing each new release.")]),e._v(" "),t("h2",{attrs:{id:"upgrade-steps"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#upgrade-steps"}},[e._v("#")]),e._v(" Upgrade Steps")]),e._v(" "),t("ol",[t("li",[t("p",[t("strong",[e._v("Pull the latest changes from the repository")])]),e._v(" "),t("p",[e._v("Navigate to your cloned repository directory and execute the following command:")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("git pull\n")])])])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Shut down Docker")])]),e._v(" "),t("p",[e._v("Depending on your operating system, use the respective commands:")]),e._v(" "),t("details",[t("summary",[e._v("Linux")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("sudo docker-compose down -v\n")])])])]),e._v(" "),t("details",[t("summary",[e._v("Windows")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("\ndocker-compose down -v\n\n")])])])])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Prune Docker")]),e._v(" (Optional)")]),e._v(" "),t("p",[e._v("It's a good practice to clean up unused Docker resources. Again, use the command based on your OS:")]),e._v(" "),t("p",[t("strong",[e._v("NOTE")]),e._v(": This will erase all inactive docker containers on your machine. If you use docker for anything beyond running a gateway be extremely careful using this command.")]),e._v(" "),t("details",[t("summary",[e._v("Linux")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("\nsudo docker system prune\n\n")])])])]),e._v(" "),t("details",[t("summary",[e._v("Windows")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("\ndocker system prune\n\n")])])])])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Check for New Environmental Variables")])]),e._v(" "),t("p",[e._v("Read the update release change logs and community announcements to see if the new version includes any new environmental variables that you should set before restarting your gateway.")])]),e._v(" "),t("li",[t("p",[t("strong",[e._v("Restart the Docker container")])]),e._v(" "),t("p",[e._v("Finally, start the Docker container again to implement the changes:")]),e._v(" "),t("details",[t("summary",[e._v("Linux")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("sudo docker-compose up -d\n")])])])]),e._v(" "),t("details",[t("summary",[e._v("Windows")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("docker-compose up -d\n")])])]),t("p",[t("strong",[e._v("NOTE")]),e._v(": Effective with Release #3, it is no longer required to include the "),t("code",[e._v("--build")]),e._v(" flag when starting your gateway. Docker will automatically build using the image specified in the "),t("code",[e._v("docker-commpose.yaml")]),e._v(" file.")])])])]),e._v(" "),t("p",[e._v("That's it! Your AR.IO Gateway is now upgraded to the latest version. Ensure to test and verify that everything is functioning as expected. If you encounter any issues, reach out to the "),t("a",{attrs:{href:"https://discord.gg/7zUPfN4D6g",target:"_blank",rel:"noopener noreferrer"}},[e._v("AR.IO community"),t("OutboundLink")],1),e._v(" for assistance.")])])}),[],!1,null,null,null);t.default=s.exports}}]); \ No newline at end of file diff --git a/assets/js/55.a87a240c.js b/assets/js/55.6580bd85.js similarity index 99% rename from assets/js/55.a87a240c.js rename to assets/js/55.6580bd85.js index ecb57a23..d6642c37 100644 --- a/assets/js/55.a87a240c.js +++ b/assets/js/55.6580bd85.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[55],{354:function(e,t,o){"use strict";o.r(t);var r=o(10),a=Object(r.a)({},(function(){var e=this,t=e._self._c;return t("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[t("h1",{attrs:{id:"windows-installation-instructions"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#windows-installation-instructions"}},[e._v("#")]),e._v(" Windows Installation Instructions")]),e._v(" "),t("h2",{attrs:{id:"overview"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#overview"}},[e._v("#")]),e._v(" Overview")]),e._v(" "),t("p",[e._v("This guide provides step-by-step instructions for setting up the AR.IO node on a Windows computer. It covers installing necessary software, cloning the repository, creating an environment file, starting the Docker container, setting up networking, and installing and configuring NGINX Docker. No prior coding experience is required.")]),e._v(" "),t("h2",{attrs:{id:"prerequisites"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#prerequisites"}},[e._v("#")]),e._v(" Prerequisites")]),e._v(" "),t("p",[e._v("Before starting the installation process, ensure you have the following:")]),e._v(" "),t("ul",[t("li",[e._v("A Windows computer")]),e._v(" "),t("li",[e._v("Administrative privileges on the computer")])]),e._v(" "),t("h2",{attrs:{id:"install-required-packages"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#install-required-packages"}},[e._v("#")]),e._v(" Install Required Packages")]),e._v(" "),t("ol",[t("li",[t("p",[e._v("Install Docker:")]),e._v(" "),t("ul",[t("li",[e._v("Download Docker Desktop for Windows from "),t("a",{attrs:{href:"https://www.docker.com/products/docker-desktop/",target:"_blank",rel:"noopener noreferrer"}},[e._v("here"),t("OutboundLink")],1),e._v(".")]),e._v(" "),t("li",[e._v("Run the installer and follow the prompts.")]),e._v(" "),t("li",[e._v("During installation, make sure to select the option to use WSL (Windows Subsystem for Linux) rather than Hyper-V.")]),e._v(" "),t("li",[e._v("Restart your PC.")]),e._v(" "),t("li",[e._v("Update Windows Subsystem for Linux (WSL):\n"),t("ul",[t("li",[e._v("Open the command prompt as an administrator:\n"),t("ul",[t("li",[e._v("Press Windows Key + R.")]),e._v(" "),t("li",[e._v("Type cmd and press Enter.")]),e._v(" "),t("li",[e._v('Right-click on the "Command Prompt" application in the search results.')]),e._v(" "),t("li",[e._v('Select "Run as administrator" from the context menu.')])])]),e._v(" "),t("li",[e._v("Run the following commands:"),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("wsl --update\nwsl --shutdown\n")])])])])])]),e._v(" "),t("li",[e._v("Restart Docker Desktop.")])])]),e._v(" "),t("li",[t("p",[e._v("Install Git:")]),e._v(" "),t("ul",[t("li",[e._v("Download Git for Windows from "),t("a",{attrs:{href:"https://git-scm.com/download/win",target:"_blank",rel:"noopener noreferrer"}},[e._v("here"),t("OutboundLink")],1),e._v(".")]),e._v(" "),t("li",[e._v("Run the installer and use the default settings.")])])])]),e._v(" "),t("h2",{attrs:{id:"clone-the-repository"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#clone-the-repository"}},[e._v("#")]),e._v(" Clone the Repository")]),e._v(" "),t("ol",[t("li",[e._v("Clone the main repository:\n"),t("ul",[t("li",[e._v("Open the command prompt:\n"),t("ul",[t("li",[e._v("Press "),t("code",[e._v("Windows Key + R")]),e._v(".")]),e._v(" "),t("li",[e._v("Type "),t("code",[e._v("cmd")]),e._v(" and press "),t("code",[e._v("Enter")]),e._v(".")])])]),e._v(" "),t("li",[e._v("Navigate to the directory where you want to clone the repository:\n"),t("ul",[t("li",[e._v("Use the "),t("code",[e._v("cd")]),e._v(" command to change directories. For example, to navigate to the "),t("code",[e._v("Documents")]),e._v(" directory:"),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("cd Documents\n")])])]),t("ul",[t("li",[e._v("More detailed instructions on navigating with the "),t("code",[e._v("cd")]),e._v(" command can be found "),t("a",{attrs:{href:"https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/cd",target:"_blank",rel:"noopener noreferrer"}},[e._v("here"),t("OutboundLink")],1)]),e._v(" "),t("li",[t("strong",[e._v("NOTE")]),e._v(": Your database of Arweave Transaction Headers will be created in the project directory, not Docker. So, if you are using an external hard drive to turn an old machine into a node, install the node directly to that external drive.")])])])])]),e._v(" "),t("li",[e._v("Run the following command:"),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("git clone -b main https://github.com/ar-io/ar-io-node\n")])])])])])])]),e._v(" "),t("h2",{attrs:{id:"create-the-environment-file"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#create-the-environment-file"}},[e._v("#")]),e._v(" Create the Environment File")]),e._v(" "),t("ol",[t("li",[t("p",[e._v("Create an environmental variables file:")]),e._v(" "),t("ul",[t("li",[t("p",[e._v("Open a text editor (e.g., Notepad):")]),e._v(" "),t("ul",[t("li",[e._v("Press "),t("code",[e._v("Windows Key")]),e._v(' and search for "Notepad".')]),e._v(" "),t("li",[e._v('Click on "Notepad" to open the text editor.')])])]),e._v(" "),t("li",[t("p",[e._v("Paste the following content into the new file, replacing with the domain address you are using to access the node, and with the public address of your Arweave wallet:")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("GRAPHQL_HOST=arweave.net\nGRAPHQL_PORT=443\nSTART_HEIGHT=0\nRUN_OBSERVER=true\nARNS_ROOT_HOST=\nAR_IO_WALLET=\nOBSERVER_WALLET=\n")])])]),t("ul",[t("li",[e._v("The GRAPHQL values set the proxy for GQL queries to arweave.net, You may use any available gateway that supports GQL queries. If omitted, your node can support GQL queries on locally indexed transactions, but only L1 transactions are indexed by default.")]),e._v(" "),t("li",[t("code",[e._v("START_HEIGHT")]),e._v(" is an optional line. It sets the block number where your node will start downloading and indexing transactions headers. Omitting this line will begin indexing at block 0.")]),e._v(" "),t("li",[t("code",[e._v("RUN_OBSERVER")]),e._v(" turns on the Observer to generate Network Compliance Reports. This is required for full participation in the AR.IO Network. Set to "),t("code",[e._v("false")]),e._v(" to run your gateway without Observer.")]),e._v(" "),t("li",[t("code",[e._v("ARNS_ROOT_HOST")]),e._v(" sets the starting point for resolving ARNS names, which are accessed as a subdomain of a gateway. It should be set to the url you are pointing to your node, excluding any protocol prefix. For example, use "),t("code",[e._v("node-ar.io")]),e._v(" and not "),t("code",[e._v("https://node-ar.io")]),e._v(". If you are using a subdomain to access your node and do not set this value, the node will not understand incoming requests.")]),e._v(" "),t("li",[t("code",[e._v("AR_IO_WALLET")]),e._v(" is optional, and sets the wallet you want associated with your Gateway. An associated wallet is required to join the AR.IO network.")]),e._v(" "),t("li",[t("code",[e._v("OBSERVER_WALLET")]),e._v(" is the public address of the wallet used to sign Observer transactions. This is required for Observer to run, but may be omitted if you are running a gateway outside of the AR.IO network and do not plan to run Observer. You will need to supply the keyfile to this wallet in the next step.")])])])]),e._v(" "),t("p",[e._v("Advanced configuration options can be found at "),t("a",{attrs:{href:"https://docs.ar.io/gateways/ar-io-node/advanced-config.html",target:"_blank",rel:"noopener noreferrer"}},[e._v("docs.ar.io"),t("OutboundLink")],1)]),e._v(" "),t("ul",[t("li",[e._v('Save the file with the name ".env" and make sure to select "All Files" as the file type. This helps to ensure the file saves as ".env" and not ".env.txt"')])]),e._v(" "),t("p",[t("strong",[e._v("Note")]),e._v(": The "),t("code",[e._v(".env")]),e._v(" file should be saved inside the same directory where you cloned the repository (e.g., "),t("code",[e._v("ar-io-node")]),e._v(").")])])]),e._v(" "),t("h2",{attrs:{id:"supply-your-observer-wallet-keyfile"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#supply-your-observer-wallet-keyfile"}},[e._v("#")]),e._v(" Supply Your Observer Wallet Keyfile:")]),e._v(" "),t("p",[e._v("If you are running Observer, you need to provide a wallet keyfile in order to sign report upload transactions. The keyfile must be saved in the "),t("code",[e._v("wallets")]),e._v(" directory in the root of the repository. Name the file "),t("code",[e._v(".json")]),e._v(', replacing "" with the public address of the wallet. This should match your '),t("code",[e._v("OBSERVER_WALLET")]),e._v(" environmental variable.")]),e._v(" "),t("p",[e._v("Learn more about creating Arweave wallets and obtaining keyfiles "),t("a",{attrs:{href:"https://ar.io/wallet/",target:"_blank",rel:"noopener noreferrer"}},[e._v("here"),t("OutboundLink")],1)]),e._v(" "),t("h2",{attrs:{id:"start-the-docker-containers"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#start-the-docker-containers"}},[e._v("#")]),e._v(" Start the Docker Containers")]),e._v(" "),t("ol",[t("li",[e._v("Start the Docker container:\n"),t("ul",[t("li",[t("p",[e._v("Open the command prompt:")]),e._v(" "),t("ul",[t("li",[e._v("Press "),t("code",[e._v("Windows Key + R")]),e._v(".")]),e._v(" "),t("li",[e._v("Type "),t("code",[e._v("cmd")]),e._v(" and press "),t("code",[e._v("Enter")]),e._v(".")])])]),e._v(" "),t("li",[t("p",[e._v("Navigate to the directory where you cloned the repository (e.g., "),t("code",[e._v("ar-io-node")]),e._v("):")]),e._v(" "),t("ul",[t("li",[e._v("Use the "),t("code",[e._v("cd")]),e._v(" command to change directories. For example, if the repository is located in the "),t("code",[e._v("Documents")]),e._v(" directory, you would enter:"),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("cd Documents\\ar-io-node\n")])])])]),e._v(" "),t("li",[e._v("If the directory path contains spaces, enclose it in double quotation marks. For example:"),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v('cd "C:\\My Documents\\ar-io-node"\n')])])])]),e._v(" "),t("li",[e._v("Use the "),t("code",[e._v("dir")]),e._v(" command to list the contents of the current directory and verify that you're in the correct location:"),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("dir\n")])])])])])]),e._v(" "),t("li",[t("p",[e._v("Once you are in the correct directory, run the following command to start the Docker container:")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("docker compose up -d\n")])])]),t("ul",[t("li",[t("p",[e._v("Explanation of flags:")]),e._v(" "),t("ul",[t("li",[t("code",[e._v("up")]),e._v(": Start the Docker containers.")]),e._v(" "),t("li",[t("code",[e._v("-d")]),e._v(": Run the containers as background processes (detached mode).")])]),e._v(" "),t("p",[t("strong",[e._v("NOTE")]),e._v(": Effective with Release #3, it is no longer required to include the "),t("code",[e._v("--build")]),e._v(" flag when starting your gateway. Docker will automatically build using the image specified in the "),t("code",[e._v("docker-commpose.yaml")]),e._v(" file.")]),e._v(" "),t("p",[e._v("The gateway can be shut down using the command:")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("docker compose down\n")])])])])])]),e._v(" "),t("li",[t("p",[e._v("If prompted by the firewall, allow access for Docker when requested.")])])])])]),e._v(" "),t("h2",{attrs:{id:"set-up-router-port-forwarding"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#set-up-router-port-forwarding"}},[e._v("#")]),e._v(" Set Up Router Port Forwarding")]),e._v(" "),t("p",[e._v("To expose your node to the internet and use a custom domain, follow these steps:")]),e._v(" "),t("ol",[t("li",[t("p",[e._v("Obtain a Domain Name:")]),e._v(" "),t("ul",[t("li",[e._v("Choose a domain registrar (e.g., "),t("a",{attrs:{href:"https://www.namecheap.com",target:"_blank",rel:"noopener noreferrer"}},[e._v("Namecheap"),t("OutboundLink")],1),e._v(") and purchase a domain name.")])])]),e._v(" "),t("li",[t("p",[e._v("Point the Domain at Your Home Network:")]),e._v(" "),t("ul",[t("li",[e._v("In your browser, go to https://www.whatsmyip.org/ to display your public ip address. It can be found at the top of the screen. Note this number down.")]),e._v(" "),t("li",[e._v("Access your domain registrar's settings (e.g., Namecheap's cPanel).")]),e._v(" "),t("li",[e._v('Navigate to the DNS settings for your domain. In cPanel this is under the "Zone Editor" tab.')]),e._v(" "),t("li",[e._v('Create an A record with your registrar for your domain and wildcard subdomains, using your public IP address. For example, if your domain is "ar.io," create a record for "ar.io" and "*.ar.io."\n'),t("ul",[t("li",[e._v("Instructions may vary depending on the domain registrar and cPanel. Consult your registrar's documentation or support for detailed steps.")])])])])]),e._v(" "),t("li",[t("p",[e._v("Obtain the Local IP Address of Your Machine:")]),e._v(" "),t("ul",[t("li",[e._v("Open the command prompt:\n"),t("ul",[t("li",[e._v("Press "),t("code",[e._v("Windows Key + R")]),e._v(".")]),e._v(" "),t("li",[e._v("Type "),t("code",[e._v("cmd")]),e._v(" and press "),t("code",[e._v("Enter")]),e._v(".")])])]),e._v(" "),t("li",[e._v("Run the following command:"),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("ipconfig\n")])])])]),e._v(" "),t("li",[e._v("Look for the network adapter that is currently connected to your network (e.g., Ethernet or Wi-Fi).")]),e._v(" "),t("li",[e._v("Note down the IPv4 Address associated with the network adapter. It should be in the format of "),t("code",[e._v("192.168.X.X")]),e._v(" or "),t("code",[e._v("10.X.X.X")]),e._v(".")]),e._v(" "),t("li",[e._v("This IP address will be used for port forwarding.")])])]),e._v(" "),t("li",[t("p",[e._v("Set Up Router Port Forwarding:")]),e._v(" "),t("ul",[t("li",[e._v("Access your home router settings:\n"),t("ul",[t("li",[e._v("Open a web browser.")]),e._v(" "),t("li",[e._v("Enter your router's IP address in the address bar (e.g., "),t("code",[e._v("192.168.0.1")]),e._v(").")]),e._v(" "),t("li",[e._v("If you're unsure of your router's IP address, consult your router's documentation or contact your Internet Service Provider (ISP).")])])]),e._v(" "),t("li",[e._v("Navigate to the port forwarding settings in your router configuration.\n"),t("ul",[t("li",[e._v("The exact steps may vary depending on your router model. Consult your router's documentation or support for detailed steps.")])])]),e._v(" "),t("li",[e._v("Set up port forwarding rules to forward incoming traffic on ports 80 and 443 to the local IP address of your machine where the node is installed.\n"),t("ul",[t("li",[e._v("Configure the ports to point to the local IP address noted in the previous step.")]),e._v(" "),t("li",[e._v("Save the settings.")])])])])])]),e._v(" "),t("h2",{attrs:{id:"install-and-configure-nginx-docker"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#install-and-configure-nginx-docker"}},[e._v("#")]),e._v(" Install and Configure NGINX Docker")]),e._v(" "),t("ol",[t("li",[t("p",[e._v("Clone the NGINX Docker repository:")]),e._v(" "),t("ul",[t("li",[e._v("Open the command prompt:\n"),t("ul",[t("li",[e._v("Press "),t("code",[e._v("Windows Key + R")]),e._v(".")]),e._v(" "),t("li",[e._v("Type "),t("code",[e._v("cmd")]),e._v(" and press "),t("code",[e._v("Enter")]),e._v(".")])])]),e._v(" "),t("li",[e._v("Navigate to the directory where you want to clone the repository (This should not be done inside the directory for the node):\n"),t("ul",[t("li",[e._v("Use the "),t("code",[e._v("cd")]),e._v(" command to change directories. For example, to navigate to the "),t("code",[e._v("Documents")]),e._v(" directory:"),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("cd Documents\n")])])])])])]),e._v(" "),t("li",[e._v("Run the following command:"),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("git clone -b main https://github.com/bobinstein/dockerized-nginx\n")])])])])]),e._v(" "),t("p",[t("strong",[e._v("Note")]),e._v(": This NGINX container was designed to easily automate many of the more technical aspects of setting up NGNIX and obtaining an ssl certificate so your node can be accessed with https. However, wildcard domain certifications cannot be universally automated due to significant security concerns. Be sure to follow the instructions in this project for obtaining wildcard domain certificates in order for your node to function properly.")])]),e._v(" "),t("li",[t("p",[e._v("Follow the instructions provided in the repository for setting up NGINX Docker.")])])]),e._v(" "),t("p",[e._v("Congratulations! Your AR.IO node is now running and connected to the internet. Test it by entering https:///3lyxgbgEvqNSvJrTX2J7CfRychUD5KClFhhVLyTPNCQ in your browser.")]),e._v(" "),t("p",[t("strong",[e._v("Note")]),e._v(": If you encounter any issues during the installation process, please seek assistance from the "),t("a",{attrs:{href:"https://discord.gg/7zUPfN4D6g",target:"_blank",rel:"noopener noreferrer"}},[e._v("AR.IO community"),t("OutboundLink")],1),e._v(".")])])}),[],!1,null,null,null);t.default=a.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[55],{355:function(e,t,o){"use strict";o.r(t);var r=o(10),a=Object(r.a)({},(function(){var e=this,t=e._self._c;return t("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[t("h1",{attrs:{id:"windows-installation-instructions"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#windows-installation-instructions"}},[e._v("#")]),e._v(" Windows Installation Instructions")]),e._v(" "),t("h2",{attrs:{id:"overview"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#overview"}},[e._v("#")]),e._v(" Overview")]),e._v(" "),t("p",[e._v("This guide provides step-by-step instructions for setting up the AR.IO node on a Windows computer. It covers installing necessary software, cloning the repository, creating an environment file, starting the Docker container, setting up networking, and installing and configuring NGINX Docker. No prior coding experience is required.")]),e._v(" "),t("h2",{attrs:{id:"prerequisites"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#prerequisites"}},[e._v("#")]),e._v(" Prerequisites")]),e._v(" "),t("p",[e._v("Before starting the installation process, ensure you have the following:")]),e._v(" "),t("ul",[t("li",[e._v("A Windows computer")]),e._v(" "),t("li",[e._v("Administrative privileges on the computer")])]),e._v(" "),t("h2",{attrs:{id:"install-required-packages"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#install-required-packages"}},[e._v("#")]),e._v(" Install Required Packages")]),e._v(" "),t("ol",[t("li",[t("p",[e._v("Install Docker:")]),e._v(" "),t("ul",[t("li",[e._v("Download Docker Desktop for Windows from "),t("a",{attrs:{href:"https://www.docker.com/products/docker-desktop/",target:"_blank",rel:"noopener noreferrer"}},[e._v("here"),t("OutboundLink")],1),e._v(".")]),e._v(" "),t("li",[e._v("Run the installer and follow the prompts.")]),e._v(" "),t("li",[e._v("During installation, make sure to select the option to use WSL (Windows Subsystem for Linux) rather than Hyper-V.")]),e._v(" "),t("li",[e._v("Restart your PC.")]),e._v(" "),t("li",[e._v("Update Windows Subsystem for Linux (WSL):\n"),t("ul",[t("li",[e._v("Open the command prompt as an administrator:\n"),t("ul",[t("li",[e._v("Press Windows Key + R.")]),e._v(" "),t("li",[e._v("Type cmd and press Enter.")]),e._v(" "),t("li",[e._v('Right-click on the "Command Prompt" application in the search results.')]),e._v(" "),t("li",[e._v('Select "Run as administrator" from the context menu.')])])]),e._v(" "),t("li",[e._v("Run the following commands:"),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("wsl --update\nwsl --shutdown\n")])])])])])]),e._v(" "),t("li",[e._v("Restart Docker Desktop.")])])]),e._v(" "),t("li",[t("p",[e._v("Install Git:")]),e._v(" "),t("ul",[t("li",[e._v("Download Git for Windows from "),t("a",{attrs:{href:"https://git-scm.com/download/win",target:"_blank",rel:"noopener noreferrer"}},[e._v("here"),t("OutboundLink")],1),e._v(".")]),e._v(" "),t("li",[e._v("Run the installer and use the default settings.")])])])]),e._v(" "),t("h2",{attrs:{id:"clone-the-repository"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#clone-the-repository"}},[e._v("#")]),e._v(" Clone the Repository")]),e._v(" "),t("ol",[t("li",[e._v("Clone the main repository:\n"),t("ul",[t("li",[e._v("Open the command prompt:\n"),t("ul",[t("li",[e._v("Press "),t("code",[e._v("Windows Key + R")]),e._v(".")]),e._v(" "),t("li",[e._v("Type "),t("code",[e._v("cmd")]),e._v(" and press "),t("code",[e._v("Enter")]),e._v(".")])])]),e._v(" "),t("li",[e._v("Navigate to the directory where you want to clone the repository:\n"),t("ul",[t("li",[e._v("Use the "),t("code",[e._v("cd")]),e._v(" command to change directories. For example, to navigate to the "),t("code",[e._v("Documents")]),e._v(" directory:"),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("cd Documents\n")])])]),t("ul",[t("li",[e._v("More detailed instructions on navigating with the "),t("code",[e._v("cd")]),e._v(" command can be found "),t("a",{attrs:{href:"https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/cd",target:"_blank",rel:"noopener noreferrer"}},[e._v("here"),t("OutboundLink")],1)]),e._v(" "),t("li",[t("strong",[e._v("NOTE")]),e._v(": Your database of Arweave Transaction Headers will be created in the project directory, not Docker. So, if you are using an external hard drive to turn an old machine into a node, install the node directly to that external drive.")])])])])]),e._v(" "),t("li",[e._v("Run the following command:"),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("git clone -b main https://github.com/ar-io/ar-io-node\n")])])])])])])]),e._v(" "),t("h2",{attrs:{id:"create-the-environment-file"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#create-the-environment-file"}},[e._v("#")]),e._v(" Create the Environment File")]),e._v(" "),t("ol",[t("li",[t("p",[e._v("Create an environmental variables file:")]),e._v(" "),t("ul",[t("li",[t("p",[e._v("Open a text editor (e.g., Notepad):")]),e._v(" "),t("ul",[t("li",[e._v("Press "),t("code",[e._v("Windows Key")]),e._v(' and search for "Notepad".')]),e._v(" "),t("li",[e._v('Click on "Notepad" to open the text editor.')])])]),e._v(" "),t("li",[t("p",[e._v("Paste the following content into the new file, replacing with the domain address you are using to access the node, and with the public address of your Arweave wallet:")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("GRAPHQL_HOST=arweave.net\nGRAPHQL_PORT=443\nSTART_HEIGHT=0\nRUN_OBSERVER=true\nARNS_ROOT_HOST=\nAR_IO_WALLET=\nOBSERVER_WALLET=\n")])])]),t("ul",[t("li",[e._v("The GRAPHQL values set the proxy for GQL queries to arweave.net, You may use any available gateway that supports GQL queries. If omitted, your node can support GQL queries on locally indexed transactions, but only L1 transactions are indexed by default.")]),e._v(" "),t("li",[t("code",[e._v("START_HEIGHT")]),e._v(" is an optional line. It sets the block number where your node will start downloading and indexing transactions headers. Omitting this line will begin indexing at block 0.")]),e._v(" "),t("li",[t("code",[e._v("RUN_OBSERVER")]),e._v(" turns on the Observer to generate Network Compliance Reports. This is required for full participation in the AR.IO Network. Set to "),t("code",[e._v("false")]),e._v(" to run your gateway without Observer.")]),e._v(" "),t("li",[t("code",[e._v("ARNS_ROOT_HOST")]),e._v(" sets the starting point for resolving ARNS names, which are accessed as a subdomain of a gateway. It should be set to the url you are pointing to your node, excluding any protocol prefix. For example, use "),t("code",[e._v("node-ar.io")]),e._v(" and not "),t("code",[e._v("https://node-ar.io")]),e._v(". If you are using a subdomain to access your node and do not set this value, the node will not understand incoming requests.")]),e._v(" "),t("li",[t("code",[e._v("AR_IO_WALLET")]),e._v(" is optional, and sets the wallet you want associated with your Gateway. An associated wallet is required to join the AR.IO network.")]),e._v(" "),t("li",[t("code",[e._v("OBSERVER_WALLET")]),e._v(" is the public address of the wallet used to sign Observer transactions. This is required for Observer to run, but may be omitted if you are running a gateway outside of the AR.IO network and do not plan to run Observer. You will need to supply the keyfile to this wallet in the next step.")])])])]),e._v(" "),t("p",[e._v("Advanced configuration options can be found at "),t("a",{attrs:{href:"https://docs.ar.io/gateways/ar-io-node/advanced-config.html",target:"_blank",rel:"noopener noreferrer"}},[e._v("docs.ar.io"),t("OutboundLink")],1)]),e._v(" "),t("ul",[t("li",[e._v('Save the file with the name ".env" and make sure to select "All Files" as the file type. This helps to ensure the file saves as ".env" and not ".env.txt"')])]),e._v(" "),t("p",[t("strong",[e._v("Note")]),e._v(": The "),t("code",[e._v(".env")]),e._v(" file should be saved inside the same directory where you cloned the repository (e.g., "),t("code",[e._v("ar-io-node")]),e._v(").")])])]),e._v(" "),t("h2",{attrs:{id:"supply-your-observer-wallet-keyfile"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#supply-your-observer-wallet-keyfile"}},[e._v("#")]),e._v(" Supply Your Observer Wallet Keyfile:")]),e._v(" "),t("p",[e._v("If you are running Observer, you need to provide a wallet keyfile in order to sign report upload transactions. The keyfile must be saved in the "),t("code",[e._v("wallets")]),e._v(" directory in the root of the repository. Name the file "),t("code",[e._v(".json")]),e._v(', replacing "" with the public address of the wallet. This should match your '),t("code",[e._v("OBSERVER_WALLET")]),e._v(" environmental variable.")]),e._v(" "),t("p",[e._v("Learn more about creating Arweave wallets and obtaining keyfiles "),t("a",{attrs:{href:"https://ar.io/wallet/",target:"_blank",rel:"noopener noreferrer"}},[e._v("here"),t("OutboundLink")],1)]),e._v(" "),t("h2",{attrs:{id:"start-the-docker-containers"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#start-the-docker-containers"}},[e._v("#")]),e._v(" Start the Docker Containers")]),e._v(" "),t("ol",[t("li",[e._v("Start the Docker container:\n"),t("ul",[t("li",[t("p",[e._v("Open the command prompt:")]),e._v(" "),t("ul",[t("li",[e._v("Press "),t("code",[e._v("Windows Key + R")]),e._v(".")]),e._v(" "),t("li",[e._v("Type "),t("code",[e._v("cmd")]),e._v(" and press "),t("code",[e._v("Enter")]),e._v(".")])])]),e._v(" "),t("li",[t("p",[e._v("Navigate to the directory where you cloned the repository (e.g., "),t("code",[e._v("ar-io-node")]),e._v("):")]),e._v(" "),t("ul",[t("li",[e._v("Use the "),t("code",[e._v("cd")]),e._v(" command to change directories. For example, if the repository is located in the "),t("code",[e._v("Documents")]),e._v(" directory, you would enter:"),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("cd Documents\\ar-io-node\n")])])])]),e._v(" "),t("li",[e._v("If the directory path contains spaces, enclose it in double quotation marks. For example:"),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v('cd "C:\\My Documents\\ar-io-node"\n')])])])]),e._v(" "),t("li",[e._v("Use the "),t("code",[e._v("dir")]),e._v(" command to list the contents of the current directory and verify that you're in the correct location:"),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("dir\n")])])])])])]),e._v(" "),t("li",[t("p",[e._v("Once you are in the correct directory, run the following command to start the Docker container:")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("docker compose up -d\n")])])]),t("ul",[t("li",[t("p",[e._v("Explanation of flags:")]),e._v(" "),t("ul",[t("li",[t("code",[e._v("up")]),e._v(": Start the Docker containers.")]),e._v(" "),t("li",[t("code",[e._v("-d")]),e._v(": Run the containers as background processes (detached mode).")])]),e._v(" "),t("p",[t("strong",[e._v("NOTE")]),e._v(": Effective with Release #3, it is no longer required to include the "),t("code",[e._v("--build")]),e._v(" flag when starting your gateway. Docker will automatically build using the image specified in the "),t("code",[e._v("docker-commpose.yaml")]),e._v(" file.")]),e._v(" "),t("p",[e._v("The gateway can be shut down using the command:")]),e._v(" "),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("docker compose down\n")])])])])])]),e._v(" "),t("li",[t("p",[e._v("If prompted by the firewall, allow access for Docker when requested.")])])])])]),e._v(" "),t("h2",{attrs:{id:"set-up-router-port-forwarding"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#set-up-router-port-forwarding"}},[e._v("#")]),e._v(" Set Up Router Port Forwarding")]),e._v(" "),t("p",[e._v("To expose your node to the internet and use a custom domain, follow these steps:")]),e._v(" "),t("ol",[t("li",[t("p",[e._v("Obtain a Domain Name:")]),e._v(" "),t("ul",[t("li",[e._v("Choose a domain registrar (e.g., "),t("a",{attrs:{href:"https://www.namecheap.com",target:"_blank",rel:"noopener noreferrer"}},[e._v("Namecheap"),t("OutboundLink")],1),e._v(") and purchase a domain name.")])])]),e._v(" "),t("li",[t("p",[e._v("Point the Domain at Your Home Network:")]),e._v(" "),t("ul",[t("li",[e._v("In your browser, go to https://www.whatsmyip.org/ to display your public ip address. It can be found at the top of the screen. Note this number down.")]),e._v(" "),t("li",[e._v("Access your domain registrar's settings (e.g., Namecheap's cPanel).")]),e._v(" "),t("li",[e._v('Navigate to the DNS settings for your domain. In cPanel this is under the "Zone Editor" tab.')]),e._v(" "),t("li",[e._v('Create an A record with your registrar for your domain and wildcard subdomains, using your public IP address. For example, if your domain is "ar.io," create a record for "ar.io" and "*.ar.io."\n'),t("ul",[t("li",[e._v("Instructions may vary depending on the domain registrar and cPanel. Consult your registrar's documentation or support for detailed steps.")])])])])]),e._v(" "),t("li",[t("p",[e._v("Obtain the Local IP Address of Your Machine:")]),e._v(" "),t("ul",[t("li",[e._v("Open the command prompt:\n"),t("ul",[t("li",[e._v("Press "),t("code",[e._v("Windows Key + R")]),e._v(".")]),e._v(" "),t("li",[e._v("Type "),t("code",[e._v("cmd")]),e._v(" and press "),t("code",[e._v("Enter")]),e._v(".")])])]),e._v(" "),t("li",[e._v("Run the following command:"),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("ipconfig\n")])])])]),e._v(" "),t("li",[e._v("Look for the network adapter that is currently connected to your network (e.g., Ethernet or Wi-Fi).")]),e._v(" "),t("li",[e._v("Note down the IPv4 Address associated with the network adapter. It should be in the format of "),t("code",[e._v("192.168.X.X")]),e._v(" or "),t("code",[e._v("10.X.X.X")]),e._v(".")]),e._v(" "),t("li",[e._v("This IP address will be used for port forwarding.")])])]),e._v(" "),t("li",[t("p",[e._v("Set Up Router Port Forwarding:")]),e._v(" "),t("ul",[t("li",[e._v("Access your home router settings:\n"),t("ul",[t("li",[e._v("Open a web browser.")]),e._v(" "),t("li",[e._v("Enter your router's IP address in the address bar (e.g., "),t("code",[e._v("192.168.0.1")]),e._v(").")]),e._v(" "),t("li",[e._v("If you're unsure of your router's IP address, consult your router's documentation or contact your Internet Service Provider (ISP).")])])]),e._v(" "),t("li",[e._v("Navigate to the port forwarding settings in your router configuration.\n"),t("ul",[t("li",[e._v("The exact steps may vary depending on your router model. Consult your router's documentation or support for detailed steps.")])])]),e._v(" "),t("li",[e._v("Set up port forwarding rules to forward incoming traffic on ports 80 and 443 to the local IP address of your machine where the node is installed.\n"),t("ul",[t("li",[e._v("Configure the ports to point to the local IP address noted in the previous step.")]),e._v(" "),t("li",[e._v("Save the settings.")])])])])])]),e._v(" "),t("h2",{attrs:{id:"install-and-configure-nginx-docker"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#install-and-configure-nginx-docker"}},[e._v("#")]),e._v(" Install and Configure NGINX Docker")]),e._v(" "),t("ol",[t("li",[t("p",[e._v("Clone the NGINX Docker repository:")]),e._v(" "),t("ul",[t("li",[e._v("Open the command prompt:\n"),t("ul",[t("li",[e._v("Press "),t("code",[e._v("Windows Key + R")]),e._v(".")]),e._v(" "),t("li",[e._v("Type "),t("code",[e._v("cmd")]),e._v(" and press "),t("code",[e._v("Enter")]),e._v(".")])])]),e._v(" "),t("li",[e._v("Navigate to the directory where you want to clone the repository (This should not be done inside the directory for the node):\n"),t("ul",[t("li",[e._v("Use the "),t("code",[e._v("cd")]),e._v(" command to change directories. For example, to navigate to the "),t("code",[e._v("Documents")]),e._v(" directory:"),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("cd Documents\n")])])])])])]),e._v(" "),t("li",[e._v("Run the following command:"),t("div",{staticClass:"language- extra-class"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[e._v("git clone -b main https://github.com/bobinstein/dockerized-nginx\n")])])])])]),e._v(" "),t("p",[t("strong",[e._v("Note")]),e._v(": This NGINX container was designed to easily automate many of the more technical aspects of setting up NGNIX and obtaining an ssl certificate so your node can be accessed with https. However, wildcard domain certifications cannot be universally automated due to significant security concerns. Be sure to follow the instructions in this project for obtaining wildcard domain certificates in order for your node to function properly.")])]),e._v(" "),t("li",[t("p",[e._v("Follow the instructions provided in the repository for setting up NGINX Docker.")])])]),e._v(" "),t("p",[e._v("Congratulations! Your AR.IO node is now running and connected to the internet. Test it by entering https:///3lyxgbgEvqNSvJrTX2J7CfRychUD5KClFhhVLyTPNCQ in your browser.")]),e._v(" "),t("p",[t("strong",[e._v("Note")]),e._v(": If you encounter any issues during the installation process, please seek assistance from the "),t("a",{attrs:{href:"https://discord.gg/7zUPfN4D6g",target:"_blank",rel:"noopener noreferrer"}},[e._v("AR.IO community"),t("OutboundLink")],1),e._v(".")])])}),[],!1,null,null,null);t.default=a.exports}}]); \ No newline at end of file diff --git a/assets/js/57.9139a96b.js b/assets/js/57.2f9ce2dd.js similarity index 99% rename from assets/js/57.9139a96b.js rename to assets/js/57.2f9ce2dd.js index 1cec0487..06157fa2 100644 --- a/assets/js/57.9139a96b.js +++ b/assets/js/57.2f9ce2dd.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[57],{355:function(e,a,t){"use strict";t.r(a);var r=t(10),s=Object(r.a)({},(function(){var e=this,a=e._self._c;return a("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[a("h1",{attrs:{id:"glossary"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#glossary"}},[e._v("#")]),e._v(" Glossary")]),e._v(" "),a("p",[e._v("Many novel terms and acronyms are used by the Arweave ecosystem as well as some new ones introduced by AR.IO. The list below is intended to serve as a non-exhaustive reference of those terms:")]),e._v(" "),a("h2",{attrs:{id:"aocomputer-ao"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#aocomputer-ao"}},[e._v("#")]),e._v(" "),a("strong",[e._v("aoComputer (AO)")]),e._v(":")]),e._v(" "),a("p",[e._v("The aoComputer is the actor oriented machine that emerges from the network of nodes that adhere to its core data protocol, running on the Arweave network. It is a single, unified computing environment, hosted on a heterogenous set of nodes in a distributed network. AO is designed to offer an environment in which an arbitrary number of parallel processes can be resident, coordinating through an open message passing layer. This message passing standard connects the machine's independently operating processes together into a 'web' -- in the same way that websites operate on independent servers but are conjoined into a cohesive, unified experience via hyperlinks.")]),e._v(" "),a("h2",{attrs:{id:"arweave-name-system-arns"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#arweave-name-system-arns"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Arweave Name System (ArNS)")]),e._v(":")]),e._v(" "),a("p",[e._v("A decentralized and censorship-resistant naming system enabled by AR.IO gateways which connects friendly names to permaweb applications, pages, and data.")]),e._v(" "),a("h2",{attrs:{id:"arweave-name-token-ant-name-token"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#arweave-name-token-ant-name-token"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Arweave Name Token (ANT), “Name Token”")]),e._v(":")]),e._v(" "),a("p",[e._v("An aoComputer based token, that is connected to each registered ArNS Name. Each ANT gives the owner the ability to update the subdomains and Arweave transaction IDs used by the registered name as well as transfer ownership and other functions.")]),e._v(" "),a("h2",{attrs:{id:"arweave-network-standards-ans"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#arweave-network-standards-ans"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Arweave Network Standards (ANS)")]),e._v(":")]),e._v(" "),a("p",[e._v("Drafts and finalized standards for data formats, tag formats, data protocols, custom gateway features and anything that is built on top the Arweave Network. Specific standards are denoted by an associated number, e.g., ANS-###.")]),e._v(" "),a("h2",{attrs:{id:"base-layer-transaction"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#base-layer-transaction"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Base Layer Transaction")]),e._v(":")]),e._v(" "),a("p",[e._v("Refers to one of up to 1,000 transactions that make up a single Arweave block. A base layer transaction may contain bundled data items.")]),e._v(" "),a("h2",{attrs:{id:"bundle-bundling"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#bundle-bundling"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Bundle, bundling")]),e._v(":")]),e._v(" "),a("p",[e._v("An Arweave concept introduced in ANS-104 that allows for a way of writing multiple independent data transactions into one base layer transaction. Bundled transactions contain multiple independent transactions, called data items, wrapped into one larger transaction. This offers two major network benefits:")]),e._v(" "),a("ul",[a("li",[a("p",[e._v("A scaling solution for increasing the throughput of uploads to the Arweave network,")])]),e._v(" "),a("li",[a("p",[e._v("Allows delegation of payment for an upload to a third party, while maintaining the identity and signature of the person who created the upload, without them needing to have a wallet with funds.")])])]),e._v(" "),a("h2",{attrs:{id:"bundled-data-item-bdi"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#bundled-data-item-bdi"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Bundled Data Item (BDI)")]),e._v(":")]),e._v(" "),a("p",[e._v("A data item / transaction nested within an ANS-104 bundled transaction.")]),e._v(" "),a("h2",{attrs:{id:"bundler"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#bundler"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Bundler")]),e._v(":")]),e._v(" "),a("p",[e._v("A third-party service and gateway feature that bundles data files on a user’s behalf.")]),e._v(" "),a("h2",{attrs:{id:"chunk"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#chunk"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Chunk")]),e._v(":")]),e._v(" "),a("p",[e._v("A chunk is a unit of data that is stored on the Arweave network. It represents a piece of a larger file that has been split into smaller, manageable segments for efficient storage and retrieval.")]),e._v(" "),a("h2",{attrs:{id:"decentralized-decentralization-etc"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#decentralized-decentralization-etc"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Decentralized, decentralization, etc")]),e._v(":")]),e._v(" "),a("p",[e._v("A nonbinary, many axis scale enabling a system or platform to be: permissionless, trustless, verifiable, transparent, open-source, composable, resilient, and censorship resistant. Ultimately, something that is decentralized is not prone to single points of failure or influence.")]),e._v(" "),a("h2",{attrs:{id:"epoch"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#epoch"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Epoch")]),e._v(":")]),e._v(" "),a("p",[e._v("A specific duration (e.g., one block-week) during which network activities and evaluations are conducted. It serves as a key time frame for processes such as observation duties, performance assessments, and reward distributions within the network's protocols.")]),e._v(" "),a("h2",{attrs:{id:"gateway"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#gateway"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Gateway")]),e._v(":")]),e._v(" "),a("p",[e._v("A node operating on the Arweave network that provides services for reading from, writing to, and indexing the data stored on the permaweb. Sometimes referred to as “permaweb nodes”.")]),e._v(" "),a("h2",{attrs:{id:"gateway-address-registry-gar"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#gateway-address-registry-gar"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Gateway Address Registry (GAR)")]),e._v(":")]),e._v(" "),a("p",[e._v("A decentralized directory maintained in the AR.IO smart contract. It serves as the authoritative list of all registered gateways on the AR.IO Network. The registry provides detailed metadata about each gateway to facilitate discovery, health monitoring, and data sharing among permaweb apps and users. The GAR is designed to be easily queryable, sortable, and filterable by end users and clients, allowing for tailored selections based on various criteria to meet specific use cases.")]),e._v(" "),a("h2",{attrs:{id:"indexing"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#indexing"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Indexing")]),e._v(":")]),e._v(" "),a("p",[e._v("The act of organizing transaction data tags into queryable databases.")]),e._v(" "),a("h2",{attrs:{id:"layer-2-infrastructure"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#layer-2-infrastructure"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Layer 2 Infrastructure")]),e._v(":")]),e._v(" "),a("p",[e._v("Layer 2 refers to the technology / infrastructure stack built “above” a base layer. In this use, the AR.IO Network would be considered Layer 2 infrastructure to the base Arweave protocol.")]),e._v(" "),a("h2",{attrs:{id:"manifest-aka-path-manifest-arweave-manifest"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#manifest-aka-path-manifest-arweave-manifest"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Manifest (aka Path Manifest, Arweave Manifest)")]),e._v(":")]),e._v(" "),a("p",[e._v("Special “aggregate” files uploaded to Arweave that map user-definable sub-paths with other Arweave transaction IDs. This allows users to create logical groups of content, for example a directory of related files, or the files and assets that make up a web page or application. Instead of having to manually collate these assets, manifests group them together so that an entire website or app can be launched from a single manifest file. Gateways can interpret this structure, so that users can then reference individual transactions by their file name and/or path.")]),e._v(" "),a("h2",{attrs:{id:"mempool"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#mempool"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Mempool")]),e._v(":")]),e._v(" "),a("p",[e._v('Short for "memory pool," is a component of Arweave mining nodes that temporarily stores valid transactions that have been broadcasted to the network but have not yet been added to a block.')]),e._v(" "),a("h2",{attrs:{id:"miner-aka-arweave-node"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#miner-aka-arweave-node"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Miner (aka Arweave Node)")]),e._v(":")]),e._v(" "),a("p",[e._v("A node operating on the Arweave network responsible for data storage and recall.")]),e._v(" "),a("h2",{attrs:{id:"native-address"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#native-address"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Native Address")]),e._v(":")]),e._v(" "),a("p",[e._v("The way public addresses are commonly (or by spec) represented in their native blockchain. Arweave keys are 43 character base64url representations of the "),a("a",{attrs:{href:"#public-key"}},[e._v("public key")]),e._v(", while Ethereum keys use a different hashing algorithm and start with "),a("code",[e._v("0x")]),e._v(" etc.")]),e._v(" "),a("h2",{attrs:{id:"normalized-address"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#normalized-address"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Normalized Address")]),e._v(":")]),e._v(" "),a("p",[e._v("43 character base64url representation of the sha256 hash of a "),a("a",{attrs:{href:"#public-key"}},[e._v("public key")]),e._v(". Public keys for other chains can be normalized by this representation.")]),e._v(" "),a("h2",{attrs:{id:"observer"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#observer"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Observer")]),e._v(":")]),e._v(" "),a("p",[e._v("A gateway selected to evaluate the performance of peer gateways in resolving ArNS names. Observers assess and report on the operational efficacy of other gateways.")]),e._v(" "),a("h2",{attrs:{id:"optimistic-indexing"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#optimistic-indexing"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Optimistic Indexing")]),e._v(":")]),e._v(" "),a("p",[e._v("Indexing transaction or data item headers before the associated L1 transaction has been accepted and confirmed in a chain block.")]),e._v(" "),a("h2",{attrs:{id:"owner"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#owner"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Owner")]),e._v(":")]),e._v(" "),a("p",[e._v("Generally, the public key of the signer.")]),e._v(" "),a("h2",{attrs:{id:"owner-address"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#owner-address"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Owner Address")]),e._v(":")]),e._v(" "),a("p",[e._v("The "),a("a",{attrs:{href:"#normalized-address"}},[e._v("normalized address")]),e._v(" of the "),a("a",{attrs:{href:"#owner"}},[e._v("owner")])]),e._v(" "),a("h2",{attrs:{id:"period"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#period"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Period")]),e._v(":")]),e._v(" "),a("p",[e._v("Refers to a predefined time span (e.g., a block-day) that serves as a cycle for network activities such as dynamic pricing. It is a fundamental unit of time for operational and protocol processes within the network.")]),e._v(" "),a("h2",{attrs:{id:"permaweb"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#permaweb"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Permaweb")]),e._v(":")]),e._v(" "),a("p",[e._v("The permaweb is the permanent and decentralized web of files and applications built on top of Arweave.")]),e._v(" "),a("h2",{attrs:{id:"protocol-balance"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#protocol-balance"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Protocol Balance")]),e._v(":")]),e._v(" "),a("p",[e._v("The primary sink and source of IO tokens circulating through the AR.IO Network. This balance is akin to a central vault or wallet programmatically encoded into the network’s smart contract from which ArNS revenue is accumulated and incentive rewards are distributed.")]),e._v(" "),a("h2",{attrs:{id:"protocol-rewards"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#protocol-rewards"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Protocol Rewards")]),e._v(":")]),e._v(" "),a("p",[e._v("IO Token incentive rewards distributed by the protocol to the network’s eligible users and gateway operators.")]),e._v(" "),a("h2",{attrs:{id:"public-key"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#public-key"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Public Key")]),e._v(":")]),e._v(" "),a("p",[e._v("The publicly known keys for a signer (wallet). Public keys are different byte lengths depending on the signer type (e.g. Arweave vs. Ethereum (ECDSA), vs Solana, etc.)")]),e._v(" "),a("h2",{attrs:{id:"seeding"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#seeding"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Seeding")]),e._v(":")]),e._v(" "),a("p",[e._v("Refers to the act of propagating new data throughout the network. Miner nodes seed Arweave base layer transaction data to other miners, while gateways ensure that the transactions they receive reach the Arweave nodes. Both gateways and Arweave nodes seed base layer transactions and data chunks.")]),e._v(" "),a("h2",{attrs:{id:"staking-of-tokens"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#staking-of-tokens"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Staking (of tokens)")]),e._v(":")]),e._v(" "),a("p",[e._v("Refers to the process of locking IO tokens into a protocol-facilitated vault, temporarily removing them from circulation until unlocked. This action represents an opportunity cost for the gateway operator and serves as a motivator to prioritize the network's collective interests.")]),e._v(" "),a("h2",{attrs:{id:"transaction-id-txid"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#transaction-id-txid"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Transaction ID (txID)")]),e._v(":")]),e._v(" "),a("p",[e._v("Every transaction and data file uploaded to Arweave is assigned a unique identifier code known as the Transaction ID. These txID’s can be referenced by users to easily locate and retrieve files.")]),e._v(" "),a("h2",{attrs:{id:"trust-minimization"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#trust-minimization"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Trust-minimization")]),e._v(":")]),e._v(" "),a("p",[e._v("Relates to enacting network security by minimizing the number of entities and the degree to which they must be trusted to achieve reliable network interactions. A network with trust-minimizing mechanisms means that it has reduced exposure to undesirable third-party actions and built-in incentives to reward good behavior while punishing bad behavior.")]),e._v(" "),a("h2",{attrs:{id:"vault"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#vault"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Vault")]),e._v(":")]),e._v(" "),a("p",[e._v("Token vaults are protocol level mechanisms used to contain staked tokens over time. Each vault contains a starting block height, ending block height (if applicable), along with a balance of tokens.")])])}),[],!1,null,null,null);a.default=s.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[57],{358:function(e,a,t){"use strict";t.r(a);var r=t(10),s=Object(r.a)({},(function(){var e=this,a=e._self._c;return a("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[a("h1",{attrs:{id:"glossary"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#glossary"}},[e._v("#")]),e._v(" Glossary")]),e._v(" "),a("p",[e._v("Many novel terms and acronyms are used by the Arweave ecosystem as well as some new ones introduced by AR.IO. The list below is intended to serve as a non-exhaustive reference of those terms:")]),e._v(" "),a("h2",{attrs:{id:"aocomputer-ao"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#aocomputer-ao"}},[e._v("#")]),e._v(" "),a("strong",[e._v("aoComputer (AO)")]),e._v(":")]),e._v(" "),a("p",[e._v("The aoComputer is the actor oriented machine that emerges from the network of nodes that adhere to its core data protocol, running on the Arweave network. It is a single, unified computing environment, hosted on a heterogenous set of nodes in a distributed network. AO is designed to offer an environment in which an arbitrary number of parallel processes can be resident, coordinating through an open message passing layer. This message passing standard connects the machine's independently operating processes together into a 'web' -- in the same way that websites operate on independent servers but are conjoined into a cohesive, unified experience via hyperlinks.")]),e._v(" "),a("h2",{attrs:{id:"arweave-name-system-arns"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#arweave-name-system-arns"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Arweave Name System (ArNS)")]),e._v(":")]),e._v(" "),a("p",[e._v("A decentralized and censorship-resistant naming system enabled by AR.IO gateways which connects friendly names to permaweb applications, pages, and data.")]),e._v(" "),a("h2",{attrs:{id:"arweave-name-token-ant-name-token"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#arweave-name-token-ant-name-token"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Arweave Name Token (ANT), “Name Token”")]),e._v(":")]),e._v(" "),a("p",[e._v("An aoComputer based token, that is connected to each registered ArNS Name. Each ANT gives the owner the ability to update the subdomains and Arweave transaction IDs used by the registered name as well as transfer ownership and other functions.")]),e._v(" "),a("h2",{attrs:{id:"arweave-network-standards-ans"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#arweave-network-standards-ans"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Arweave Network Standards (ANS)")]),e._v(":")]),e._v(" "),a("p",[e._v("Drafts and finalized standards for data formats, tag formats, data protocols, custom gateway features and anything that is built on top the Arweave Network. Specific standards are denoted by an associated number, e.g., ANS-###.")]),e._v(" "),a("h2",{attrs:{id:"base-layer-transaction"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#base-layer-transaction"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Base Layer Transaction")]),e._v(":")]),e._v(" "),a("p",[e._v("Refers to one of up to 1,000 transactions that make up a single Arweave block. A base layer transaction may contain bundled data items.")]),e._v(" "),a("h2",{attrs:{id:"bundle-bundling"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#bundle-bundling"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Bundle, bundling")]),e._v(":")]),e._v(" "),a("p",[e._v("An Arweave concept introduced in ANS-104 that allows for a way of writing multiple independent data transactions into one base layer transaction. Bundled transactions contain multiple independent transactions, called data items, wrapped into one larger transaction. This offers two major network benefits:")]),e._v(" "),a("ul",[a("li",[a("p",[e._v("A scaling solution for increasing the throughput of uploads to the Arweave network,")])]),e._v(" "),a("li",[a("p",[e._v("Allows delegation of payment for an upload to a third party, while maintaining the identity and signature of the person who created the upload, without them needing to have a wallet with funds.")])])]),e._v(" "),a("h2",{attrs:{id:"bundled-data-item-bdi"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#bundled-data-item-bdi"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Bundled Data Item (BDI)")]),e._v(":")]),e._v(" "),a("p",[e._v("A data item / transaction nested within an ANS-104 bundled transaction.")]),e._v(" "),a("h2",{attrs:{id:"bundler"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#bundler"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Bundler")]),e._v(":")]),e._v(" "),a("p",[e._v("A third-party service and gateway feature that bundles data files on a user’s behalf.")]),e._v(" "),a("h2",{attrs:{id:"chunk"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#chunk"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Chunk")]),e._v(":")]),e._v(" "),a("p",[e._v("A chunk is a unit of data that is stored on the Arweave network. It represents a piece of a larger file that has been split into smaller, manageable segments for efficient storage and retrieval.")]),e._v(" "),a("h2",{attrs:{id:"decentralized-decentralization-etc"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#decentralized-decentralization-etc"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Decentralized, decentralization, etc")]),e._v(":")]),e._v(" "),a("p",[e._v("A nonbinary, many axis scale enabling a system or platform to be: permissionless, trustless, verifiable, transparent, open-source, composable, resilient, and censorship resistant. Ultimately, something that is decentralized is not prone to single points of failure or influence.")]),e._v(" "),a("h2",{attrs:{id:"epoch"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#epoch"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Epoch")]),e._v(":")]),e._v(" "),a("p",[e._v("A specific duration (e.g., one block-week) during which network activities and evaluations are conducted. It serves as a key time frame for processes such as observation duties, performance assessments, and reward distributions within the network's protocols.")]),e._v(" "),a("h2",{attrs:{id:"gateway"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#gateway"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Gateway")]),e._v(":")]),e._v(" "),a("p",[e._v("A node operating on the Arweave network that provides services for reading from, writing to, and indexing the data stored on the permaweb. Sometimes referred to as “permaweb nodes”.")]),e._v(" "),a("h2",{attrs:{id:"gateway-address-registry-gar"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#gateway-address-registry-gar"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Gateway Address Registry (GAR)")]),e._v(":")]),e._v(" "),a("p",[e._v("A decentralized directory maintained in the AR.IO smart contract. It serves as the authoritative list of all registered gateways on the AR.IO Network. The registry provides detailed metadata about each gateway to facilitate discovery, health monitoring, and data sharing among permaweb apps and users. The GAR is designed to be easily queryable, sortable, and filterable by end users and clients, allowing for tailored selections based on various criteria to meet specific use cases.")]),e._v(" "),a("h2",{attrs:{id:"indexing"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#indexing"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Indexing")]),e._v(":")]),e._v(" "),a("p",[e._v("The act of organizing transaction data tags into queryable databases.")]),e._v(" "),a("h2",{attrs:{id:"layer-2-infrastructure"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#layer-2-infrastructure"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Layer 2 Infrastructure")]),e._v(":")]),e._v(" "),a("p",[e._v("Layer 2 refers to the technology / infrastructure stack built “above” a base layer. In this use, the AR.IO Network would be considered Layer 2 infrastructure to the base Arweave protocol.")]),e._v(" "),a("h2",{attrs:{id:"manifest-aka-path-manifest-arweave-manifest"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#manifest-aka-path-manifest-arweave-manifest"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Manifest (aka Path Manifest, Arweave Manifest)")]),e._v(":")]),e._v(" "),a("p",[e._v("Special “aggregate” files uploaded to Arweave that map user-definable sub-paths with other Arweave transaction IDs. This allows users to create logical groups of content, for example a directory of related files, or the files and assets that make up a web page or application. Instead of having to manually collate these assets, manifests group them together so that an entire website or app can be launched from a single manifest file. Gateways can interpret this structure, so that users can then reference individual transactions by their file name and/or path.")]),e._v(" "),a("h2",{attrs:{id:"mempool"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#mempool"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Mempool")]),e._v(":")]),e._v(" "),a("p",[e._v('Short for "memory pool," is a component of Arweave mining nodes that temporarily stores valid transactions that have been broadcasted to the network but have not yet been added to a block.')]),e._v(" "),a("h2",{attrs:{id:"miner-aka-arweave-node"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#miner-aka-arweave-node"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Miner (aka Arweave Node)")]),e._v(":")]),e._v(" "),a("p",[e._v("A node operating on the Arweave network responsible for data storage and recall.")]),e._v(" "),a("h2",{attrs:{id:"native-address"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#native-address"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Native Address")]),e._v(":")]),e._v(" "),a("p",[e._v("The way public addresses are commonly (or by spec) represented in their native blockchain. Arweave keys are 43 character base64url representations of the "),a("a",{attrs:{href:"#public-key"}},[e._v("public key")]),e._v(", while Ethereum keys use a different hashing algorithm and start with "),a("code",[e._v("0x")]),e._v(" etc.")]),e._v(" "),a("h2",{attrs:{id:"normalized-address"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#normalized-address"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Normalized Address")]),e._v(":")]),e._v(" "),a("p",[e._v("43 character base64url representation of the sha256 hash of a "),a("a",{attrs:{href:"#public-key"}},[e._v("public key")]),e._v(". Public keys for other chains can be normalized by this representation.")]),e._v(" "),a("h2",{attrs:{id:"observer"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#observer"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Observer")]),e._v(":")]),e._v(" "),a("p",[e._v("A gateway selected to evaluate the performance of peer gateways in resolving ArNS names. Observers assess and report on the operational efficacy of other gateways.")]),e._v(" "),a("h2",{attrs:{id:"optimistic-indexing"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#optimistic-indexing"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Optimistic Indexing")]),e._v(":")]),e._v(" "),a("p",[e._v("Indexing transaction or data item headers before the associated L1 transaction has been accepted and confirmed in a chain block.")]),e._v(" "),a("h2",{attrs:{id:"owner"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#owner"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Owner")]),e._v(":")]),e._v(" "),a("p",[e._v("Generally, the public key of the signer.")]),e._v(" "),a("h2",{attrs:{id:"owner-address"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#owner-address"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Owner Address")]),e._v(":")]),e._v(" "),a("p",[e._v("The "),a("a",{attrs:{href:"#normalized-address"}},[e._v("normalized address")]),e._v(" of the "),a("a",{attrs:{href:"#owner"}},[e._v("owner")])]),e._v(" "),a("h2",{attrs:{id:"period"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#period"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Period")]),e._v(":")]),e._v(" "),a("p",[e._v("Refers to a predefined time span (e.g., a block-day) that serves as a cycle for network activities such as dynamic pricing. It is a fundamental unit of time for operational and protocol processes within the network.")]),e._v(" "),a("h2",{attrs:{id:"permaweb"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#permaweb"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Permaweb")]),e._v(":")]),e._v(" "),a("p",[e._v("The permaweb is the permanent and decentralized web of files and applications built on top of Arweave.")]),e._v(" "),a("h2",{attrs:{id:"protocol-balance"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#protocol-balance"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Protocol Balance")]),e._v(":")]),e._v(" "),a("p",[e._v("The primary sink and source of IO tokens circulating through the AR.IO Network. This balance is akin to a central vault or wallet programmatically encoded into the network’s smart contract from which ArNS revenue is accumulated and incentive rewards are distributed.")]),e._v(" "),a("h2",{attrs:{id:"protocol-rewards"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#protocol-rewards"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Protocol Rewards")]),e._v(":")]),e._v(" "),a("p",[e._v("IO Token incentive rewards distributed by the protocol to the network’s eligible users and gateway operators.")]),e._v(" "),a("h2",{attrs:{id:"public-key"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#public-key"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Public Key")]),e._v(":")]),e._v(" "),a("p",[e._v("The publicly known keys for a signer (wallet). Public keys are different byte lengths depending on the signer type (e.g. Arweave vs. Ethereum (ECDSA), vs Solana, etc.)")]),e._v(" "),a("h2",{attrs:{id:"seeding"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#seeding"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Seeding")]),e._v(":")]),e._v(" "),a("p",[e._v("Refers to the act of propagating new data throughout the network. Miner nodes seed Arweave base layer transaction data to other miners, while gateways ensure that the transactions they receive reach the Arweave nodes. Both gateways and Arweave nodes seed base layer transactions and data chunks.")]),e._v(" "),a("h2",{attrs:{id:"staking-of-tokens"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#staking-of-tokens"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Staking (of tokens)")]),e._v(":")]),e._v(" "),a("p",[e._v("Refers to the process of locking IO tokens into a protocol-facilitated vault, temporarily removing them from circulation until unlocked. This action represents an opportunity cost for the gateway operator and serves as a motivator to prioritize the network's collective interests.")]),e._v(" "),a("h2",{attrs:{id:"transaction-id-txid"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#transaction-id-txid"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Transaction ID (txID)")]),e._v(":")]),e._v(" "),a("p",[e._v("Every transaction and data file uploaded to Arweave is assigned a unique identifier code known as the Transaction ID. These txID’s can be referenced by users to easily locate and retrieve files.")]),e._v(" "),a("h2",{attrs:{id:"trust-minimization"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#trust-minimization"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Trust-minimization")]),e._v(":")]),e._v(" "),a("p",[e._v("Relates to enacting network security by minimizing the number of entities and the degree to which they must be trusted to achieve reliable network interactions. A network with trust-minimizing mechanisms means that it has reduced exposure to undesirable third-party actions and built-in incentives to reward good behavior while punishing bad behavior.")]),e._v(" "),a("h2",{attrs:{id:"vault"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#vault"}},[e._v("#")]),e._v(" "),a("strong",[e._v("Vault")]),e._v(":")]),e._v(" "),a("p",[e._v("Token vaults are protocol level mechanisms used to contain staked tokens over time. Each vault contains a starting block height, ending block height (if applicable), along with a balance of tokens.")])])}),[],!1,null,null,null);a.default=s.exports}}]); \ No newline at end of file diff --git a/assets/js/58.7e51b8d0.js b/assets/js/58.9e08bbb7.js similarity index 97% rename from assets/js/58.7e51b8d0.js rename to assets/js/58.9e08bbb7.js index db0a54f1..c50a7a97 100644 --- a/assets/js/58.7e51b8d0.js +++ b/assets/js/58.9e08bbb7.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[58],{358:function(a,e,s){"use strict";s.r(e);var t=s(10),n=Object(t.a)({},(function(){var a=this,e=a._self._c;return e("ContentSlotsDistributor",{attrs:{"slot-key":a.$parent.slotKey}},[e("h1",{attrs:{id:"managing-arns-assets"}},[e("a",{staticClass:"header-anchor",attrs:{href:"#managing-arns-assets"}},[a._v("#")]),a._v(" Managing ArNS Assets")]),a._v(" "),e("h2",{attrs:{id:"overview"}},[e("a",{staticClass:"header-anchor",attrs:{href:"#overview"}},[a._v("#")]),a._v(" Overview")]),a._v(" "),e("p",[a._v("From the Manage Assets page of arns.app, you can view details about your registered names, assign new Target IDs for your names to resolve to, or register new "),e("RouterLink",{attrs:{to:"/arns.html#under_names"}},[a._v("undernames")]),a._v(" for your ArNS names.")],1),a._v(" "),e("p",[a._v('Access the Manage Assets page by connecting your Arweave wallet, and clicking on the account button displaying your wallet address (the connect button if you are not connected), then selecting "Manage Assets" from the menu.')]),a._v(" "),e("video",{staticClass:"amazingdiagram",attrs:{controls:""}},[e("source",{attrs:{src:a.$withBase("/videos/manage-assets.mp4"),type:"video/mp4"}}),a._v("\n Your browser does not support the video tag.\n")]),a._v(" "),e("p",[a._v("The Manage Assets page features two important tabs. "),e("code",[a._v("Names")]),a._v(" and "),e("code",[a._v("ANTS")]),a._v(".")]),a._v(" "),e("h2",{attrs:{id:"names"}},[e("a",{staticClass:"header-anchor",attrs:{href:"#names"}},[a._v("#")]),a._v(" Names")]),a._v(" "),e("p",[a._v("The "),e("code",[a._v("Names")]),a._v(' tab displays all of the ArNS names registered to the currently connected wallet. Each name has its own "details" button which allows you to view details about the name, extend the lease period, or increase the available undernames for that name.')]),a._v(" "),e("img",{staticClass:"amazingdiagram",attrs:{src:a.$withBase("/images/arns-assets-names.jpeg")}}),a._v(" "),e("h2",{attrs:{id:"ants"}},[e("a",{staticClass:"header-anchor",attrs:{href:"#ants"}},[a._v("#")]),a._v(" ANTs")]),a._v(" "),e("p",[a._v("The "),e("code",[a._v("ANTs")]),a._v(' tab displays each ANT owned by the connected wallet (except for advanced use cases, each ArNS name will have its own ANT). You can view and create new undernames using the "Undernames" button, or access advanced management options by clicking on the "manage" icon (shaped like a gear).')]),a._v(" "),e("img",{staticClass:"amazingdiagram",attrs:{src:a.$withBase("/images/arns-assets-ants.jpeg")}}),a._v(" "),e("p",[a._v("The Advanced manage page allows you to transfer ownership, add or remove controllers (other wallets who are able to manage an ANT) or set/modify a Target ID for a name to resolve to.")]),a._v(" "),e("img",{staticClass:"amazingdiagram",attrs:{src:a.$withBase("/images/arns-manage-ant.jpeg")}})])}),[],!1,null,null,null);e.default=n.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[58],{356:function(a,e,s){"use strict";s.r(e);var t=s(10),n=Object(t.a)({},(function(){var a=this,e=a._self._c;return e("ContentSlotsDistributor",{attrs:{"slot-key":a.$parent.slotKey}},[e("h1",{attrs:{id:"managing-arns-assets"}},[e("a",{staticClass:"header-anchor",attrs:{href:"#managing-arns-assets"}},[a._v("#")]),a._v(" Managing ArNS Assets")]),a._v(" "),e("h2",{attrs:{id:"overview"}},[e("a",{staticClass:"header-anchor",attrs:{href:"#overview"}},[a._v("#")]),a._v(" Overview")]),a._v(" "),e("p",[a._v("From the Manage Assets page of arns.app, you can view details about your registered names, assign new Target IDs for your names to resolve to, or register new "),e("RouterLink",{attrs:{to:"/arns.html#under_names"}},[a._v("undernames")]),a._v(" for your ArNS names.")],1),a._v(" "),e("p",[a._v('Access the Manage Assets page by connecting your Arweave wallet, and clicking on the account button displaying your wallet address (the connect button if you are not connected), then selecting "Manage Assets" from the menu.')]),a._v(" "),e("video",{staticClass:"amazingdiagram",attrs:{controls:""}},[e("source",{attrs:{src:a.$withBase("/videos/manage-assets.mp4"),type:"video/mp4"}}),a._v("\n Your browser does not support the video tag.\n")]),a._v(" "),e("p",[a._v("The Manage Assets page features two important tabs. "),e("code",[a._v("Names")]),a._v(" and "),e("code",[a._v("ANTS")]),a._v(".")]),a._v(" "),e("h2",{attrs:{id:"names"}},[e("a",{staticClass:"header-anchor",attrs:{href:"#names"}},[a._v("#")]),a._v(" Names")]),a._v(" "),e("p",[a._v("The "),e("code",[a._v("Names")]),a._v(' tab displays all of the ArNS names registered to the currently connected wallet. Each name has its own "details" button which allows you to view details about the name, extend the lease period, or increase the available undernames for that name.')]),a._v(" "),e("img",{staticClass:"amazingdiagram",attrs:{src:a.$withBase("/images/arns-assets-names.jpeg")}}),a._v(" "),e("h2",{attrs:{id:"ants"}},[e("a",{staticClass:"header-anchor",attrs:{href:"#ants"}},[a._v("#")]),a._v(" ANTs")]),a._v(" "),e("p",[a._v("The "),e("code",[a._v("ANTs")]),a._v(' tab displays each ANT owned by the connected wallet (except for advanced use cases, each ArNS name will have its own ANT). You can view and create new undernames using the "Undernames" button, or access advanced management options by clicking on the "manage" icon (shaped like a gear).')]),a._v(" "),e("img",{staticClass:"amazingdiagram",attrs:{src:a.$withBase("/images/arns-assets-ants.jpeg")}}),a._v(" "),e("p",[a._v("The Advanced manage page allows you to transfer ownership, add or remove controllers (other wallets who are able to manage an ANT) or set/modify a Target ID for a name to resolve to.")]),a._v(" "),e("img",{staticClass:"amazingdiagram",attrs:{src:a.$withBase("/images/arns-manage-ant.jpeg")}})])}),[],!1,null,null,null);e.default=n.exports}}]); \ No newline at end of file diff --git a/assets/js/68.69f60bc7.js b/assets/js/68.f86fd47c.js similarity index 96% rename from assets/js/68.69f60bc7.js rename to assets/js/68.f86fd47c.js index fdff9748..849bcdbc 100644 --- a/assets/js/68.69f60bc7.js +++ b/assets/js/68.f86fd47c.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[68],{369:function(e,t,a){"use strict";a.r(t);var n=a(10),i=Object(n.a)({},(function(){var e=this,t=e._self._c;return t("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[t("h1",{attrs:{id:"ar-io-labs"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#ar-io-labs"}},[e._v("#")]),e._v(" AR.IO Labs")]),e._v(" "),t("h2",{attrs:{id:"what-is-ar-io-labs"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#what-is-ar-io-labs"}},[e._v("#")]),e._v(" What is AR.IO Labs?")]),e._v(" "),t("p",[e._v("AR.IO Labs serves as the for-profit arm of the AR.IO ecosystem, playing a crucial role in driving innovation, commercial development, and entrepreneurial initiatives. While the AR.IO Foundation focuses on the non-profit aspects and sustenance of the AR.IO Network, AR.IO Labs is geared towards harnessing the network's potential to create profitable ventures and cutting-edge products.")]),e._v(" "),t("p",[e._v("Key focuses of AR.IO Labs include:")]),e._v(" "),t("ul",[t("li",[t("p",[e._v("Innovation and research")])]),e._v(" "),t("li",[t("p",[e._v("Commercial development")])]),e._v(" "),t("li",[t("p",[e._v("Incubation of startups")])]),e._v(" "),t("li",[t("p",[e._v("Collaboration with external entities")])]),e._v(" "),t("li",[t("p",[e._v("Token and asset management")])]),e._v(" "),t("li",[t("p",[e._v("Revenue generation for ecosystem sustainability")])]),e._v(" "),t("li",[t("p",[e._v("Adoption and marketing")])]),e._v(" "),t("li",[t("p",[e._v("Resilience and growth")])])]),e._v(" "),t("p",[e._v("As the for-profit arm of the AR.IO ecosystem, AR.IO Labs works in tandem with the AR.IO Foundation to create a sustainable and flourishing decentralized network that thrives both commercially and altruistically, fostering a balanced and impactful presence within the blockchain and decentralized technology landscape.")])])}),[],!1,null,null,null);t.default=i.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[68],{368:function(e,t,a){"use strict";a.r(t);var n=a(10),i=Object(n.a)({},(function(){var e=this,t=e._self._c;return t("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[t("h1",{attrs:{id:"ar-io-labs"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#ar-io-labs"}},[e._v("#")]),e._v(" AR.IO Labs")]),e._v(" "),t("h2",{attrs:{id:"what-is-ar-io-labs"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#what-is-ar-io-labs"}},[e._v("#")]),e._v(" What is AR.IO Labs?")]),e._v(" "),t("p",[e._v("AR.IO Labs serves as the for-profit arm of the AR.IO ecosystem, playing a crucial role in driving innovation, commercial development, and entrepreneurial initiatives. While the AR.IO Foundation focuses on the non-profit aspects and sustenance of the AR.IO Network, AR.IO Labs is geared towards harnessing the network's potential to create profitable ventures and cutting-edge products.")]),e._v(" "),t("p",[e._v("Key focuses of AR.IO Labs include:")]),e._v(" "),t("ul",[t("li",[t("p",[e._v("Innovation and research")])]),e._v(" "),t("li",[t("p",[e._v("Commercial development")])]),e._v(" "),t("li",[t("p",[e._v("Incubation of startups")])]),e._v(" "),t("li",[t("p",[e._v("Collaboration with external entities")])]),e._v(" "),t("li",[t("p",[e._v("Token and asset management")])]),e._v(" "),t("li",[t("p",[e._v("Revenue generation for ecosystem sustainability")])]),e._v(" "),t("li",[t("p",[e._v("Adoption and marketing")])]),e._v(" "),t("li",[t("p",[e._v("Resilience and growth")])])]),e._v(" "),t("p",[e._v("As the for-profit arm of the AR.IO ecosystem, AR.IO Labs works in tandem with the AR.IO Foundation to create a sustainable and flourishing decentralized network that thrives both commercially and altruistically, fostering a balanced and impactful presence within the blockchain and decentralized technology landscape.")])])}),[],!1,null,null,null);t.default=i.exports}}]); \ No newline at end of file diff --git a/assets/js/69.3a8793c4.js b/assets/js/69.25286ad5.js similarity index 95% rename from assets/js/69.3a8793c4.js rename to assets/js/69.25286ad5.js index af54f69f..08455bb6 100644 --- a/assets/js/69.3a8793c4.js +++ b/assets/js/69.25286ad5.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[69],{368:function(e,t,s){"use strict";s.r(t);var a=s(10),n=Object(a.a)({},(function(){var e=this,t=e._self._c;return t("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[t("h1",{attrs:{id:"the-io-token"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#the-io-token"}},[e._v("#")]),e._v(" The IO Token")]),e._v(" "),t("p",[t("strong",[e._v("NOTE")]),e._v(": The IO Token and its associated functions are still in development and have not yet been released.")]),e._v(" "),t("h2",{attrs:{id:"overview"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#overview"}},[e._v("#")]),e._v(" Overview")]),e._v(" "),t("p",[e._v("IO is the multifunction aoComputer based token that powers The AR.IO Network and its suite of permaweb applications. The IO Token (ɸ) has many uses, including:")]),e._v(" "),t("ul",[t("li",[t("p",[e._v("Protocol incentives,")])]),e._v(" "),t("li",[t("p",[e._v("Staking by gateways,")])]),e._v(" "),t("li",[t("p",[e._v("Payments for services like the Arweave Name System (ArNS),")])]),e._v(" "),t("li",[t("p",[e._v("Gateway delegated staking")])])]),e._v(" "),t("p",[e._v("The token acts as a permissionless and censorship resistant medium of common value for the network.")])])}),[],!1,null,null,null);t.default=n.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[69],{369:function(e,t,s){"use strict";s.r(t);var a=s(10),n=Object(a.a)({},(function(){var e=this,t=e._self._c;return t("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[t("h1",{attrs:{id:"the-io-token"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#the-io-token"}},[e._v("#")]),e._v(" The IO Token")]),e._v(" "),t("p",[t("strong",[e._v("NOTE")]),e._v(": The IO Token and its associated functions are still in development and have not yet been released.")]),e._v(" "),t("h2",{attrs:{id:"overview"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#overview"}},[e._v("#")]),e._v(" Overview")]),e._v(" "),t("p",[e._v("IO is the multifunction aoComputer based token that powers The AR.IO Network and its suite of permaweb applications. The IO Token (ɸ) has many uses, including:")]),e._v(" "),t("ul",[t("li",[t("p",[e._v("Protocol incentives,")])]),e._v(" "),t("li",[t("p",[e._v("Staking by gateways,")])]),e._v(" "),t("li",[t("p",[e._v("Payments for services like the Arweave Name System (ArNS),")])]),e._v(" "),t("li",[t("p",[e._v("Gateway delegated staking")])])]),e._v(" "),t("p",[e._v("The token acts as a permissionless and censorship resistant medium of common value for the network.")])])}),[],!1,null,null,null);t.default=n.exports}}]); \ No newline at end of file diff --git a/assets/js/app.5948138c.js b/assets/js/app.5948138c.js new file mode 100644 index 00000000..d0e5a4d4 --- /dev/null +++ b/assets/js/app.5948138c.js @@ -0,0 +1,21 @@ +(window.webpackJsonp=window.webpackJsonp||[]).push([[0],[]]);!function(e){function n(n){for(var a,r,s=n[0],l=n[1],d=n[2],c=0,u=[];c
'};function i(e,n,t){return et?t:e}function o(e){return 100*(-1+e)}t.configure=function(e){var n,t;for(n in e)void 0!==(t=e[n])&&e.hasOwnProperty(n)&&(a[n]=t);return this},t.status=null,t.set=function(e){var n=t.isStarted();e=i(e,a.minimum,1),t.status=1===e?null:e;var l=t.render(!n),d=l.querySelector(a.barSelector),m=a.speed,c=a.easing;return l.offsetWidth,r((function(n){""===a.positionUsing&&(a.positionUsing=t.getPositioningCSS()),s(d,function(e,n,t){var i;return(i="translate3d"===a.positionUsing?{transform:"translate3d("+o(e)+"%,0,0)"}:"translate"===a.positionUsing?{transform:"translate("+o(e)+"%,0)"}:{"margin-left":o(e)+"%"}).transition="all "+n+"ms "+t,i}(e,m,c)),1===e?(s(l,{transition:"none",opacity:1}),l.offsetWidth,setTimeout((function(){s(l,{transition:"all "+m+"ms linear",opacity:0}),setTimeout((function(){t.remove(),n()}),m)}),m)):setTimeout(n,m)})),this},t.isStarted=function(){return"number"==typeof t.status},t.start=function(){t.status||t.set(0);var e=function(){setTimeout((function(){t.status&&(t.trickle(),e())}),a.trickleSpeed)};return a.trickle&&e(),this},t.done=function(e){return e||t.status?t.inc(.3+.5*Math.random()).set(1):this},t.inc=function(e){var n=t.status;return n?("number"!=typeof e&&(e=(1-n)*i(Math.random()*n,.1,.95)),n=i(n+e,0,.994),t.set(n)):t.start()},t.trickle=function(){return t.inc(Math.random()*a.trickleRate)},e=0,n=0,t.promise=function(a){return a&&"resolved"!==a.state()?(0===n&&t.start(),e++,n++,a.always((function(){0==--n?(e=0,t.done()):t.set((e-n)/e)})),this):this},t.render=function(e){if(t.isRendered())return document.getElementById("nprogress");d(document.documentElement,"nprogress-busy");var n=document.createElement("div");n.id="nprogress",n.innerHTML=a.template;var i,r=n.querySelector(a.barSelector),l=e?"-100":o(t.status||0),m=document.querySelector(a.parent);return s(r,{transition:"all 0 linear",transform:"translate3d("+l+"%,0,0)"}),a.showSpinner||(i=n.querySelector(a.spinnerSelector))&&u(i),m!=document.body&&d(m,"nprogress-custom-parent"),m.appendChild(n),n},t.remove=function(){m(document.documentElement,"nprogress-busy"),m(document.querySelector(a.parent),"nprogress-custom-parent");var e=document.getElementById("nprogress");e&&u(e)},t.isRendered=function(){return!!document.getElementById("nprogress")},t.getPositioningCSS=function(){var e=document.body.style,n="WebkitTransform"in e?"Webkit":"MozTransform"in e?"Moz":"msTransform"in e?"ms":"OTransform"in e?"O":"";return n+"Perspective"in e?"translate3d":n+"Transform"in e?"translate":"margin"};var r=function(){var e=[];function n(){var t=e.shift();t&&t(n)}return function(t){e.push(t),1==e.length&&n()}}(),s=function(){var e=["Webkit","O","Moz","ms"],n={};function t(t){return t=t.replace(/^-ms-/,"ms-").replace(/-([\da-z])/gi,(function(e,n){return n.toUpperCase()})),n[t]||(n[t]=function(n){var t=document.body.style;if(n in t)return n;for(var a,i=e.length,o=n.charAt(0).toUpperCase()+n.slice(1);i--;)if((a=e[i]+o)in t)return a;return n}(t))}function a(e,n,a){n=t(n),e.style[n]=a}return function(e,n){var t,i,o=arguments;if(2==o.length)for(t in n)void 0!==(i=n[t])&&n.hasOwnProperty(t)&&a(e,t,i);else a(e,o[1],o[2])}}();function l(e,n){return("string"==typeof e?e:c(e)).indexOf(" "+n+" ")>=0}function d(e,n){var t=c(e),a=t+n;l(t,n)||(e.className=a.substring(1))}function m(e,n){var t,a=c(e);l(e,n)&&(t=a.replace(" "+n+" "," "),e.className=t.substring(1,t.length-1))}function c(e){return(" "+(e.className||"")+" ").replace(/\s+/gi," ")}function u(e){e&&e.parentNode&&e.parentNode.removeChild(e)}return t})?a.call(n,t,n,e):a)||(e.exports=i)},function(e,n,t){"use strict";var a=t(0),i=t(49).f,o=t(13),r=t(92),s=t(35),l=t(61),d=t(122);e.exports=function(e,n){var t,m,c,u,h,y=e.target,w=e.global,z=e.stat;if(t=w?a:z?a[y]||s(y,{}):a[y]&&a[y].prototype)for(m in n){if(u=n[m],c=e.dontCallGetSet?(h=i(t,m))&&h.value:t[m],!d(w?m:y+(z?".":"#")+m,e.forced)&&void 0!==c){if(typeof u==typeof c)continue;l(u,c)}(e.sham||c&&c.sham)&&o(u,"sham",!0),r(t,m,u,e)}}},function(e,n,t){"use strict";var a=t(3);e.exports=!a((function(){var e=function(){}.bind();return"function"!=typeof e||e.hasOwnProperty("prototype")}))},function(e,n,t){"use strict";var a=t(46),i=t(33);e.exports=function(e){return a(i(e))}},function(e,n,t){"use strict";var a=t(0),i=t(1),o=function(e){return i(e)?e:void 0};e.exports=function(e,n){return arguments.length<2?o(a[e]):a[e]&&a[e][n]}},function(e,n,t){"use strict";var a=t(1),i=t(109),o=TypeError;e.exports=function(e){if(a(e))return e;throw new o(i(e)+" is not a function")}},function(e,n,t){"use strict";var a=t(0),i=t(57),o=t(8),r=t(59),s=t(55),l=t(54),d=a.Symbol,m=i("wks"),c=l?d.for||d:d&&d.withoutSetter||r;e.exports=function(e){return o(m,e)||(m[e]=s&&o(d,e)?d[e]:c("Symbol."+e)),m[e]}},function(e,n,t){"use strict";var a=t(33),i=Object;e.exports=function(e){return i(a(e))}},function(e,n,t){"use strict";var a=t(120);e.exports=function(e){return a(e.length)}},function(e,n,t){"use strict";var a=t(24),i=Function.prototype.call;e.exports=a?i.bind(i):function(){return i.apply(i,arguments)}},function(e,n,t){"use strict";e.exports=function(e,n){return{enumerable:!(1&e),configurable:!(2&e),writable:!(4&e),value:n}}},function(e,n,t){"use strict";var a=t(50),i=TypeError;e.exports=function(e){if(a(e))throw new i("Can't call method on "+e);return e}},function(e,n,t){"use strict";var a=t(58),i=t(0),o=t(35),r=e.exports=i["__core-js_shared__"]||o("__core-js_shared__",{});(r.versions||(r.versions=[])).push({version:"3.37.1",mode:a?"pure":"global",copyright:"© 2014-2024 Denis Pushkarev (zloirock.ru)",license:"https://github.com/zloirock/core-js/blob/v3.37.1/LICENSE",source:"https://github.com/zloirock/core-js"})},function(e,n,t){"use strict";var a=t(0),i=Object.defineProperty;e.exports=function(e,n){try{i(a,e,{value:n,configurable:!0,writable:!0})}catch(t){a[e]=n}return n}},function(e,n,t){var a=t(146),i=t(11),o=Object.prototype,r=o.hasOwnProperty,s=o.propertyIsEnumerable,l=a(function(){return arguments}())?a:function(e){return i(e)&&r.call(e,"callee")&&!s.call(e,"callee")};e.exports=l},function(e,n,t){var a=t(9)(t(7),"Map");e.exports=a},function(e,n){e.exports=function(e){var n=typeof e;return null!=e&&("object"==n||"function"==n)}},function(e,n,t){var a=t(166),i=t(173),o=t(175),r=t(176),s=t(177);function l(e){var n=-1,t=null==e?0:e.length;for(this.clear();++n-1&&e%1==0&&e<=9007199254740991}},function(e,n,t){var a=t(4),i=t(43),o=/\.|\[(?:[^[\]]*|(["'])(?:(?!\1)[^\\]|\\.)*?\1)\]/,r=/^\w*$/;e.exports=function(e,n){if(a(e))return!1;var t=typeof e;return!("number"!=t&&"symbol"!=t&&"boolean"!=t&&null!=e&&!i(e))||(r.test(e)||!o.test(e)||null!=n&&e in Object(n))}},function(e,n,t){var a=t(12),i=t(11);e.exports=function(e){return"symbol"==typeof e||i(e)&&"[object Symbol]"==a(e)}},function(e,n){e.exports=function(e){return e}},function(e,n,t){"use strict";var a=t(6),i=String,o=TypeError;e.exports=function(e){if(a(e))return e;throw new o(i(e)+" is not an object")}},function(e,n,t){"use strict";var a=t(2),i=t(3),o=t(16),r=Object,s=a("".split);e.exports=i((function(){return!r("z").propertyIsEnumerable(0)}))?function(e){return"String"===o(e)?s(e,""):r(e)}:r},function(e,n,t){"use strict";e.exports={}},function(e,n){e.exports=function(e){return e.webpackPolyfill||(e.deprecate=function(){},e.paths=[],e.children||(e.children=[]),Object.defineProperty(e,"loaded",{enumerable:!0,get:function(){return e.l}}),Object.defineProperty(e,"id",{enumerable:!0,get:function(){return e.i}}),e.webpackPolyfill=1),e}},function(e,n,t){"use strict";var a=t(5),i=t(31),o=t(105),r=t(32),s=t(25),l=t(51),d=t(8),m=t(60),c=Object.getOwnPropertyDescriptor;n.f=a?c:function(e,n){if(e=s(e),n=l(n),m)try{return c(e,n)}catch(e){}if(d(e,n))return r(!i(o.f,e,n),e[n])}},function(e,n,t){"use strict";e.exports=function(e){return null==e}},function(e,n,t){"use strict";var a=t(106),i=t(52);e.exports=function(e){var n=a(e,"string");return i(n)?n:n+""}},function(e,n,t){"use strict";var a=t(26),i=t(1),o=t(53),r=t(54),s=Object;e.exports=r?function(e){return"symbol"==typeof e}:function(e){var n=a("Symbol");return i(n)&&o(n.prototype,s(e))}},function(e,n,t){"use strict";var a=t(2);e.exports=a({}.isPrototypeOf)},function(e,n,t){"use strict";var a=t(55);e.exports=a&&!Symbol.sham&&"symbol"==typeof Symbol.iterator},function(e,n,t){"use strict";var a=t(56),i=t(3),o=t(0).String;e.exports=!!Object.getOwnPropertySymbols&&!i((function(){var e=Symbol("symbol detection");return!o(e)||!(Object(e)instanceof Symbol)||!Symbol.sham&&a&&a<41}))},function(e,n,t){"use strict";var a,i,o=t(0),r=t(107),s=o.process,l=o.Deno,d=s&&s.versions||l&&l.version,m=d&&d.v8;m&&(i=(a=m.split("."))[0]>0&&a[0]<4?1:+(a[0]+a[1])),!i&&r&&(!(a=r.match(/Edge\/(\d+)/))||a[1]>=74)&&(a=r.match(/Chrome\/(\d+)/))&&(i=+a[1]),e.exports=i},function(e,n,t){"use strict";var a=t(34);e.exports=function(e,n){return a[e]||(a[e]=n||{})}},function(e,n,t){"use strict";e.exports=!1},function(e,n,t){"use strict";var a=t(2),i=0,o=Math.random(),r=a(1..toString);e.exports=function(e){return"Symbol("+(void 0===e?"":e)+")_"+r(++i+o,36)}},function(e,n,t){"use strict";var a=t(5),i=t(3),o=t(96);e.exports=!a&&!i((function(){return 7!==Object.defineProperty(o("div"),"a",{get:function(){return 7}}).a}))},function(e,n,t){"use strict";var a=t(8),i=t(115),o=t(49),r=t(15);e.exports=function(e,n,t){for(var s=i(n),l=r.f,d=o.f,m=0;mm))return!1;var u=l.get(e),h=l.get(n);if(u&&h)return u==n&&h==e;var y=-1,w=!0,z=2&t?new a:void 0;for(l.set(e,n),l.set(n,e);++y-1&&e%1==0&&e]/;e.exports=function(e){var n,t=""+e,i=a.exec(t);if(!i)return t;var o="",r=0,s=0;for(r=i.index;r=n||t<0||z&&e-d>=o}function f(){var e=h();if(b(e))return v(e);s=setTimeout(f,function(e){var t=n-(e-l);return z?u(t,o-(e-d)):t}(e))}function v(e){return s=void 0,p&&a?g(e):(a=i=void 0,r)}function k(){var e=h(),t=b(e);if(a=arguments,i=this,l=e,t){if(void 0===s)return j(l);if(z)return s=setTimeout(f,n),g(l)}return void 0===s&&(s=setTimeout(f,n)),r}return n=w(n)||0,y(t)&&(m=!!t.leading,o=(z="maxWait"in t)?c(w(t.maxWait)||0,n):o,p="trailing"in t?!!t.trailing:p),k.cancel=function(){void 0!==s&&clearTimeout(s),d=0,a=l=i=s=void 0},k.flush=function(){return void 0===s?r:v(h())},k}},function(e,n,t){"use strict";var a=t(23),i=t(29),o=t(30),r=t(141),s=t(143);a({target:"Array",proto:!0,arity:1,forced:t(3)((function(){return 4294967297!==[].push.call({length:4294967296},1)}))||!function(){try{Object.defineProperty([],"length",{writable:!1}).push()}catch(e){return e instanceof TypeError}}()},{push:function(e){var n=i(this),t=o(n),a=arguments.length;s(t+a);for(var l=0;ld;)i(a,t=n[d++])&&(~r(m,t)||l(m,t));return m}},,,function(e,n,t){e.exports=t(243)},function(e,n,t){"use strict";var a=t(23),i=t(123).left,o=t(124),r=t(56);a({target:"Array",proto:!0,forced:!t(125)&&r>79&&r<83||!o("reduce")},{reduce:function(e){var n=arguments.length;return i(this,e,n,n>1?arguments[1]:void 0)}})},function(e,n,t){"use strict";var a={}.propertyIsEnumerable,i=Object.getOwnPropertyDescriptor,o=i&&!a.call({1:2},1);n.f=o?function(e){var n=i(this,e);return!!n&&n.enumerable}:a},function(e,n,t){"use strict";var a=t(31),i=t(6),o=t(52),r=t(108),s=t(110),l=t(28),d=TypeError,m=l("toPrimitive");e.exports=function(e,n){if(!i(e)||o(e))return e;var t,l=r(e,m);if(l){if(void 0===n&&(n="default"),t=a(l,e,n),!i(t)||o(t))return t;throw new d("Can't convert object to primitive value")}return void 0===n&&(n="number"),s(e,n)}},function(e,n,t){"use strict";e.exports="undefined"!=typeof navigator&&String(navigator.userAgent)||""},function(e,n,t){"use strict";var a=t(27),i=t(50);e.exports=function(e,n){var t=e[n];return i(t)?void 0:a(t)}},function(e,n,t){"use strict";var a=String;e.exports=function(e){try{return a(e)}catch(e){return"Object"}}},function(e,n,t){"use strict";var a=t(31),i=t(1),o=t(6),r=TypeError;e.exports=function(e,n){var t,s;if("string"===n&&i(t=e.toString)&&!o(s=a(t,e)))return s;if(i(t=e.valueOf)&&!o(s=a(t,e)))return s;if("string"!==n&&i(t=e.toString)&&!o(s=a(t,e)))return s;throw new r("Can't convert object to primitive value")}},function(e,n,t){"use strict";var a=t(5),i=t(8),o=Function.prototype,r=a&&Object.getOwnPropertyDescriptor,s=i(o,"name"),l=s&&"something"===function(){}.name,d=s&&(!a||a&&r(o,"name").configurable);e.exports={EXISTS:s,PROPER:l,CONFIGURABLE:d}},function(e,n,t){"use strict";var a=t(2),i=t(1),o=t(34),r=a(Function.toString);i(o.inspectSource)||(o.inspectSource=function(e){return r(e)}),e.exports=o.inspectSource},function(e,n,t){"use strict";var a,i,o,r=t(114),s=t(0),l=t(6),d=t(13),m=t(8),c=t(34),u=t(99),h=t(47),y=s.TypeError,w=s.WeakMap;if(r||c.state){var z=c.state||(c.state=new w);z.get=z.get,z.has=z.has,z.set=z.set,a=function(e,n){if(z.has(e))throw new y("Object already initialized");return n.facade=e,z.set(e,n),n},i=function(e){return z.get(e)||{}},o=function(e){return z.has(e)}}else{var p=u("state");h[p]=!0,a=function(e,n){if(m(e,p))throw new y("Object already initialized");return n.facade=e,d(e,p,n),n},i=function(e){return m(e,p)?e[p]:{}},o=function(e){return m(e,p)}}e.exports={set:a,get:i,has:o,enforce:function(e){return o(e)?i(e):a(e,{})},getterFor:function(e){return function(n){var t;if(!l(n)||(t=i(n)).type!==e)throw new y("Incompatible receiver, "+e+" required");return t}}}},function(e,n,t){"use strict";var a=t(0),i=t(1),o=a.WeakMap;e.exports=i(o)&&/native code/.test(String(o))},function(e,n,t){"use strict";var a=t(26),i=t(2),o=t(116),r=t(121),s=t(45),l=i([].concat);e.exports=a("Reflect","ownKeys")||function(e){var n=o.f(s(e)),t=r.f;return t?l(n,t(e)):n}},function(e,n,t){"use strict";var a=t(100),i=t(93).concat("length","prototype");n.f=Object.getOwnPropertyNames||function(e){return a(e,i)}},function(e,n,t){"use strict";var a=t(25),i=t(118),o=t(30),r=function(e){return function(n,t,r){var s=a(n),l=o(s);if(0===l)return!e&&-1;var d,m=i(r,l);if(e&&t!=t){for(;l>m;)if((d=s[m++])!=d)return!0}else for(;l>m;m++)if((e||m in s)&&s[m]===t)return e||m||0;return!e&&-1}};e.exports={includes:r(!0),indexOf:r(!1)}},function(e,n,t){"use strict";var a=t(62),i=Math.max,o=Math.min;e.exports=function(e,n){var t=a(e);return t<0?i(t+n,0):o(t,n)}},function(e,n,t){"use strict";var a=Math.ceil,i=Math.floor;e.exports=Math.trunc||function(e){var n=+e;return(n>0?i:a)(n)}},function(e,n,t){"use strict";var a=t(62),i=Math.min;e.exports=function(e){var n=a(e);return n>0?i(n,9007199254740991):0}},function(e,n,t){"use strict";n.f=Object.getOwnPropertySymbols},function(e,n,t){"use strict";var a=t(3),i=t(1),o=/#|\.prototype\./,r=function(e,n){var t=l[s(e)];return t===m||t!==d&&(i(n)?a(n):!!n)},s=r.normalize=function(e){return String(e).replace(o,".").toLowerCase()},l=r.data={},d=r.NATIVE="N",m=r.POLYFILL="P";e.exports=r},function(e,n,t){"use strict";var a=t(27),i=t(29),o=t(46),r=t(30),s=TypeError,l="Reduce of empty array with no initial value",d=function(e){return function(n,t,d,m){var c=i(n),u=o(c),h=r(c);if(a(t),0===h&&d<2)throw new s(l);var y=e?h-1:0,w=e?-1:1;if(d<2)for(;;){if(y in u){m=u[y],y+=w;break}if(y+=w,e?y<0:h<=y)throw new s(l)}for(;e?y>=0:h>y;y+=w)y in u&&(m=t(m,u[y],y,c));return m}};e.exports={left:d(!1),right:d(!0)}},function(e,n,t){"use strict";var a=t(3);e.exports=function(e,n){var t=[][e];return!!t&&a((function(){t.call(null,n||function(){return 1},1)}))}},function(e,n,t){"use strict";var a=t(0),i=t(16);e.exports="process"===i(a.process)},function(e,n,t){"use strict";var a=t(23),i=t(0),o=t(127),r=t(128),s=i.WebAssembly,l=7!==new Error("e",{cause:7}).cause,d=function(e,n){var t={};t[e]=r(e,n,l),a({global:!0,constructor:!0,arity:1,forced:l},t)},m=function(e,n){if(s&&s[e]){var t={};t[e]=r("WebAssembly."+e,n,l),a({target:"WebAssembly",stat:!0,constructor:!0,arity:1,forced:l},t)}};d("Error",(function(e){return function(n){return o(e,this,arguments)}})),d("EvalError",(function(e){return function(n){return o(e,this,arguments)}})),d("RangeError",(function(e){return function(n){return o(e,this,arguments)}})),d("ReferenceError",(function(e){return function(n){return o(e,this,arguments)}})),d("SyntaxError",(function(e){return function(n){return o(e,this,arguments)}})),d("TypeError",(function(e){return function(n){return o(e,this,arguments)}})),d("URIError",(function(e){return function(n){return o(e,this,arguments)}})),m("CompileError",(function(e){return function(n){return o(e,this,arguments)}})),m("LinkError",(function(e){return function(n){return o(e,this,arguments)}})),m("RuntimeError",(function(e){return function(n){return o(e,this,arguments)}}))},function(e,n,t){"use strict";var a=t(24),i=Function.prototype,o=i.apply,r=i.call;e.exports="object"==typeof Reflect&&Reflect.apply||(a?r.bind(o):function(){return r.apply(o,arguments)})},function(e,n,t){"use strict";var a=t(26),i=t(8),o=t(13),r=t(53),s=t(63),l=t(61),d=t(132),m=t(133),c=t(134),u=t(137),h=t(138),y=t(5),w=t(58);e.exports=function(e,n,t,z){var p=z?2:1,g=e.split("."),j=g[g.length-1],b=a.apply(null,g);if(b){var f=b.prototype;if(!w&&i(f,"cause")&&delete f.cause,!t)return b;var v=a("Error"),k=n((function(e,n){var t=c(z?n:e,void 0),a=z?new b(e):new b;return void 0!==t&&o(a,"message",t),h(a,k,a.stack,2),this&&r(f,this)&&m(a,this,k),arguments.length>p&&u(a,arguments[p]),a}));if(k.prototype=f,"Error"!==j?s?s(k,v):l(k,v,{name:!0}):y&&"stackTraceLimit"in b&&(d(k,b,"stackTraceLimit"),d(k,b,"prepareStackTrace")),l(k,b),!w)try{f.name!==j&&o(f,"name",j),f.constructor=k}catch(e){}return k}}},function(e,n,t){"use strict";var a=t(2),i=t(27);e.exports=function(e,n,t){try{return a(i(Object.getOwnPropertyDescriptor(e,n)[t]))}catch(e){}}},function(e,n,t){"use strict";var a=t(131),i=String,o=TypeError;e.exports=function(e){if(a(e))return e;throw new o("Can't set "+i(e)+" as a prototype")}},function(e,n,t){"use strict";var a=t(6);e.exports=function(e){return a(e)||null===e}},function(e,n,t){"use strict";var a=t(15).f;e.exports=function(e,n,t){t in e||a(e,t,{configurable:!0,get:function(){return n[t]},set:function(e){n[t]=e}})}},function(e,n,t){"use strict";var a=t(1),i=t(6),o=t(63);e.exports=function(e,n,t){var r,s;return o&&a(r=n.constructor)&&r!==t&&i(s=r.prototype)&&s!==t.prototype&&o(e,s),e}},function(e,n,t){"use strict";var a=t(94);e.exports=function(e,n){return void 0===e?arguments.length<2?"":n:a(e)}},function(e,n,t){"use strict";var a=t(136),i=t(1),o=t(16),r=t(28)("toStringTag"),s=Object,l="Arguments"===o(function(){return arguments}());e.exports=a?o:function(e){var n,t,a;return void 0===e?"Undefined":null===e?"Null":"string"==typeof(t=function(e,n){try{return e[n]}catch(e){}}(n=s(e),r))?t:l?o(n):"Object"===(a=o(n))&&i(n.callee)?"Arguments":a}},function(e,n,t){"use strict";var a={};a[t(28)("toStringTag")]="z",e.exports="[object z]"===String(a)},function(e,n,t){"use strict";var a=t(6),i=t(13);e.exports=function(e,n){a(n)&&"cause"in n&&i(e,"cause",n.cause)}},function(e,n,t){"use strict";var a=t(13),i=t(139),o=t(140),r=Error.captureStackTrace;e.exports=function(e,n,t,s){o&&(r?r(e,n):a(e,"stack",i(t,s)))}},function(e,n,t){"use strict";var a=t(2),i=Error,o=a("".replace),r=String(new i("zxcasd").stack),s=/\n\s*at [^:]*:[^\n]*/,l=s.test(r);e.exports=function(e,n){if(l&&"string"==typeof e&&!i.prepareStackTrace)for(;n--;)e=o(e,s,"");return e}},function(e,n,t){"use strict";var a=t(3),i=t(32);e.exports=!a((function(){var e=new Error("a");return!("stack"in e)||(Object.defineProperty(e,"stack",i(1,7)),7!==e.stack)}))},function(e,n,t){"use strict";var a=t(5),i=t(142),o=TypeError,r=Object.getOwnPropertyDescriptor,s=a&&!function(){if(void 0!==this)return!0;try{Object.defineProperty([],"length",{writable:!1}).length=1}catch(e){return e instanceof TypeError}}();e.exports=s?function(e,n){if(i(e)&&!r(e,"length").writable)throw new o("Cannot set read only .length");return e.length=n}:function(e,n){return e.length=n}},function(e,n,t){"use strict";var a=t(16);e.exports=Array.isArray||function(e){return"Array"===a(e)}},function(e,n,t){"use strict";var a=TypeError;e.exports=function(e){if(e>9007199254740991)throw a("Maximum allowed index exceeded");return e}},function(e,n,t){var a=t(64),i=t(145);e.exports=function e(n,t,o,r,s){var l=-1,d=n.length;for(o||(o=i),s||(s=[]);++l0&&o(m)?t>1?e(m,t-1,o,r,s):a(s,m):r||(s[s.length]=m)}return s}},function(e,n,t){var a=t(14),i=t(36),o=t(4),r=a?a.isConcatSpreadable:void 0;e.exports=function(e){return o(e)||i(e)||!!(r&&e&&e[r])}},function(e,n,t){var a=t(12),i=t(11);e.exports=function(e){return i(e)&&"[object Arguments]"==a(e)}},function(e,n,t){var a=t(14),i=Object.prototype,o=i.hasOwnProperty,r=i.toString,s=a?a.toStringTag:void 0;e.exports=function(e){var n=o.call(e,s),t=e[s];try{e[s]=void 0;var a=!0}catch(e){}var i=r.call(e);return a&&(n?e[s]=t:delete e[s]),i}},function(e,n){var t=Object.prototype.toString;e.exports=function(e){return t.call(e)}},function(e,n,t){var a=t(150),i=t(206),o=t(44),r=t(4),s=t(216);e.exports=function(e){return"function"==typeof e?e:null==e?o:"object"==typeof e?r(e)?i(e[0],e[1]):a(e):s(e)}},function(e,n,t){var a=t(151),i=t(205),o=t(81);e.exports=function(e){var n=i(e);return 1==n.length&&n[0][2]?o(n[0][0],n[0][1]):function(t){return t===e||a(t,e,n)}}},function(e,n,t){var a=t(66),i=t(70);e.exports=function(e,n,t,o){var r=t.length,s=r,l=!o;if(null==e)return!s;for(e=Object(e);r--;){var d=t[r];if(l&&d[2]?d[1]!==e[d[0]]:!(d[0]in e))return!1}for(;++r-1}},function(e,n,t){var a=t(18);e.exports=function(e,n){var t=this.__data__,i=a(t,e);return i<0?(++this.size,t.push([e,n])):t[i][1]=n,this}},function(e,n,t){var a=t(17);e.exports=function(){this.__data__=new a,this.size=0}},function(e,n){e.exports=function(e){var n=this.__data__,t=n.delete(e);return this.size=n.size,t}},function(e,n){e.exports=function(e){return this.__data__.get(e)}},function(e,n){e.exports=function(e){return this.__data__.has(e)}},function(e,n,t){var a=t(17),i=t(37),o=t(39);e.exports=function(e,n){var t=this.__data__;if(t instanceof a){var r=t.__data__;if(!i||r.length<199)return r.push([e,n]),this.size=++t.size,this;t=this.__data__=new o(r)}return t.set(e,n),this.size=t.size,this}},function(e,n,t){var a=t(68),i=t(163),o=t(38),r=t(69),s=/^\[object .+?Constructor\]$/,l=Function.prototype,d=Object.prototype,m=l.toString,c=d.hasOwnProperty,u=RegExp("^"+m.call(c).replace(/[\\^$.*+?()[\]{}|]/g,"\\$&").replace(/hasOwnProperty|(function).*?(?=\\\()| for .+?(?=\\\])/g,"$1.*?")+"$");e.exports=function(e){return!(!o(e)||i(e))&&(a(e)?u:s).test(r(e))}},function(e,n,t){var a,i=t(164),o=(a=/[^.]+$/.exec(i&&i.keys&&i.keys.IE_PROTO||""))?"Symbol(src)_1."+a:"";e.exports=function(e){return!!o&&o in e}},function(e,n,t){var a=t(7)["__core-js_shared__"];e.exports=a},function(e,n){e.exports=function(e,n){return null==e?void 0:e[n]}},function(e,n,t){var a=t(167),i=t(17),o=t(37);e.exports=function(){this.size=0,this.__data__={hash:new a,map:new(o||i),string:new a}}},function(e,n,t){var a=t(168),i=t(169),o=t(170),r=t(171),s=t(172);function l(e){var n=-1,t=null==e?0:e.length;for(this.clear();++n0){if(++n>=800)return arguments[0]}else n=0;return e.apply(void 0,arguments)}}},function(e,n,t){var a=t(72),i=t(228),o=t(233),r=t(73),s=t(234),l=t(40);e.exports=function(e,n,t){var d=-1,m=i,c=e.length,u=!0,h=[],y=h;if(t)u=!1,m=o;else if(c>=200){var w=n?null:s(e);if(w)return l(w);u=!1,m=r,y=new a}else y=n?[]:h;e:for(;++d-1}},function(e,n,t){var a=t(230),i=t(231),o=t(232);e.exports=function(e,n,t){return n==n?o(e,n,t):a(e,i,t)}},function(e,n){e.exports=function(e,n,t,a){for(var i=e.length,o=t+(a?1:-1);a?o--:++o=0&&Math.floor(n)===n&&isFinite(e)}function w(e){return r(e)&&"function"==typeof e.then&&"function"==typeof e.catch}function z(e){return null==e?"":Array.isArray(e)||u(e)&&e.toString===c?JSON.stringify(e,p,2):String(e)}function p(e,n){return n&&n.__v_isRef?n.value:n}function g(e){var n=parseFloat(e);return isNaN(n)?e:n}function j(e,n){for(var t=Object.create(null),a=e.split(","),i=0;i-1)return e.splice(a,1)}}var v=Object.prototype.hasOwnProperty;function k(e,n){return v.call(e,n)}function x(e){var n=Object.create(null);return function(t){return n[t]||(n[t]=e(t))}}var q=/-(\w)/g,_=x((function(e){return e.replace(q,(function(e,n){return n?n.toUpperCase():""}))})),N=x((function(e){return e.charAt(0).toUpperCase()+e.slice(1)})),Z=/\B([A-Z])/g,M=x((function(e){return e.replace(Z,"-$1").toLowerCase()}));var I=Function.prototype.bind?function(e,n){return e.bind(n)}:function(e,n){function t(t){var a=arguments.length;return a?a>1?e.apply(n,arguments):e.call(n,t):e.call(n)}return t._length=e.length,t};function T(e,n){n=n||0;for(var t=e.length-n,a=new Array(t);t--;)a[t]=e[t+n];return a}function Y(e,n){for(var t in n)e[t]=n[t];return e}function A(e){for(var n={},t=0;t0,$=H&&H.indexOf("edge/")>0;H&&H.indexOf("android");var ee=H&&/iphone|ipad|ipod|ios/.test(H);H&&/chrome\/\d+/.test(H),H&&/phantomjs/.test(H);var ne,te=H&&H.match(/firefox\/(\d+)/),ae={}.watch,ie=!1;if(L)try{var oe={};Object.defineProperty(oe,"passive",{get:function(){ie=!0}}),window.addEventListener("test-passive",null,oe)}catch(e){}var re=function(){return void 0===ne&&(ne=!L&&"undefined"!=typeof global&&(global.process&&"server"===global.process.env.VUE_ENV)),ne},se=L&&window.__VUE_DEVTOOLS_GLOBAL_HOOK__;function le(e){return"function"==typeof e&&/native code/.test(e.toString())}var de,me="undefined"!=typeof Symbol&&le(Symbol)&&"undefined"!=typeof Reflect&&le(Reflect.ownKeys);de="undefined"!=typeof Set&&le(Set)?Set:function(){function e(){this.set=Object.create(null)}return e.prototype.has=function(e){return!0===this.set[e]},e.prototype.add=function(e){this.set[e]=!0},e.prototype.clear=function(){this.set=Object.create(null)},e}();var ce=null;function ue(e){void 0===e&&(e=null),e||ce&&ce._scope.off(),ce=e,e&&e._scope.on()}var he=function(){function e(e,n,t,a,i,o,r,s){this.tag=e,this.data=n,this.children=t,this.text=a,this.elm=i,this.ns=void 0,this.context=o,this.fnContext=void 0,this.fnOptions=void 0,this.fnScopeId=void 0,this.key=n&&n.key,this.componentOptions=r,this.componentInstance=void 0,this.parent=void 0,this.raw=!1,this.isStatic=!1,this.isRootInsert=!0,this.isComment=!1,this.isCloned=!1,this.isOnce=!1,this.asyncFactory=s,this.asyncMeta=void 0,this.isAsyncPlaceholder=!1}return Object.defineProperty(e.prototype,"child",{get:function(){return this.componentInstance},enumerable:!1,configurable:!0}),e}(),ye=function(e){void 0===e&&(e="");var n=new he;return n.text=e,n.isComment=!0,n};function we(e){return new he(void 0,void 0,void 0,String(e))}function ze(e){var n=new he(e.tag,e.data,e.children&&e.children.slice(),e.text,e.elm,e.context,e.componentOptions,e.asyncFactory);return n.ns=e.ns,n.isStatic=e.isStatic,n.key=e.key,n.isComment=e.isComment,n.fnContext=e.fnContext,n.fnOptions=e.fnOptions,n.fnScopeId=e.fnScopeId,n.asyncMeta=e.asyncMeta,n.isCloned=!0,n}"function"==typeof SuppressedError&&SuppressedError;var pe=0,ge=[],je=function(){function e(){this._pending=!1,this.id=pe++,this.subs=[]}return e.prototype.addSub=function(e){this.subs.push(e)},e.prototype.removeSub=function(e){this.subs[this.subs.indexOf(e)]=null,this._pending||(this._pending=!0,ge.push(this))},e.prototype.depend=function(n){e.target&&e.target.addDep(this)},e.prototype.notify=function(e){var n=this.subs.filter((function(e){return e}));for(var t=0,a=n.length;t0&&(on((d=e(d,"".concat(t||"","_").concat(a)))[0])&&on(c)&&(u[m]=we(c.text+d[0].text),d.shift()),u.push.apply(u,d)):l(d)?on(c)?u[m]=we(c.text+d):""!==d&&u.push(we(d)):on(d)&&on(c)?u[m]=we(c.text+d.text):(s(n._isVList)&&r(d.tag)&&o(d.key)&&r(t)&&(d.key="__vlist".concat(t,"_").concat(a,"__")),u.push(d)));return u}(e):void 0}function on(e){return r(e)&&r(e.text)&&!1===e.isComment}function rn(e,n){var t,a,o,s,l=null;if(i(e)||"string"==typeof e)for(l=new Array(e.length),t=0,a=e.length;t0,s=n?!!n.$stable:!r,l=n&&n.$key;if(n){if(n._normalized)return n._normalized;if(s&&i&&i!==a&&l===i.$key&&!r&&!i.$hasNormal)return i;for(var d in o={},n)n[d]&&"$"!==d[0]&&(o[d]=qn(e,t,d,n[d]))}else o={};for(var m in t)m in o||(o[m]=_n(t,m));return n&&Object.isExtensible(n)&&(n._normalized=o),X(o,"$stable",s),X(o,"$key",l),X(o,"$hasNormal",r),o}function qn(e,n,t,a){var o=function(){var n=ce;ue(e);var t=arguments.length?a.apply(null,arguments):a({}),o=(t=t&&"object"==typeof t&&!i(t)?[t]:an(t))&&t[0];return ue(n),t&&(!o||1===t.length&&o.isComment&&!kn(o))?void 0:t};return a.proxy&&Object.defineProperty(n,t,{get:o,enumerable:!0,configurable:!0}),o}function _n(e,n){return function(){return e[n]}}function Nn(e){return{get attrs(){if(!e._attrsProxy){var n=e._attrsProxy={};X(n,"_v_attr_proxy",!0),Zn(n,e.$attrs,a,e,"$attrs")}return e._attrsProxy},get listeners(){e._listenersProxy||Zn(e._listenersProxy={},e.$listeners,a,e,"$listeners");return e._listenersProxy},get slots(){return function(e){e._slotsProxy||In(e._slotsProxy={},e.$scopedSlots);return e._slotsProxy}(e)},emit:I(e.$emit,e),expose:function(n){n&&Object.keys(n).forEach((function(t){return Fe(e,n,t)}))}}}function Zn(e,n,t,a,i){var o=!1;for(var r in n)r in e?n[r]!==t[r]&&(o=!0):(o=!0,Mn(e,r,a,i));for(var r in e)r in n||(o=!0,delete e[r]);return o}function Mn(e,n,t,a){Object.defineProperty(e,n,{enumerable:!0,configurable:!0,get:function(){return t[a][n]}})}function In(e,n){for(var t in n)e[t]=n[t];for(var t in e)t in n||delete e[t]}var Tn=null;function Yn(e,n){return(e.__esModule||me&&"Module"===e[Symbol.toStringTag])&&(e=e.default),m(e)?n.extend(e):e}function An(e){if(i(e))for(var n=0;ndocument.createEvent("Event").timeStamp&&(pt=function(){return gt.now()})}var jt=function(e,n){if(e.post){if(!n.post)return 1}else if(n.post)return-1;return e.id-n.id};function bt(){var e,n;for(zt=pt(),yt=!0,mt.sort(jt),wt=0;wtwt&&mt[t].id>e.id;)t--;mt.splice(t+1,0,e)}else mt.push(e);ht||(ht=!0,Cn(bt))}}function vt(e,n){if(e){for(var t=Object.create(null),a=me?Reflect.ownKeys(e):Object.keys(e),i=0;i-1)if(o&&!k(i,"default"))r=!1;else if(""===r||r===M(e)){var l=Jt(String,i.type);(l<0||s-1:"string"==typeof e?e.split(",").indexOf(n)>-1:!!h(e)&&e.test(n)}function oa(e,n){var t=e.cache,a=e.keys,i=e._vnode,o=e.$vnode;for(var r in t){var s=t[r];if(s){var l=s.name;l&&!n(l)&&ra(t,r,a,i)}}o.componentOptions.children=void 0}function ra(e,n,t,a){var i=e[n];!i||a&&i.tag===a.tag||i.componentInstance.$destroy(),e[n]=null,f(t,n)}na.prototype._init=function(e){var n=this;n._uid=$t++,n._isVue=!0,n.__v_skip=!0,n._scope=new He(!0),n._scope.parent=void 0,n._scope._vm=!0,e&&e._isComponent?function(e,n){var t=e.$options=Object.create(e.constructor.options),a=n._parentVnode;t.parent=n.parent,t._parentVnode=a;var i=a.componentOptions;t.propsData=i.propsData,t._parentListeners=i.listeners,t._renderChildren=i.children,t._componentTag=i.tag,n.render&&(t.render=n.render,t.staticRenderFns=n.staticRenderFns)}(n,e):n.$options=Ut(ea(n.constructor),e||{},n),n._renderProxy=n,n._self=n,function(e){var n=e.$options,t=n.parent;if(t&&!n.abstract){for(;t.$options.abstract&&t.$parent;)t=t.$parent;t.$children.push(e)}e.$parent=t,e.$root=t?t.$root:e,e.$children=[],e.$refs={},e._provided=t?t._provided:Object.create(null),e._watcher=null,e._inactive=null,e._directInactive=!1,e._isMounted=!1,e._isDestroyed=!1,e._isBeingDestroyed=!1}(n),function(e){e._events=Object.create(null),e._hasHookEvent=!1;var n=e.$options._parentListeners;n&&it(e,n)}(n),function(e){e._vnode=null,e._staticTrees=null;var n=e.$options,t=e.$vnode=n._parentVnode,i=t&&t.context;e.$slots=fn(n._renderChildren,i),e.$scopedSlots=t?xn(e.$parent,t.data.scopedSlots,e.$slots):a,e._c=function(n,t,a,i){return Wn(e,n,t,a,i,!1)},e.$createElement=function(n,t,a,i){return Wn(e,n,t,a,i,!0)};var o=t&&t.data;Ye(e,"$attrs",o&&o.attrs||a,null,!0),Ye(e,"$listeners",n._parentListeners||a,null,!0)}(n),dt(n,"beforeCreate",void 0,!1),function(e){var n=vt(e.$options.inject,e);n&&(Ze(!1),Object.keys(n).forEach((function(t){Ye(e,t,n[t])})),Ze(!0))}(n),Bt(n),function(e){var n=e.$options.provide;if(n){var t=d(n)?n.call(e):n;if(!m(t))return;for(var a=Pe(e),i=me?Reflect.ownKeys(t):Object.keys(t),o=0;o1?T(t):t;for(var a=T(arguments,1),i='event handler for "'.concat(e,'"'),o=0,r=t.length;oparseInt(this.max)&&ra(e,n[0],n,this._vnode),this.vnodeToCache=null}}},created:function(){this.cache=Object.create(null),this.keys=[]},destroyed:function(){for(var e in this.cache)ra(this.cache,e,this.keys)},mounted:function(){var e=this;this.cacheVNode(),this.$watch("include",(function(n){oa(e,(function(e){return ia(n,e)}))})),this.$watch("exclude",(function(n){oa(e,(function(e){return!ia(n,e)}))}))},updated:function(){this.cacheVNode()},render:function(){var e=this.$slots.default,n=An(e),t=n&&n.componentOptions;if(t){var a=aa(t),i=this.include,o=this.exclude;if(i&&(!a||!ia(i,a))||o&&a&&ia(o,a))return n;var r=this.cache,s=this.keys,l=null==n.key?t.Ctor.cid+(t.tag?"::".concat(t.tag):""):n.key;r[l]?(n.componentInstance=r[l].componentInstance,f(s,l),s.push(l)):(this.vnodeToCache=n,this.keyToCache=l),n.data.keepAlive=!0}return n||e&&e[0]}}};!function(e){var n={get:function(){return Q}};Object.defineProperty(e,"config",n),e.util={warn:Tt,extend:Y,mergeOptions:Ut,defineReactive:Ye},e.set=Ae,e.delete=We,e.nextTick=Cn,e.observable=function(e){return Te(e),e},e.options=Object.create(null),G.forEach((function(n){e.options[n+"s"]=Object.create(null)})),e.options._base=e,Y(e.options.components,la),function(e){e.use=function(e){var n=this._installedPlugins||(this._installedPlugins=[]);if(n.indexOf(e)>-1)return this;var t=T(arguments,1);return t.unshift(this),d(e.install)?e.install.apply(e,t):d(e)&&e.apply(null,t),n.push(e),this}}(e),function(e){e.mixin=function(e){return this.options=Ut(this.options,e),this}}(e),ta(e),function(e){G.forEach((function(n){e[n]=function(e,t){return t?("component"===n&&u(t)&&(t.name=t.name||e,t=this.options._base.extend(t)),"directive"===n&&d(t)&&(t={bind:t,update:t}),this.options[n+"s"][e]=t,t):this.options[n+"s"][e]}}))}(e)}(na),Object.defineProperty(na.prototype,"$isServer",{get:re}),Object.defineProperty(na.prototype,"$ssrContext",{get:function(){return this.$vnode&&this.$vnode.ssrContext}}),Object.defineProperty(na,"FunctionalRenderContext",{value:kt}),na.version="2.7.16";var da=j("style,class"),ma=j("input,textarea,option,select,progress"),ca=j("contenteditable,draggable,spellcheck"),ua=j("events,caret,typing,plaintext-only"),ha=j("allowfullscreen,async,autofocus,autoplay,checked,compact,controls,declare,default,defaultchecked,defaultmuted,defaultselected,defer,disabled,enabled,formnovalidate,hidden,indeterminate,inert,ismap,itemscope,loop,multiple,muted,nohref,noresize,noshade,novalidate,nowrap,open,pauseonexit,readonly,required,reversed,scoped,seamless,selected,sortable,truespeed,typemustmatch,visible"),ya="http://www.w3.org/1999/xlink",wa=function(e){return":"===e.charAt(5)&&"xlink"===e.slice(0,5)},za=function(e){return wa(e)?e.slice(6,e.length):""},pa=function(e){return null==e||!1===e};function ga(e){for(var n=e.data,t=e,a=e;r(a.componentInstance);)(a=a.componentInstance._vnode)&&a.data&&(n=ja(a.data,n));for(;r(t=t.parent);)t&&t.data&&(n=ja(n,t.data));return function(e,n){if(r(e)||r(n))return ba(e,fa(n));return""}(n.staticClass,n.class)}function ja(e,n){return{staticClass:ba(e.staticClass,n.staticClass),class:r(e.class)?[e.class,n.class]:n.class}}function ba(e,n){return e?n?e+" "+n:e:n||""}function fa(e){return Array.isArray(e)?function(e){for(var n,t="",a=0,i=e.length;a-1?Sa(e,n,t):ha(n)?pa(t)?e.removeAttribute(n):(t="allowfullscreen"===n&&"EMBED"===e.tagName?"true":n,e.setAttribute(n,t)):ca(n)?e.setAttribute(n,function(e,n){return pa(n)||"false"===n?"false":"contenteditable"===e&&ua(n)?n:"true"}(n,t)):wa(n)?pa(t)?e.removeAttributeNS(ya,za(n)):e.setAttributeNS(ya,n,t):Sa(e,n,t)}function Sa(e,n,t){if(pa(t))e.removeAttribute(n);else{if(P&&!K&&"TEXTAREA"===e.tagName&&"placeholder"===n&&""!==t&&!e.__ieph){var a=function(n){n.stopImmediatePropagation(),e.removeEventListener("input",a)};e.addEventListener("input",a),e.__ieph=!0}e.setAttribute(n,t)}}var Xa={create:Qa,update:Qa};function Ba(e,n){var t=n.elm,a=n.data,i=e.data;if(!(o(a.staticClass)&&o(a.class)&&(o(i)||o(i.staticClass)&&o(i.class)))){var s=ga(n),l=t._transitionClasses;r(l)&&(s=ba(s,fa(l))),s!==t._prevClass&&(t.setAttribute("class",s),t._prevClass=s)}}var Ca,La={create:Ba,update:Ba};function Ha(e,n,t){var a=Ca;return function i(){var o=n.apply(null,arguments);null!==o&&$a(e,i,t,a)}}var Pa=Vn&&!(te&&Number(te[1])<=53);function Ka(e,n,t,a){if(Pa){var i=zt,o=n;n=o._wrapper=function(e){if(e.target===e.currentTarget||e.timeStamp>=i||e.timeStamp<=0||e.target.ownerDocument!==document)return o.apply(this,arguments)}}Ca.addEventListener(e,n,ie?{capture:t,passive:a}:t)}function $a(e,n,t,a){(a||Ca).removeEventListener(e,n._wrapper||n,t)}function ei(e,n){if(!o(e.data.on)||!o(n.data.on)){var t=n.data.on||{},a=e.data.on||{};Ca=n.elm||e.elm,function(e){if(r(e.__r)){var n=P?"change":"input";e[n]=[].concat(e.__r,e[n]||[]),delete e.__r}r(e.__c)&&(e.change=[].concat(e.__c,e.change||[]),delete e.__c)}(t),en(t,a,Ka,$a,Ha,n.context),Ca=void 0}}var ni,ti={create:ei,update:ei,destroy:function(e){return ei(e,Ya)}};function ai(e,n){if(!o(e.data.domProps)||!o(n.data.domProps)){var t,a,i=n.elm,l=e.data.domProps||{},d=n.data.domProps||{};for(t in(r(d.__ob__)||s(d._v_attr_proxy))&&(d=n.data.domProps=Y({},d)),l)t in d||(i[t]="");for(t in d){if(a=d[t],"textContent"===t||"innerHTML"===t){if(n.children&&(n.children.length=0),a===l[t])continue;1===i.childNodes.length&&i.removeChild(i.childNodes[0])}if("value"===t&&"PROGRESS"!==i.tagName){i._value=a;var m=o(a)?"":String(a);ii(i,m)&&(i.value=m)}else if("innerHTML"===t&&xa(i.tagName)&&o(i.innerHTML)){(ni=ni||document.createElement("div")).innerHTML="".concat(a,"");for(var c=ni.firstChild;i.firstChild;)i.removeChild(i.firstChild);for(;c.firstChild;)i.appendChild(c.firstChild)}else if(a!==l[t])try{i[t]=a}catch(e){}}}}function ii(e,n){return!e.composing&&("OPTION"===e.tagName||function(e,n){var t=!0;try{t=document.activeElement!==e}catch(e){}return t&&e.value!==n}(e,n)||function(e,n){var t=e.value,a=e._vModifiers;if(r(a)){if(a.number)return g(t)!==g(n);if(a.trim)return t.trim()!==n.trim()}return t!==n}(e,n))}var oi={create:ai,update:ai},ri=x((function(e){var n={},t=/:(.+)/;return e.split(/;(?![^(]*\))/g).forEach((function(e){if(e){var a=e.split(t);a.length>1&&(n[a[0].trim()]=a[1].trim())}})),n}));function si(e){var n=li(e.style);return e.staticStyle?Y(e.staticStyle,n):n}function li(e){return Array.isArray(e)?A(e):"string"==typeof e?ri(e):e}var di,mi=/^--/,ci=/\s*!important$/,ui=function(e,n,t){if(mi.test(n))e.style.setProperty(n,t);else if(ci.test(t))e.style.setProperty(M(n),t.replace(ci,""),"important");else{var a=yi(n);if(Array.isArray(t))for(var i=0,o=t.length;i-1?n.split(pi).forEach((function(n){return e.classList.add(n)})):e.classList.add(n);else{var t=" ".concat(e.getAttribute("class")||""," ");t.indexOf(" "+n+" ")<0&&e.setAttribute("class",(t+n).trim())}}function ji(e,n){if(n&&(n=n.trim()))if(e.classList)n.indexOf(" ")>-1?n.split(pi).forEach((function(n){return e.classList.remove(n)})):e.classList.remove(n),e.classList.length||e.removeAttribute("class");else{for(var t=" ".concat(e.getAttribute("class")||""," "),a=" "+n+" ";t.indexOf(a)>=0;)t=t.replace(a," ");(t=t.trim())?e.setAttribute("class",t):e.removeAttribute("class")}}function bi(e){if(e){if("object"==typeof e){var n={};return!1!==e.css&&Y(n,fi(e.name||"v")),Y(n,e),n}return"string"==typeof e?fi(e):void 0}}var fi=x((function(e){return{enterClass:"".concat(e,"-enter"),enterToClass:"".concat(e,"-enter-to"),enterActiveClass:"".concat(e,"-enter-active"),leaveClass:"".concat(e,"-leave"),leaveToClass:"".concat(e,"-leave-to"),leaveActiveClass:"".concat(e,"-leave-active")}})),vi=L&&!K,ki="transition",xi="transitionend",qi="animation",_i="animationend";vi&&(void 0===window.ontransitionend&&void 0!==window.onwebkittransitionend&&(ki="WebkitTransition",xi="webkitTransitionEnd"),void 0===window.onanimationend&&void 0!==window.onwebkitanimationend&&(qi="WebkitAnimation",_i="webkitAnimationEnd"));var Ni=L?window.requestAnimationFrame?window.requestAnimationFrame.bind(window):setTimeout:function(e){return e()};function Zi(e){Ni((function(){Ni(e)}))}function Mi(e,n){var t=e._transitionClasses||(e._transitionClasses=[]);t.indexOf(n)<0&&(t.push(n),gi(e,n))}function Ii(e,n){e._transitionClasses&&f(e._transitionClasses,n),ji(e,n)}function Ti(e,n,t){var a=Ai(e,n),i=a.type,o=a.timeout,r=a.propCount;if(!i)return t();var s="transition"===i?xi:_i,l=0,d=function(){e.removeEventListener(s,m),t()},m=function(n){n.target===e&&++l>=r&&d()};setTimeout((function(){l0&&(t="transition",m=r,c=o.length):"animation"===n?d>0&&(t="animation",m=d,c=l.length):c=(t=(m=Math.max(r,d))>0?r>d?"transition":"animation":null)?"transition"===t?o.length:l.length:0,{type:t,timeout:m,propCount:c,hasTransform:"transition"===t&&Yi.test(a[ki+"Property"])}}function Wi(e,n){for(;e.length1}function Vi(e,n){!0!==n.data.show&&Di(n)}var Gi=function(e){var n,t,a={},d=e.modules,m=e.nodeOps;for(n=0;ny?b(e,o(t[p+1])?null:t[p+1].elm,t,h,p,a):h>p&&v(n,c,y)}(c,w,p,t,d):r(p)?(r(e.text)&&m.setTextContent(c,""),b(c,null,p,0,p.length-1,t)):r(w)?v(w,0,w.length-1):r(e.text)&&m.setTextContent(c,""):e.text!==n.text&&m.setTextContent(c,n.text),r(y)&&r(h=y.hook)&&r(h=h.postpatch)&&h(e,n)}}}function _(e,n,t){if(s(t)&&r(e.parent))e.parent.data.pendingInsert=n;else for(var a=0;a-1,r.selected!==o&&(r.selected=o);else if(R(Xi(r),a))return void(e.selectedIndex!==s&&(e.selectedIndex=s));i||(e.selectedIndex=-1)}}function Si(e,n){return n.every((function(n){return!R(n,e)}))}function Xi(e){return"_value"in e?e._value:e.value}function Bi(e){e.target.composing=!0}function Ci(e){e.target.composing&&(e.target.composing=!1,Li(e.target,"input"))}function Li(e,n){var t=document.createEvent("HTMLEvents");t.initEvent(n,!0,!0),e.dispatchEvent(t)}function Hi(e){return!e.componentInstance||e.data&&e.data.transition?e:Hi(e.componentInstance._vnode)}var Pi={model:Fi,show:{bind:function(e,n,t){var a=n.value,i=(t=Hi(t)).data&&t.data.transition,o=e.__vOriginalDisplay="none"===e.style.display?"":e.style.display;a&&i?(t.data.show=!0,Di(t,(function(){e.style.display=o}))):e.style.display=a?o:"none"},update:function(e,n,t){var a=n.value;!a!=!n.oldValue&&((t=Hi(t)).data&&t.data.transition?(t.data.show=!0,a?Di(t,(function(){e.style.display=e.__vOriginalDisplay})):Ri(t,(function(){e.style.display="none"}))):e.style.display=a?e.__vOriginalDisplay:"none")},unbind:function(e,n,t,a,i){i||(e.style.display=e.__vOriginalDisplay)}}},Ki={name:String,appear:Boolean,css:Boolean,mode:String,type:String,enterClass:String,leaveClass:String,enterToClass:String,leaveToClass:String,enterActiveClass:String,leaveActiveClass:String,appearClass:String,appearActiveClass:String,appearToClass:String,duration:[Number,String,Object]};function $i(e){var n=e&&e.componentOptions;return n&&n.Ctor.options.abstract?$i(An(n.children)):e}function eo(e){var n={},t=e.$options;for(var a in t.propsData)n[a]=e[a];var i=t._parentListeners;for(var a in i)n[_(a)]=i[a];return n}function no(e,n){if(/\d-keep-alive$/.test(n.tag))return e("keep-alive",{props:n.componentOptions.propsData})}var to=function(e){return e.tag||kn(e)},ao=function(e){return"show"===e.name},io={name:"transition",props:Ki,abstract:!0,render:function(e){var n=this,t=this.$slots.default;if(t&&(t=t.filter(to)).length){0;var a=this.mode;0;var i=t[0];if(function(e){for(;e=e.parent;)if(e.data.transition)return!0}(this.$vnode))return i;var o=$i(i);if(!o)return i;if(this._leaving)return no(e,i);var r="__transition-".concat(this._uid,"-");o.key=null==o.key?o.isComment?r+"comment":r+o.tag:l(o.key)?0===String(o.key).indexOf(r)?o.key:r+o.key:o.key;var s=(o.data||(o.data={})).transition=eo(this),d=this._vnode,m=$i(d);if(o.data.directives&&o.data.directives.some(ao)&&(o.data.show=!0),m&&m.data&&!function(e,n){return n.key===e.key&&n.tag===e.tag}(o,m)&&!kn(m)&&(!m.componentInstance||!m.componentInstance._vnode.isComment)){var c=m.data.transition=Y({},s);if("out-in"===a)return this._leaving=!0,nn(c,"afterLeave",(function(){n._leaving=!1,n.$forceUpdate()})),no(e,i);if("in-out"===a){if(kn(o))return d;var u,h=function(){u()};nn(s,"afterEnter",h),nn(s,"enterCancelled",h),nn(c,"delayLeave",(function(e){u=e}))}}return i}}},oo=Y({tag:String,moveClass:String},Ki);function ro(e){e.elm._moveCb&&e.elm._moveCb(),e.elm._enterCb&&e.elm._enterCb()}function so(e){e.data.newPos=e.elm.getBoundingClientRect()}function lo(e){var n=e.data.pos,t=e.data.newPos,a=n.left-t.left,i=n.top-t.top;if(a||i){e.data.moved=!0;var o=e.elm.style;o.transform=o.WebkitTransform="translate(".concat(a,"px,").concat(i,"px)"),o.transitionDuration="0s"}}delete oo.mode;var mo={Transition:io,TransitionGroup:{props:oo,beforeMount:function(){var e=this,n=this._update;this._update=function(t,a){var i=rt(e);e.__patch__(e._vnode,e.kept,!1,!0),e._vnode=e.kept,i(),n.call(e,t,a)}},render:function(e){for(var n=this.tag||this.$vnode.data.tag||"span",t=Object.create(null),a=this.prevChildren=this.children,i=this.$slots.default||[],o=this.children=[],r=eo(this),s=0;s-1?_a[e]=n.constructor===window.HTMLUnknownElement||n.constructor===window.HTMLElement:_a[e]=/HTMLUnknownElement/.test(n.toString())},Y(na.options.directives,Pi),Y(na.options.components,mo),na.prototype.__patch__=L?Gi:W,na.prototype.$mount=function(e,n){return function(e,n,t){var a;e.$el=n,e.$options.render||(e.$options.render=ye),dt(e,"beforeMount"),a=function(){e._update(e._render(),t)},new et(e,a,W,{before:function(){e._isMounted&&!e._isDestroyed&&dt(e,"beforeUpdate")}},!0),t=!1;var i=e._preWatchers;if(i)for(var o=0;o=0&&(n=e.slice(a),e=e.slice(0,a));var i=e.indexOf("?");return i>=0&&(t=e.slice(i+1),e=e.slice(0,i)),{path:e,query:t,hash:n}}(i.path||""),d=n&&n.path||"/",m=l.path?To(l.path,d,t||i.append):d,c=function(e,n,t){void 0===n&&(n={});var a,i=t||go;try{a=i(e||"")}catch(e){a={}}for(var o in n){var r=n[o];a[o]=Array.isArray(r)?r.map(po):po(r)}return a}(l.query,i.query,a&&a.options.parseQuery),u=i.hash||l.hash;return u&&"#"!==u.charAt(0)&&(u="#"+u),{_normalized:!0,path:m,query:c,hash:u}}var Ko,$o=function(){},er={name:"RouterLink",props:{to:{type:[String,Object],required:!0},tag:{type:String,default:"a"},custom:Boolean,exact:Boolean,exactPath:Boolean,append:Boolean,replace:Boolean,activeClass:String,exactActiveClass:String,ariaCurrentValue:{type:String,default:"page"},event:{type:[String,Array],default:"click"}},render:function(e){var n=this,t=this.$router,a=this.$route,i=t.resolve(this.to,a,this.append),o=i.location,r=i.route,s=i.href,l={},d=t.options.linkActiveClass,m=t.options.linkExactActiveClass,c=null==d?"router-link-active":d,u=null==m?"router-link-exact-active":m,h=null==this.activeClass?c:this.activeClass,y=null==this.exactActiveClass?u:this.exactActiveClass,w=r.redirectedFrom?fo(null,Po(r.redirectedFrom),null,t):r;l[y]=_o(a,w,this.exactPath),l[h]=this.exact||this.exactPath?l[y]:function(e,n){return 0===e.path.replace(bo,"/").indexOf(n.path.replace(bo,"/"))&&(!n.hash||e.hash===n.hash)&&function(e,n){for(var t in n)if(!(t in e))return!1;return!0}(e.query,n.query)}(a,w);var z=l[y]?this.ariaCurrentValue:null,p=function(e){nr(e)&&(n.replace?t.replace(o,$o):t.push(o,$o))},g={click:nr};Array.isArray(this.event)?this.event.forEach((function(e){g[e]=p})):g[this.event]=p;var j={class:l},b=!this.$scopedSlots.$hasNormal&&this.$scopedSlots.default&&this.$scopedSlots.default({href:s,route:r,navigate:p,isActive:l[h],isExactActive:l[y]});if(b){if(1===b.length)return b[0];if(b.length>1||!b.length)return 0===b.length?e():e("span",{},b)}if("a"===this.tag)j.on=g,j.attrs={href:s,"aria-current":z};else{var f=function e(n){var t;if(n)for(var a=0;a-1&&(s.params[u]=t.params[u]);return s.path=Ho(m.path,s.params),l(m,s,r)}if(s.path){s.params={};for(var h=0;h-1}function Yr(e,n){return Tr(e)&&e._isRouter&&(null==n||e.type===n)}function Ar(e,n,t){var a=function(i){i>=e.length?t():e[i]?n(e[i],(function(){a(i+1)})):a(i+1)};a(0)}function Wr(e){return function(n,t,a){var i=!1,o=0,r=null;Or(e,(function(e,n,t,s){if("function"==typeof e&&void 0===e.cid){i=!0,o++;var l,d=Ur((function(n){var i;((i=n).__esModule||Rr&&"Module"===i[Symbol.toStringTag])&&(n=n.default),e.resolved="function"==typeof n?n:Ko.extend(n),t.components[s]=n,--o<=0&&a()})),m=Ur((function(e){var n="Failed to resolve async component "+s+": "+e;r||(r=Tr(e)?e:new Error(n),a(r))}));try{l=e(d,m)}catch(e){m(e)}if(l)if("function"==typeof l.then)l.then(d,m);else{var c=l.component;c&&"function"==typeof c.then&&c.then(d,m)}}})),i||a()}}function Or(e,n){return Dr(e.map((function(e){return Object.keys(e.components).map((function(t){return n(e.components[t],e.instances[t],e,t)}))})))}function Dr(e){return Array.prototype.concat.apply([],e)}var Rr="function"==typeof Symbol&&"symbol"==typeof Symbol.toStringTag;function Ur(e){var n=!1;return function(){for(var t=[],a=arguments.length;a--;)t[a]=arguments[a];if(!n)return n=!0,e.apply(this,t)}}var Er=function(e,n){this.router=e,this.base=function(e){if(!e)if(tr){var n=document.querySelector("base");e=(e=n&&n.getAttribute("href")||"/").replace(/^https?:\/\/[^\/]+/,"")}else e="/";"/"!==e.charAt(0)&&(e="/"+e);return e.replace(/\/$/,"")}(n),this.current=ko,this.pending=null,this.ready=!1,this.readyCbs=[],this.readyErrorCbs=[],this.errorCbs=[],this.listeners=[]};function Vr(e,n,t,a){var i=Or(e,(function(e,a,i,o){var r=function(e,n){"function"!=typeof e&&(e=Ko.extend(e));return e.options[n]}(e,n);if(r)return Array.isArray(r)?r.map((function(e){return t(e,a,i,o)})):t(r,a,i,o)}));return Dr(a?i.reverse():i)}function Gr(e,n){if(n)return function(){return e.apply(n,arguments)}}Er.prototype.listen=function(e){this.cb=e},Er.prototype.onReady=function(e,n){this.ready?e():(this.readyCbs.push(e),n&&this.readyErrorCbs.push(n))},Er.prototype.onError=function(e){this.errorCbs.push(e)},Er.prototype.transitionTo=function(e,n,t){var a,i=this;try{a=this.router.match(e,this.current)}catch(e){throw this.errorCbs.forEach((function(n){n(e)})),e}var o=this.current;this.confirmTransition(a,(function(){i.updateRoute(a),n&&n(a),i.ensureURL(),i.router.afterHooks.forEach((function(e){e&&e(a,o)})),i.ready||(i.ready=!0,i.readyCbs.forEach((function(e){e(a)})))}),(function(e){t&&t(e),e&&!i.ready&&(Yr(e,_r.redirected)&&o===ko||(i.ready=!0,i.readyErrorCbs.forEach((function(n){n(e)}))))}))},Er.prototype.confirmTransition=function(e,n,t){var a=this,i=this.current;this.pending=e;var o,r,s=function(e){!Yr(e)&&Tr(e)&&(a.errorCbs.length?a.errorCbs.forEach((function(n){n(e)})):console.error(e)),t&&t(e)},l=e.matched.length-1,d=i.matched.length-1;if(_o(e,i)&&l===d&&e.matched[l]===i.matched[d])return this.ensureURL(),e.hash&&yr(this.router,i,e,!1),s(((r=Mr(o=i,e,_r.duplicated,'Avoided redundant navigation to current location: "'+o.fullPath+'".')).name="NavigationDuplicated",r));var m=function(e,n){var t,a=Math.max(e.length,n.length);for(t=0;t0)){var n=this.router,t=n.options.scrollBehavior,a=kr&&t;a&&this.listeners.push(hr());var i=function(){var t=e.current,i=Qr(e.base);e.current===ko&&i===e._startLocation||e.transitionTo(i,(function(e){a&&yr(n,e,t,!0)}))};window.addEventListener("popstate",i),this.listeners.push((function(){window.removeEventListener("popstate",i)}))}},n.prototype.go=function(e){window.history.go(e)},n.prototype.push=function(e,n,t){var a=this,i=this.current;this.transitionTo(e,(function(e){xr(Yo(a.base+e.fullPath)),yr(a.router,e,i,!1),n&&n(e)}),t)},n.prototype.replace=function(e,n,t){var a=this,i=this.current;this.transitionTo(e,(function(e){qr(Yo(a.base+e.fullPath)),yr(a.router,e,i,!1),n&&n(e)}),t)},n.prototype.ensureURL=function(e){if(Qr(this.base)!==this.current.fullPath){var n=Yo(this.base+this.current.fullPath);e?xr(n):qr(n)}},n.prototype.getCurrentLocation=function(){return Qr(this.base)},n}(Er);function Qr(e){var n=window.location.pathname,t=n.toLowerCase(),a=e.toLowerCase();return!e||t!==a&&0!==t.indexOf(Yo(a+"/"))||(n=n.slice(e.length)),(n||"/")+window.location.search+window.location.hash}var Jr=function(e){function n(n,t,a){e.call(this,n,t),a&&function(e){var n=Qr(e);if(!/^\/#/.test(n))return window.location.replace(Yo(e+"/#"+n)),!0}(this.base)||Sr()}return e&&(n.__proto__=e),n.prototype=Object.create(e&&e.prototype),n.prototype.constructor=n,n.prototype.setupListeners=function(){var e=this;if(!(this.listeners.length>0)){var n=this.router.options.scrollBehavior,t=kr&&n;t&&this.listeners.push(hr());var a=function(){var n=e.current;Sr()&&e.transitionTo(Xr(),(function(a){t&&yr(e.router,a,n,!0),kr||Lr(a.fullPath)}))},i=kr?"popstate":"hashchange";window.addEventListener(i,a),this.listeners.push((function(){window.removeEventListener(i,a)}))}},n.prototype.push=function(e,n,t){var a=this,i=this.current;this.transitionTo(e,(function(e){Cr(e.fullPath),yr(a.router,e,i,!1),n&&n(e)}),t)},n.prototype.replace=function(e,n,t){var a=this,i=this.current;this.transitionTo(e,(function(e){Lr(e.fullPath),yr(a.router,e,i,!1),n&&n(e)}),t)},n.prototype.go=function(e){window.history.go(e)},n.prototype.ensureURL=function(e){var n=this.current.fullPath;Xr()!==n&&(e?Cr(n):Lr(n))},n.prototype.getCurrentLocation=function(){return Xr()},n}(Er);function Sr(){var e=Xr();return"/"===e.charAt(0)||(Lr("/"+e),!1)}function Xr(){var e=window.location.href,n=e.indexOf("#");return n<0?"":e=e.slice(n+1)}function Br(e){var n=window.location.href,t=n.indexOf("#");return(t>=0?n.slice(0,t):n)+"#"+e}function Cr(e){kr?xr(Br(e)):window.location.hash=e}function Lr(e){kr?qr(Br(e)):window.location.replace(Br(e))}var Hr=function(e){function n(n,t){e.call(this,n,t),this.stack=[],this.index=-1}return e&&(n.__proto__=e),n.prototype=Object.create(e&&e.prototype),n.prototype.constructor=n,n.prototype.push=function(e,n,t){var a=this;this.transitionTo(e,(function(e){a.stack=a.stack.slice(0,a.index+1).concat(e),a.index++,n&&n(e)}),t)},n.prototype.replace=function(e,n,t){var a=this;this.transitionTo(e,(function(e){a.stack=a.stack.slice(0,a.index).concat(e),n&&n(e)}),t)},n.prototype.go=function(e){var n=this,t=this.index+e;if(!(t<0||t>=this.stack.length)){var a=this.stack[t];this.confirmTransition(a,(function(){var e=n.current;n.index=t,n.updateRoute(a),n.router.afterHooks.forEach((function(n){n&&n(a,e)}))}),(function(e){Yr(e,_r.duplicated)&&(n.index=t)}))}},n.prototype.getCurrentLocation=function(){var e=this.stack[this.stack.length-1];return e?e.fullPath:"/"},n.prototype.ensureURL=function(){},n}(Er),Pr=function(e){void 0===e&&(e={}),this.app=null,this.apps=[],this.options=e,this.beforeHooks=[],this.resolveHooks=[],this.afterHooks=[],this.matcher=or(e.routes||[],this);var n=e.mode||"hash";switch(this.fallback="history"===n&&!kr&&!1!==e.fallback,this.fallback&&(n="hash"),tr||(n="abstract"),this.mode=n,n){case"history":this.history=new Fr(this,e.base);break;case"hash":this.history=new Jr(this,e.base,this.fallback);break;case"abstract":this.history=new Hr(this,e.base);break;default:0}},Kr={currentRoute:{configurable:!0}};Pr.prototype.match=function(e,n,t){return this.matcher.match(e,n,t)},Kr.currentRoute.get=function(){return this.history&&this.history.current},Pr.prototype.init=function(e){var n=this;if(this.apps.push(e),e.$once("hook:destroyed",(function(){var t=n.apps.indexOf(e);t>-1&&n.apps.splice(t,1),n.app===e&&(n.app=n.apps[0]||null),n.app||n.history.teardown()})),!this.app){this.app=e;var t=this.history;if(t instanceof Fr||t instanceof Jr){var a=function(e){t.setupListeners(),function(e){var a=t.current,i=n.options.scrollBehavior;kr&&i&&"fullPath"in e&&yr(n,e,a,!1)}(e)};t.transitionTo(t.getCurrentLocation(),a,a)}t.listen((function(e){n.apps.forEach((function(n){n._route=e}))}))}},Pr.prototype.beforeEach=function(e){return es(this.beforeHooks,e)},Pr.prototype.beforeResolve=function(e){return es(this.resolveHooks,e)},Pr.prototype.afterEach=function(e){return es(this.afterHooks,e)},Pr.prototype.onReady=function(e,n){this.history.onReady(e,n)},Pr.prototype.onError=function(e){this.history.onError(e)},Pr.prototype.push=function(e,n,t){var a=this;if(!n&&!t&&"undefined"!=typeof Promise)return new Promise((function(n,t){a.history.push(e,n,t)}));this.history.push(e,n,t)},Pr.prototype.replace=function(e,n,t){var a=this;if(!n&&!t&&"undefined"!=typeof Promise)return new Promise((function(n,t){a.history.replace(e,n,t)}));this.history.replace(e,n,t)},Pr.prototype.go=function(e){this.history.go(e)},Pr.prototype.back=function(){this.go(-1)},Pr.prototype.forward=function(){this.go(1)},Pr.prototype.getMatchedComponents=function(e){var n=e?e.matched?e:this.resolve(e).route:this.currentRoute;return n?[].concat.apply([],n.matched.map((function(e){return Object.keys(e.components).map((function(n){return e.components[n]}))}))):[]},Pr.prototype.resolve=function(e,n,t){var a=Po(e,n=n||this.history.current,t,this),i=this.match(a,n),o=i.redirectedFrom||i.fullPath;return{location:a,route:i,href:function(e,n,t){var a="hash"===t?"#"+n:n;return e?Yo(e+"/"+a):a}(this.history.base,o,this.mode),normalizedTo:a,resolved:i}},Pr.prototype.getRoutes=function(){return this.matcher.getRoutes()},Pr.prototype.addRoute=function(e,n){this.matcher.addRoute(e,n),this.history.current!==ko&&this.history.transitionTo(this.history.getCurrentLocation())},Pr.prototype.addRoutes=function(e){this.matcher.addRoutes(e),this.history.current!==ko&&this.history.transitionTo(this.history.getCurrentLocation())},Object.defineProperties(Pr.prototype,Kr);var $r=Pr;function es(e,n){return e.push(n),function(){var t=e.indexOf(n);t>-1&&e.splice(t,1)}}Pr.install=function e(n){if(!e.installed||Ko!==n){e.installed=!0,Ko=n;var t=function(e){return void 0!==e},a=function(e,n){var a=e.$options._parentVnode;t(a)&&t(a=a.data)&&t(a=a.registerRouteInstance)&&a(e,n)};n.mixin({beforeCreate:function(){t(this.$options.router)?(this._routerRoot=this,this._router=this.$options.router,this._router.init(this),n.util.defineReactive(this,"_route",this._router.history.current)):this._routerRoot=this.$parent&&this.$parent._routerRoot||this,a(this,this)},destroyed:function(){a(this)}}),Object.defineProperty(n.prototype,"$router",{get:function(){return this._routerRoot._router}}),Object.defineProperty(n.prototype,"$route",{get:function(){return this._routerRoot._route}}),n.component("RouterView",Mo),n.component("RouterLink",er);var i=n.config.optionMergeStrategies;i.beforeRouteEnter=i.beforeRouteLeave=i.beforeRouteUpdate=i.created}},Pr.version="3.6.5",Pr.isNavigationFailure=Yr,Pr.NavigationFailureType=_r,Pr.START_LOCATION=ko,tr&&window.Vue&&window.Vue.use(Pr);t(104);t(126),t(90);var ns={"components/AlgoliaSearchBox":()=>Promise.all([t.e(0),t.e(14)]).then(t.bind(null,322)),"components/DropdownLink":()=>Promise.all([t.e(0),t.e(15)]).then(t.bind(null,259)),"components/DropdownTransition":()=>Promise.all([t.e(0),t.e(22)]).then(t.bind(null,247)),"components/Home":()=>Promise.all([t.e(0),t.e(17)]).then(t.bind(null,295)),"components/NavLink":()=>t.e(25).then(t.bind(null,246)),"components/NavLinks":()=>Promise.all([t.e(0),t.e(13)]).then(t.bind(null,273)),"components/Navbar":()=>Promise.all([t.e(0),t.e(1)]).then(t.bind(null,318)),"components/Page":()=>Promise.all([t.e(0),t.e(12)]).then(t.bind(null,296)),"components/PageEdit":()=>Promise.all([t.e(0),t.e(18)]).then(t.bind(null,276)),"components/PageNav":()=>Promise.all([t.e(0),t.e(16)]).then(t.bind(null,277)),"components/Sidebar":()=>Promise.all([t.e(0),t.e(11)]).then(t.bind(null,297)),"components/SidebarButton":()=>Promise.all([t.e(0),t.e(21)]).then(t.bind(null,300)),"components/SidebarGroup":()=>Promise.all([t.e(0),t.e(4)]).then(t.bind(null,274)),"components/SidebarLink":()=>Promise.all([t.e(0),t.e(20)]).then(t.bind(null,260)),"components/SidebarLinks":()=>Promise.all([t.e(0),t.e(4)]).then(t.bind(null,258)),"global-components/Badge":()=>Promise.all([t.e(0),t.e(5)]).then(t.bind(null,327)),"global-components/CodeBlock":()=>Promise.all([t.e(0),t.e(6)]).then(t.bind(null,323)),"global-components/CodeGroup":()=>Promise.all([t.e(0),t.e(7)]).then(t.bind(null,324)),"layouts/404":()=>t.e(26).then(t.bind(null,325)),"layouts/Layout":()=>Promise.all([t.e(0),t.e(2),t.e(1),t.e(3)]).then(t.bind(null,319)),NotFound:()=>Promise.all([t.e(0),t.e(2),t.e(1),t.e(3),t.e(8)]).then(t.bind(null,326)),Layout:()=>Promise.all([t.e(0),t.e(2),t.e(1),t.e(3)]).then(t.bind(null,319)),"components/Footer":()=>Promise.all([t.e(0),t.e(23)]).then(t.bind(null,299)),"components/SearchBox":()=>Promise.all([t.e(0),t.e(24)]).then(t.bind(null,294)),"components/SearchModal":()=>Promise.all([t.e(0),t.e(2),t.e(19)]).then(t.bind(null,298)),"layouts/NotFound":()=>Promise.all([t.e(0),t.e(2),t.e(1),t.e(3),t.e(8)]).then(t.bind(null,326))},ts={"v-c0a4944c":()=>t.e(27).then(t.bind(null,328)),"v-b8cb630c":()=>t.e(29).then(t.bind(null,329)),"v-038b01fa":()=>t.e(28).then(t.bind(null,330)),"v-aaa9b6f4":()=>t.e(30).then(t.bind(null,331)),"v-0a39d43a":()=>t.e(31).then(t.bind(null,332)),"v-d6cbe5b8":()=>t.e(32).then(t.bind(null,333)),"v-c0082a28":()=>t.e(33).then(t.bind(null,334)),"v-4c2c563a":()=>t.e(34).then(t.bind(null,335)),"v-db3ac7ec":()=>t.e(35).then(t.bind(null,336)),"v-ecd6cf40":()=>t.e(36).then(t.bind(null,337)),"v-90d4f50c":()=>t.e(37).then(t.bind(null,338)),"v-9172688c":()=>t.e(39).then(t.bind(null,339)),"v-48851acc":()=>t.e(38).then(t.bind(null,340)),"v-172dfc5a":()=>t.e(40).then(t.bind(null,341)),"v-d314c1cc":()=>t.e(42).then(t.bind(null,342)),"v-30ab1e90":()=>t.e(41).then(t.bind(null,343)),"v-3f2c877a":()=>t.e(43).then(t.bind(null,344)),"v-2fa5878c":()=>t.e(44).then(t.bind(null,345)),"v-b292638c":()=>t.e(45).then(t.bind(null,346)),"v-e0d70ecc":()=>t.e(46).then(t.bind(null,347)),"v-2151a890":()=>t.e(48).then(t.bind(null,348)),"v-6e1e3488":()=>t.e(47).then(t.bind(null,349)),"v-ad4931e0":()=>t.e(50).then(t.bind(null,350)),"v-79f5d88c":()=>t.e(51).then(t.bind(null,351)),"v-4222367a":()=>t.e(52).then(t.bind(null,352)),"v-0cbb8c5a":()=>t.e(53).then(t.bind(null,353)),"v-68d9087a":()=>t.e(54).then(t.bind(null,354)),"v-2aed10ba":()=>t.e(55).then(t.bind(null,355)),"v-657f8880":()=>t.e(58).then(t.bind(null,356)),"v-d8e9780c":()=>t.e(56).then(t.bind(null,357)),"v-37cd1c0a":()=>t.e(57).then(t.bind(null,358)),"v-bf3acddc":()=>t.e(59).then(t.bind(null,359)),"v-401d6fcc":()=>t.e(60).then(t.bind(null,360)),"v-0d0949e4":()=>t.e(61).then(t.bind(null,361)),"v-598bd946":()=>t.e(62).then(t.bind(null,362)),"v-c8f0091c":()=>t.e(63).then(t.bind(null,363)),"v-6c1fe4b4":()=>t.e(64).then(t.bind(null,364)),"v-e8e2a6fc":()=>t.e(65).then(t.bind(null,365)),"v-a40710da":()=>t.e(66).then(t.bind(null,366)),"v-4d71a012":()=>t.e(67).then(t.bind(null,367)),"v-3798e78c":()=>t.e(68).then(t.bind(null,368)),"v-fc9b918c":()=>t.e(69).then(t.bind(null,369)),"v-2c88928c":()=>t.e(49).then(t.bind(null,370))};function as(e){const n=Object.create(null);return function(t){return n[t]||(n[t]=e(t))}}const is=/-(\w)/g,os=as(e=>e.replace(is,(e,n)=>n?n.toUpperCase():"")),rs=/\B([A-Z])/g,ss=as(e=>e.replace(rs,"-$1").toLowerCase()),ls=as(e=>e.charAt(0).toUpperCase()+e.slice(1));function ds(e,n){if(!n)return;if(e(n))return e(n);return n.includes("-")?e(ls(os(n))):e(ls(n))||e(ss(n))}const ms=Object.assign({},ns,ts),cs=e=>ms[e],us=e=>ts[e],hs=e=>ns[e],ys=e=>na.component(e);function ws(e){return ds(us,e)}function zs(e){return ds(hs,e)}function ps(e){return ds(cs,e)}function gs(e){return ds(ys,e)}function js(...e){return Promise.all(e.filter(e=>e).map(async e=>{if(!gs(e)&&ps(e)){const n=await ps(e)();na.component(e,n.default)}}))}function bs(e,n){"undefined"!=typeof window&&window.__VUEPRESS__&&(window.__VUEPRESS__[e]=n)}var fs=t(87),vs=t.n(fs),ks=t(88),xs=t.n(ks),qs={created(){if(this.siteMeta=this.$site.headTags.filter(([e])=>"meta"===e).map(([e,n])=>n),this.$ssrContext){const n=this.getMergedMetaTags();this.$ssrContext.title=this.$title,this.$ssrContext.lang=this.$lang,this.$ssrContext.pageMeta=(e=n)?e.map(e=>{let n="{n+=` ${t}="${xs()(e[t])}"`}),n+">"}).join("\n "):"",this.$ssrContext.canonicalLink=Ns(this.$canonicalUrl)}var e},mounted(){this.currentMetaTags=[...document.querySelectorAll("meta")],this.updateMeta(),this.updateCanonicalLink()},methods:{updateMeta(){document.title=this.$title,document.documentElement.lang=this.$lang;const e=this.getMergedMetaTags();this.currentMetaTags=Zs(e,this.currentMetaTags)},getMergedMetaTags(){const e=this.$page.frontmatter.meta||[];return vs()([{name:"description",content:this.$description}],e,this.siteMeta,Ms)},updateCanonicalLink(){_s(),this.$canonicalUrl&&document.head.insertAdjacentHTML("beforeend",Ns(this.$canonicalUrl))}},watch:{$page(){this.updateMeta(),this.updateCanonicalLink()}},beforeDestroy(){Zs(null,this.currentMetaTags),_s()}};function _s(){const e=document.querySelector("link[rel='canonical']");e&&e.remove()}function Ns(e=""){return e?``:""}function Zs(e,n){if(n&&[...n].filter(e=>e.parentNode===document.head).forEach(e=>document.head.removeChild(e)),e)return e.map(e=>{const n=document.createElement("meta");return Object.keys(e).forEach(t=>{n.setAttribute(t,e[t])}),document.head.appendChild(n),n})}function Ms(e){for(const n of["name","property","itemprop"])if(e.hasOwnProperty(n))return e[n]+n;return JSON.stringify(e)}var Is=t(89),Ts={mounted(){window.addEventListener("scroll",this.onScroll)},methods:{onScroll:t.n(Is)()((function(){this.setActiveHash()}),300),setActiveHash(){const e=[].slice.call(document.querySelectorAll(".sidebar-link")),n=[].slice.call(document.querySelectorAll(".header-anchor")).filter(n=>e.some(e=>e.hash===n.hash)),t=Math.max(window.pageYOffset,document.documentElement.scrollTop,document.body.scrollTop),a=Math.max(document.documentElement.scrollHeight,document.body.scrollHeight),i=window.innerHeight+t;for(let e=0;e=o.parentElement.offsetTop+10&&(!r||t{this.$nextTick(()=>{this.$vuepress.$set("disableScrollBehavior",!1)})})}}}},beforeDestroy(){window.removeEventListener("scroll",this.onScroll)}},Ys=t(22),As=t.n(Ys),Ws={mounted(){As.a.configure({showSpinner:!1}),this.$router.beforeEach((e,n,t)=>{e.path===n.path||na.component(e.name)||As.a.start(),t()}),this.$router.afterEach(()=>{As.a.done(),this.isSidebarOpen=!1})}},Os={props:{parent:Object,code:String,options:{align:String,color:String,backgroundTransition:Boolean,backgroundColor:String,successText:String,staticIcon:Boolean}},data:()=>({success:!1,originalBackground:null,originalTransition:null}),computed:{alignStyle(){let e={};return e[this.options.align]="7.5px",e},iconClass(){return this.options.staticIcon?"":"hover"}},mounted(){this.originalTransition=this.parent.style.transition,this.originalBackground=this.parent.style.background},beforeDestroy(){this.parent.style.transition=this.originalTransition,this.parent.style.background=this.originalBackground},methods:{hexToRgb(e){let n=/^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(e);return n?{r:parseInt(n[1],16),g:parseInt(n[2],16),b:parseInt(n[3],16)}:null},copyToClipboard(e){if(navigator.clipboard)navigator.clipboard.writeText(this.code).then(()=>{this.setSuccessTransitions()},()=>{});else{let e=document.createElement("textarea");document.body.appendChild(e),e.value=this.code,e.select(),document.execCommand("Copy"),e.remove(),this.setSuccessTransitions()}},setSuccessTransitions(){if(clearTimeout(this.successTimeout),this.options.backgroundTransition){this.parent.style.transition="background 350ms";let e=this.hexToRgb(this.options.backgroundColor);this.parent.style.background=`rgba(${e.r}, ${e.g}, ${e.b}, 0.1)`}this.success=!0,this.successTimeout=setTimeout(()=>{this.options.backgroundTransition&&(this.parent.style.background=this.originalBackground,this.parent.style.transition=this.originalTransition),this.success=!1},500)}}},Ds=(t(237),t(10)),Rs=Object(Ds.a)(Os,(function(){var e=this,n=e._self._c;return n("div",{staticClass:"code-copy"},[n("svg",{class:e.iconClass,style:e.alignStyle,attrs:{xmlns:"http://www.w3.org/2000/svg",width:"24",height:"24",viewBox:"0 0 24 24"},on:{click:e.copyToClipboard}},[n("path",{attrs:{fill:"none",d:"M0 0h24v24H0z"}}),e._v(" "),n("path",{attrs:{fill:e.options.color,d:"M16 1H4c-1.1 0-2 .9-2 2v14h2V3h12V1zm-1 4l6 6v10c0 1.1-.9 2-2 2H7.99C6.89 23 6 22.1 6 21l.01-14c0-1.1.89-2 1.99-2h7zm-1 7h5.5L14 6.5V12z"}})]),e._v(" "),n("span",{class:e.success?"success":"",style:e.alignStyle},[e._v("\n "+e._s(e.options.successText)+"\n ")])])}),[],!1,null,"49140617",null).exports,Us=(t(238),[qs,Ts,Ws,{updated(){this.update()},methods:{update(){setTimeout(()=>{document.querySelectorAll('div[class*="language-"] pre').forEach(e=>{if(e.classList.contains("code-copy-added"))return;let n=new(na.extend(Rs));n.options={align:"bottom",color:"#27b1ff",backgroundTransition:!0,backgroundColor:"#0075b8",successText:"Copied!",staticIcon:!1},n.code=e.innerText,n.parent=e,n.$mount(),e.classList.add("code-copy-added"),e.appendChild(n.$el)})},100)}}}]),Es={name:"GlobalLayout",computed:{layout(){const e=this.getLayout();return bs("layout",e),na.component(e)}},methods:{getLayout(){if(this.$page.path){const e=this.$page.frontmatter.layout;return e&&(this.$vuepress.getLayoutAsyncComponent(e)||this.$vuepress.getVueComponent(e))?e:"Layout"}return"NotFound"}}},Vs=Object(Ds.a)(Es,(function(){return(0,this._self._c)(this.layout,{tag:"component"})}),[],!1,null,null,null).exports;!function(e,n,t){switch(n){case"components":e[n]||(e[n]={}),Object.assign(e[n],t);break;case"mixins":e[n]||(e[n]=[]),e[n].push(...t);break;default:throw new Error("Unknown option name.")}}(Vs,"mixins",Us);const Gs=[{name:"v-c0a4944c",path:"/arns/",component:Vs,beforeEnter:(e,n,t)=>{js("Layout","v-c0a4944c").then(t)}},{path:"/arns/index.html",redirect:"/arns/"},{path:"/arns.html",redirect:"/arns/"},{name:"v-b8cb630c",path:"/community-resources.html",component:Vs,beforeEnter:(e,n,t)=>{js("Layout","v-b8cb630c").then(t)}},{name:"v-038b01fa",path:"/arweave/",component:Vs,beforeEnter:(e,n,t)=>{js("Layout","v-038b01fa").then(t)}},{path:"/arweave/index.html",redirect:"/arweave/"},{path:"/arweave.html",redirect:"/arweave/"},{name:"v-aaa9b6f4",path:"/manifests/",component:Vs,beforeEnter:(e,n,t)=>{js("Layout","v-aaa9b6f4").then(t)}},{path:"/manifests/index.html",redirect:"/manifests/"},{path:"/concepts/manifests.html",redirect:"/manifests/"},{name:"v-0a39d43a",path:"/concepts/sandboxing.html",component:Vs,beforeEnter:(e,n,t)=>{js("Layout","v-0a39d43a").then(t)}},{name:"v-d6cbe5b8",path:"/wayfinder/",component:Vs,beforeEnter:(e,n,t)=>{js("Layout","v-d6cbe5b8").then(t)}},{path:"/wayfinder/index.html",redirect:"/wayfinder/"},{path:"/concepts/wayfinder.html",redirect:"/wayfinder/"},{name:"v-c0082a28",path:"/contribute.html",component:Vs,beforeEnter:(e,n,t)=>{js("Layout","v-c0082a28").then(t)}},{name:"v-4c2c563a",path:"/guides/experimental/ao-ant/",component:Vs,beforeEnter:(e,n,t)=>{js("Layout","v-4c2c563a").then(t)}},{path:"/guides/experimental/ao-ant/index.html",redirect:"/guides/experimental/ao-ant/"},{path:"/experimental/ao-ant.html",redirect:"/guides/experimental/ao-ant/"},{name:"v-db3ac7ec",path:"/guides/experimental/ao-resolver/",component:Vs,beforeEnter:(e,n,t)=>{js("Layout","v-db3ac7ec").then(t)}},{path:"/guides/experimental/ao-resolver/index.html",redirect:"/guides/experimental/ao-resolver/"},{path:"/experimental/ao-resolver.html",redirect:"/guides/experimental/ao-resolver/"},{name:"v-ecd6cf40",path:"/foundation/",component:Vs,beforeEnter:(e,n,t)=>{js("Layout","v-ecd6cf40").then(t)}},{path:"/foundation/index.html",redirect:"/foundation/"},{path:"/foundation.html",redirect:"/foundation/"},{name:"v-90d4f50c",path:"/gateway-network/",component:Vs,beforeEnter:(e,n,t)=>{js("Layout","v-90d4f50c").then(t)}},{path:"/gateway-network/index.html",redirect:"/gateway-network/"},{path:"/gateway-network.html",redirect:"/gateway-network/"},{name:"v-9172688c",path:"/gateways/ar-io-node/advanced-config.html",component:Vs,beforeEnter:(e,n,t)=>{js("Layout","v-9172688c").then(t)}},{name:"v-48851acc",path:"/gateways/ar-io-node/admin/admin-api.html",component:Vs,beforeEnter:(e,n,t)=>{js("Layout","v-48851acc").then(t)}},{name:"v-172dfc5a",path:"/gateways/ar-io-node/api.html",component:Vs,beforeEnter:(e,n,t)=>{js("Layout","v-172dfc5a").then(t)}},{name:"v-d314c1cc",path:"/gateways/bundler/",component:Vs,beforeEnter:(e,n,t)=>{js("Layout","v-d314c1cc").then(t)}},{path:"/gateways/bundler/index.html",redirect:"/gateways/bundler/"},{path:"/gateways/ar-io-node/bundler.html",redirect:"/gateways/bundler/"},{name:"v-30ab1e90",path:"/gateways/ar-io-node/arnsoip/observer/",component:Vs,beforeEnter:(e,n,t)=>{js("Layout","v-30ab1e90").then(t)}},{path:"/gateways/ar-io-node/arnsoip/observer/index.html",redirect:"/gateways/ar-io-node/arnsoip/observer/"},{path:"/gateways/ar-io-node/arnsoip/observer.html",redirect:"/gateways/ar-io-node/arnsoip/observer/"},{name:"v-3f2c877a",path:"/gateways/delegated-staking/",component:Vs,beforeEnter:(e,n,t)=>{js("Layout","v-3f2c877a").then(t)}},{path:"/gateways/delegated-staking/index.html",redirect:"/gateways/delegated-staking/"},{path:"/gateways/ar-io-node/delegated-staking.html",redirect:"/gateways/delegated-staking/"},{name:"v-2fa5878c",path:"/gateways/ar-io-node/env.html",component:Vs,beforeEnter:(e,n,t)=>{js("Layout","v-2fa5878c").then(t)}},{name:"v-b292638c",path:"/experimental/frames/",component:Vs,beforeEnter:(e,n,t)=>{js("Layout","v-b292638c").then(t)}},{path:"/experimental/frames/index.html",redirect:"/experimental/frames/"},{path:"/gateways/ar-io-node/experimental/frames.html",redirect:"/experimental/frames/"},{name:"v-e0d70ecc",path:"/gateways/ar-io-node/linux-setup/",component:Vs,beforeEnter:(e,n,t)=>{js("Layout","v-e0d70ecc").then(t)}},{path:"/gateways/ar-io-node/linux-setup/index.html",redirect:"/gateways/ar-io-node/linux-setup/"},{path:"/gateways/ar-io-node/linux-setup.html",redirect:"/gateways/ar-io-node/linux-setup/"},{name:"v-2151a890",path:"/gateways/ar-io-node/observer-upgrade.html",component:Vs,beforeEnter:(e,n,t)=>{js("Layout","v-2151a890").then(t)}},{name:"v-6e1e3488",path:"/troubleshooting-observer/",component:Vs,beforeEnter:(e,n,t)=>{js("Layout","v-6e1e3488").then(t)}},{path:"/troubleshooting-observer/index.html",redirect:"/troubleshooting-observer/"},{path:"/gateways/ar-io-node/observer-troubleshooting.html",redirect:"/troubleshooting-observer/"},{name:"v-ad4931e0",path:"/gateways/ar-io-node/overview/",component:Vs,beforeEnter:(e,n,t)=>{js("Layout","v-ad4931e0").then(t)}},{path:"/gateways/ar-io-node/overview/index.html",redirect:"/gateways/ar-io-node/overview/"},{path:"/gateways/ar-io-node/overview.html",redirect:"/gateways/ar-io-node/overview/"},{name:"v-79f5d88c",path:"/gateways/ar-io-node/release-notes.html",component:Vs,beforeEnter:(e,n,t)=>{js("Layout","v-79f5d88c").then(t)}},{name:"v-4222367a",path:"/gateways/testnet/",component:Vs,beforeEnter:(e,n,t)=>{js("Layout","v-4222367a").then(t)}},{path:"/gateways/testnet/index.html",redirect:"/gateways/testnet/"},{path:"/gateways/ar-io-node/testnet.html",redirect:"/gateways/testnet/"},{name:"v-0cbb8c5a",path:"/troubleshooting/",component:Vs,beforeEnter:(e,n,t)=>{js("Layout","v-0cbb8c5a").then(t)}},{path:"/troubleshooting/index.html",redirect:"/troubleshooting/"},{path:"/gateways/ar-io-node/troubleshooting.html",redirect:"/troubleshooting/"},{name:"v-68d9087a",path:"/gateways/upgrade/",component:Vs,beforeEnter:(e,n,t)=>{js("Layout","v-68d9087a").then(t)}},{path:"/gateways/upgrade/index.html",redirect:"/gateways/upgrade/"},{path:"/gateways/ar-io-node/upgrading.html",redirect:"/gateways/upgrade/"},{name:"v-2aed10ba",path:"/gateways/ar-io-node/windows-setup/",component:Vs,beforeEnter:(e,n,t)=>{js("Layout","v-2aed10ba").then(t)}},{path:"/gateways/ar-io-node/windows-setup/index.html",redirect:"/gateways/ar-io-node/windows-setup/"},{path:"/gateways/ar-io-node/windows-setup.html",redirect:"/gateways/ar-io-node/windows-setup/"},{name:"v-657f8880",path:"/guides/arns/managing.html",component:Vs,beforeEnter:(e,n,t)=>{js("Layout","v-657f8880").then(t)}},{name:"v-d8e9780c",path:"/gateways/",component:Vs,beforeEnter:(e,n,t)=>{js("Layout","v-d8e9780c").then(t)}},{path:"/gateways/index.html",redirect:"/gateways/"},{path:"/gateways/gateways.html",redirect:"/gateways/"},{name:"v-37cd1c0a",path:"/glossary.html",component:Vs,beforeEnter:(e,n,t)=>{js("Layout","v-37cd1c0a").then(t)}},{name:"v-bf3acddc",path:"/guides/arns/overview.html",component:Vs,beforeEnter:(e,n,t)=>{js("Layout","v-bf3acddc").then(t)}},{name:"v-401d6fcc",path:"/guides/arns/registering.html",component:Vs,beforeEnter:(e,n,t)=>{js("Layout","v-401d6fcc").then(t)}},{name:"v-0d0949e4",path:"/guides/delegated-staking/",component:Vs,beforeEnter:(e,n,t)=>{js("Layout","v-0d0949e4").then(t)}},{path:"/guides/delegated-staking/index.html",redirect:"/guides/delegated-staking/"},{path:"/guides/delegated-staking.html",redirect:"/guides/delegated-staking/"},{name:"v-598bd946",path:"/guides/perma-deploy/",component:Vs,beforeEnter:(e,n,t)=>{js("Layout","v-598bd946").then(t)}},{path:"/guides/perma-deploy/index.html",redirect:"/guides/perma-deploy/"},{path:"/guides/github-flow.html",redirect:"/guides/perma-deploy/"},{name:"v-c8f0091c",path:"/guides/graphql/",component:Vs,beforeEnter:(e,n,t)=>{js("Layout","v-c8f0091c").then(t)}},{path:"/guides/graphql/index.html",redirect:"/guides/graphql/"},{path:"/guides/gql.html",redirect:"/guides/graphql/"},{name:"v-6c1fe4b4",path:"/guides/sdk-release-notes.html",component:Vs,beforeEnter:(e,n,t)=>{js("Layout","v-6c1fe4b4").then(t)}},{name:"v-e8e2a6fc",path:"/sdk/",component:Vs,beforeEnter:(e,n,t)=>{js("Layout","v-e8e2a6fc").then(t)}},{path:"/sdk/index.html",redirect:"/sdk/"},{path:"/guides/sdk.html",redirect:"/sdk/"},{name:"v-a40710da",path:"/",component:Vs,beforeEnter:(e,n,t)=>{js("Layout","v-a40710da").then(t)}},{path:"/index.html",redirect:"/"},{name:"v-4d71a012",path:"/introduction/",component:Vs,beforeEnter:(e,n,t)=>{js("Layout","v-4d71a012").then(t)}},{path:"/introduction/index.html",redirect:"/introduction/"},{path:"/introduction.html",redirect:"/introduction/"},{name:"v-3798e78c",path:"/labs/",component:Vs,beforeEnter:(e,n,t)=>{js("Layout","v-3798e78c").then(t)}},{path:"/labs/index.html",redirect:"/labs/"},{path:"/labs.html",redirect:"/labs/"},{name:"v-fc9b918c",path:"/token/",component:Vs,beforeEnter:(e,n,t)=>{js("Layout","v-fc9b918c").then(t)}},{path:"/token/index.html",redirect:"/token/"},{path:"/token.html",redirect:"/token/"},{name:"v-2c88928c",path:"/gateways/ar-io-node/operation.html",component:Vs,beforeEnter:(e,n,t)=>{js("Layout","v-2c88928c").then(t)}},{path:"*",component:Vs}],Fs={title:"ar.io Docs",description:"ar.io documentation",base:"/docs/",headTags:[["link",{rel:"icon",href:"/docs/images/logo.png"}],["meta",{property:"og:title",content:"ar.io Docs Portal"}],["meta",{name:"twitter:title",content:"ar.io Docs Portal"}],["meta",{property:"og:image",content:"https://res.cloudinary.com/dopbvlqgc/image/upload/v1706802732/ario_v2nv53.png"}],["meta",{name:"twitter:card",content:"summary_large_image"}],["meta",{name:"twitter:image",content:"https://res.cloudinary.com/dopbvlqgc/image/upload/v1706802732/ario_v2nv53.png"}],["meta",{name:"twitter:site",content:"@ar_io_network"}],["meta",{name:"theme-color",content:"#3eaf7c"}],["meta",{name:"apple-mobile-web-app-capable",content:"yes"}],["meta",{name:"apple-mobile-web-app-status-bar-style",content:"black"}],["script",{src:"https://plausible.io/js/script.js",defer:!0,"data-domain":"docs.ar.io"}],["link",{rel:"stylesheet",href:"https://fonts.googleapis.com/css2?family=Rubik:ital,wght@0,300;0,400;0,500;0,600;0,700;0,800;0,900;1,300;1,400;1,500;1,600;1,700;1,800;1,900&display=swap"}],["link",{rel:"stylesheet",href:"https://fonts.googleapis.com/css2?family=Dancing+Script:wght@400;500;600;700&display=swap"}]],pages:[{title:"Arweave Name System (ArNS)",frontmatter:{permalink:"/arns/"},regularPath:"/arns.html",relativePath:"arns.md",key:"v-c0a4944c",path:"/arns/",headers:[{level:2,title:"Overview",slug:"overview",normalizedTitle:"overview",charIndex:33},{level:2,title:"Name Registry",slug:"name-registry",normalizedTitle:"name registry",charIndex:2257},{level:3,title:"Name Validation Rules",slug:"name-validation-rules",normalizedTitle:"name validation rules",charIndex:4001},{level:2,title:"Arweave Name Token (ANT)",slug:"arweave-name-token-ant",normalizedTitle:"arweave name token (ant)",charIndex:1263},{level:3,title:"Under_Names",slug:"under-names",normalizedTitle:"under_names",charIndex:6568},{level:2,title:"Addressing Variable Market Conditions",slug:"addressing-variable-market-conditions",normalizedTitle:"addressing variable market conditions",charIndex:8254},{level:2,title:"Dynamic Pricing Model",slug:"dynamic-pricing-model",normalizedTitle:"dynamic pricing model",charIndex:9155},{level:3,title:"Pricing Scenarios",slug:"pricing-scenarios",normalizedTitle:"pricing scenarios",charIndex:10311},{level:3,title:"Dynamic Pricing Mechanics",slug:"dynamic-pricing-mechanics",normalizedTitle:"dynamic pricing mechanics",charIndex:10649},{level:3,title:"Step Pricing Mechanics",slug:"step-pricing-mechanics",normalizedTitle:"step pricing mechanics",charIndex:12539}],headersStr:"Overview Name Registry Name Validation Rules Arweave Name Token (ANT) Under_Names Addressing Variable Market Conditions Dynamic Pricing Model Pricing Scenarios Dynamic Pricing Mechanics Step Pricing Mechanics",content:"# Arweave Name System (ArNS)\n\n\n# Overview\n\nArweave URLs and Transaction IDs are long, difficult to remember, and occasionally miscategorized as spam. The Arweave Name System (ArNS) aims to resolve these problems in a decentralized manner. ArNS is a censorship-resistant naming system stored on Arweave, purchased with IO tokens, enabled through AR.IO gateway domains, and used to connect friendly domain names to permaweb dApps, web pages, data, and identities.\n\nIt's like an open, permissionless address book for anything on the permaweb, powered by the aoComputer.\n\nThis system works similarly to traditional DNS services, where users can purchase a name in a registry and DNS Name servers resolve these names to IP addresses. The system shall be flexible and allow users to purchase names permanently or lease them for a defined period based on their use case. With ArNS, the registry is decentralized, permanent, and stored on Arweave (through the aoComputer). This means that apps and infrastructure cannot just read the latest state of the registry but can also check any point in time in the past, creating a “Wayback Machine” of permanent data.\n\nUsers can register a name, like ardrive, within the ArNS Registry. Before owning a name, they must create an Arweave Name Token (ANT), an aoCOmputer process and open-source protocol used by ArNS to track the ownership and control over the name. ANTs allow the owner to set a pointer to any type of permaweb data, like a page, dApp or file, via its Arweave Transaction ID.\n\nEach AR.IO gateway acts as both a smart contract cache and an ArNS Name resolver. They will generate the latest state of both the ArNS Registry and its related ANTs and serve this information rapidly for apps and users. AR.IO gateways will also resolve that name as one of their own subdomains, e.g., https://ardrive.arweave.net and proxy all requests to the associated Arweave Transaction ID. This means that ANTs work across all AR.IO gateways that support them: https://ardrive.ar-io.dev, https://ardrive.g8way.io/, etc.\n\nUsers can easily reference these friendly names in their browsers, and other applications and infrastructure can build rich solutions on top of these ArNS primitives.\n\nArweave Name System Interactions\n\n\n# Name Registry\n\nThe ArNS Registry is a list of all the registered names and their associated ANT AO process Ids. Registering a name requires spending IO tokens based upon the name length and purchase type. The system shall allow users to either lease a name on a yearly basis (maximum up to 5 years) or purchase that name permanently.\n\nThe registry uses the following key rules, embedded within the AR.IO AO process:\n\n * The genesis prices of names are set within the contract itself; these are the starting conditions.\n * Name prices vary based on name length, purchase type (lease vs buy), lease duration, and the current Demand Factor. See the Dynamic Pricing section for more details.\n * Name records in the registry each include a pointer to its Arweave Name Token Smart Contract process address, its lease end time, and undername allocation.\n * Anyone with available IO Tokens can extend any name’s active lease.\n * Anyone with available IO Tokens can purchase undername space for any name.\n * When a lease expires, there is a grace period where it can still be extended before anyone else can repurchase the name with a new ANT.\n\nOnce added, name records cannot be removed from the registry. A leased name’s associated ANT smart contract address cannot be changed until the lease has expired and a new one is purchased. Care must be taken by the owners of permanent name purchases to ensure that their ANT supports an evolve ability should it be desired to add or modify functionality in the future as these name purchases are permanently tied to the associated ANT. Owners of permanently purchased names must understand the consequences of private key loss, which results in not being able to update any data pointers for this name.\n\n\n# Name Validation Rules\n\nAll names registered shall meet the following criteria:\n\n 1. Valid names include only numbers 0-9, characters a-z and dashes.\n 2. Dashes cannot be leading or trailing characters.\n 3. Dashes cannot be used in single character domains.\n 4. 1 character minimum, 51 characters maximum.\n 5. Shall not be an invalid name predesignated to prevent unintentional use/abuse such as www.\n\n\n# Arweave Name Token (ANT)\n\nTo establish ownership of a record in the ArNS Registry, each record contains both a friendly name and a reference to an Arweave Name Token, ANT. Name Tokens are unique aoComputer process tokens that give their owners the ability to update the Arweave Transaction IDs that their associated friendly names point to.\n\nThe ANT process is a standardized contract that contains the specific ArNS Record specification required by AR.IO gateways who resolve ArNS names and their Arweave Transaction IDs. It also contains other basic functionality to establish ownership and the ability to transfer ownership and update the Arweave Transaction ID.\n\nName Tokens have an owner, who can transfer the token and control all of its modifiable settings. These settings include modifying the time to live (ttl) for each name contained in the ANT, and other settings like the ANT Name, Ticker, and an ANT Controller. The controller can only manage the ANT and set and update records, name, and the ticker, but cannot transfer the ANT. Note that ANTs are initially created by an end user, in accordance with network standards, who then has to ability to transfer its ownership or assign a controller as they see fit.\n\nSecondary markets could be created by ecosystem partners that facilitate the trade of Name Tokens. Additionally, tertiary markets could be created that support the leasing of these friendly names to other users. Such markets, if any, would be created by third parties unrelated to and outside of the scope of this paper or control of the Foundation.\n\nThe table below indicates some of the possible interactions with an ANT and who can perform them:\n\nANT INTERACTIONS\nTYPE ANT OWNER ANT CONTROLLER ANY IO TOKEN HOLDER\nTransfer ANT ✔ \nAdd / remove controllers ✔ \nSet records (pointers) ✔ ✔ \nUpdate records, name, ticker ✔ ✔ \nExtend / renew lease ✔ ✔ ✔\nIncrease undernames ✔ ✔ ✔\n\nANT Interactions\n\n\n# Under_Names\n\nANT owners and controllers can configure multiple subdomains for their registered ArNS name known as “under_names” or more easily written “undernames”. These undernames are assigned individually at the time of registration or can be added on to any registered name at any time.\n\nUndernames use an underscore “_” in place of a more typically used dot “.“ to separate the subdomain from the main ArNS domain.\n\nThis means users can trust dapp_ardrive just like you would trust ardrive since the owner of ardrive is the only one who can configure dapp_ardrive.\n\nSome other features that undernames allow include:\n\n * Undernames are configured in the ANT that is referenced for a given name. ANT owners can add more undernames as subDomains in the ANT’s records object, each of which can point to a different Arweave Transaction ID.\n * Each registered name is provided with an allocation of 10 undernames by default. Additional undername space can be purchased individually and as needed.\n * Other users could never register a name that resembles an undername on ardrive since “_” is not allowed to be registered in the ArNS registry.\n * Another user can register dapp-ardrive but this is a separate ArNS domain altogether. In traditional DNS, it’s like the difference in trusting dapp-ardrive.io(suspicious!) over the legitimate dapp.ardrive.io\n * Undernames can go multiple levels deep, like version_dapp_ardrive but must not be longer than the total MAX_NAME_LENGTH of an ArNS name. The total amount of characters for a name string consisting of undernames and underscore separators is 63 characters.\n\nUndernames give more versatility and utility to owning an ArNS name.\n\n\n# Addressing Variable Market Conditions\n\nThe future market landscape is unpredictable, and the AR.IO Network smart contract is designed to be immutable, operating without governance or mechanisms for manual intervention. In addition, the traditional method of employing a pricing oracle to fix prices relative to a stable currency is not viable due to the infancy of the network as well as the inherent reliance on outside dependencies. Considering this, ArNS is designed to be self-contained and adaptive, ensuring that name prices always mirror network activity and market conditions.\n\nTo achieve this, ArNS incorporates a dynamic pricing model that utilizes a “Demand Factor” to adjust fees in line with ArNS purchase activity.\n\nArNS is designed to ensure that name valuations are always in sync with their true market worth, despite the unchangeable nature of the smart contract it operates on.\n\n\n# Dynamic Pricing Model\n\nThe Arweave Name System (ArNS) introduces an adaptive pricing model for registering names within the AR.IO Network. The core objective is to strike a balance between market demand and pricing fairness, leveraging both static and dynamic pricing elements. The system differentiates prices based on character lengths of names and offers varied purchasing options such as leasing, permanent acquisition, and undernames.\n\nA unique feature of the ArNS pricing mechanism is the integration of a Demand Factor (DF), a dynamic multiplier that adjusts name prices in response to market demand. The DF is determined by comparing the total revenue in IO tokens from the current period to a moving average of revenues from the preceding period window. Depending on whether revenue is above, below, or equal to this average, the DF can increase or decrease. These adjustments are contained within boundaries to prevent extreme pricing variations.\n\nThis comprehensive approach ensures that ArNS names are accessible and reasonably priced, adapting to market trends while maintaining an equitable and maintenance-free registration environment.\n\n\n# Pricing Scenarios\n\nThere are several pricing models for leasing and purchasing names:\n\n * Leased Name: Allows a user to lease a name for a certain duration and have it available for use immediately by the lessee.\n\n * Permanent Name: Allows a user to purchase a name permanently and have it available for use immediately by the owner.\n\n\n# Dynamic Pricing Mechanics\n\nNames are initially priced according to the Genesis Registration Fee (GRF), as set in the AR.IO smart contract, with prices varying based on the length of the name. As the network's activity progresses, these fees give way to Base Registration Fees (BRF), which are modified by periodic step adjustments. The Demand Factor (DF) is a crucial component that dynamically scales prices, fluctuating with the network’s revenue trends.\n\nRevenue in the network accumulates within the Protocol Balance through various streams, such as instant name leases or purchases, lease extensions, and under_name transactions. This cumulative revenue impacts the Demand Factor, which in turn influences the current name prices.\n\nThe DF is adjusted by comparing the recent period’s revenue against a Revenue Moving Average (RMA) from the preceding seven periods. Based on this comparison, the DF can either increase, to reflect greater demand, or decrease, in response to diminished revenue, all within predetermined limits to prevent drastic fluctuations in pricing\n\nThe pricing system articulates various fees:\n\n * The Adjusted Registration Fee (ARF) is the BRF modified by the DF.\n\n * The Annual Fee is set as a proportion of the ARF.\n\n * Instant Lease Registration and Permabuy prices are derived from the ARF, adding the calculated annual fees over the desired years.\n\nThe DF’s modifications are controlled by the network's recent performance against the RMA. An increase in revenue leads to a DF rise, signifying a thriving market demand, while a decrease indicates the opposite. This responsive adjustment mechanism ensures that the pricing model remains aligned with actual market activity.\n\nUnder_names are bundled with name registrations with additional ones available for purchase. The cost for extra under_names is a percentage of the current BRF, altered by the DF.\n\n\n# Step Pricing Mechanics\n\nThe dynamic model shall utilize a “Step Pricing” concept that acts as a stabilizing mechanism to counteract swift and dramatic market shifts, ensuring registration costs remain aligned and predictable. Step pricing adjusts the Base Registration Fees when the Demand Factor reaches its minimum value for an extended period, updating the BRF to align with the current ARF, and resetting the DF to a neutral value. This allows for base prices to lower in extended droughts of low demand or high token value resulting in lower revenue generated to the protocol balance.\n\nThe below chart represents Step Pricing in action:\n\nStep Pricing Action - Declining Demand",normalizedContent:"# arweave name system (arns)\n\n\n# overview\n\narweave urls and transaction ids are long, difficult to remember, and occasionally miscategorized as spam. the arweave name system (arns) aims to resolve these problems in a decentralized manner. arns is a censorship-resistant naming system stored on arweave, purchased with io tokens, enabled through ar.io gateway domains, and used to connect friendly domain names to permaweb dapps, web pages, data, and identities.\n\nit's like an open, permissionless address book for anything on the permaweb, powered by the aocomputer.\n\nthis system works similarly to traditional dns services, where users can purchase a name in a registry and dns name servers resolve these names to ip addresses. the system shall be flexible and allow users to purchase names permanently or lease them for a defined period based on their use case. with arns, the registry is decentralized, permanent, and stored on arweave (through the aocomputer). this means that apps and infrastructure cannot just read the latest state of the registry but can also check any point in time in the past, creating a “wayback machine” of permanent data.\n\nusers can register a name, like ardrive, within the arns registry. before owning a name, they must create an arweave name token (ant), an aocomputer process and open-source protocol used by arns to track the ownership and control over the name. ants allow the owner to set a pointer to any type of permaweb data, like a page, dapp or file, via its arweave transaction id.\n\neach ar.io gateway acts as both a smart contract cache and an arns name resolver. they will generate the latest state of both the arns registry and its related ants and serve this information rapidly for apps and users. ar.io gateways will also resolve that name as one of their own subdomains, e.g., https://ardrive.arweave.net and proxy all requests to the associated arweave transaction id. this means that ants work across all ar.io gateways that support them: https://ardrive.ar-io.dev, https://ardrive.g8way.io/, etc.\n\nusers can easily reference these friendly names in their browsers, and other applications and infrastructure can build rich solutions on top of these arns primitives.\n\narweave name system interactions\n\n\n# name registry\n\nthe arns registry is a list of all the registered names and their associated ant ao process ids. registering a name requires spending io tokens based upon the name length and purchase type. the system shall allow users to either lease a name on a yearly basis (maximum up to 5 years) or purchase that name permanently.\n\nthe registry uses the following key rules, embedded within the ar.io ao process:\n\n * the genesis prices of names are set within the contract itself; these are the starting conditions.\n * name prices vary based on name length, purchase type (lease vs buy), lease duration, and the current demand factor. see the dynamic pricing section for more details.\n * name records in the registry each include a pointer to its arweave name token smart contract process address, its lease end time, and undername allocation.\n * anyone with available io tokens can extend any name’s active lease.\n * anyone with available io tokens can purchase undername space for any name.\n * when a lease expires, there is a grace period where it can still be extended before anyone else can repurchase the name with a new ant.\n\nonce added, name records cannot be removed from the registry. a leased name’s associated ant smart contract address cannot be changed until the lease has expired and a new one is purchased. care must be taken by the owners of permanent name purchases to ensure that their ant supports an evolve ability should it be desired to add or modify functionality in the future as these name purchases are permanently tied to the associated ant. owners of permanently purchased names must understand the consequences of private key loss, which results in not being able to update any data pointers for this name.\n\n\n# name validation rules\n\nall names registered shall meet the following criteria:\n\n 1. valid names include only numbers 0-9, characters a-z and dashes.\n 2. dashes cannot be leading or trailing characters.\n 3. dashes cannot be used in single character domains.\n 4. 1 character minimum, 51 characters maximum.\n 5. shall not be an invalid name predesignated to prevent unintentional use/abuse such as www.\n\n\n# arweave name token (ant)\n\nto establish ownership of a record in the arns registry, each record contains both a friendly name and a reference to an arweave name token, ant. name tokens are unique aocomputer process tokens that give their owners the ability to update the arweave transaction ids that their associated friendly names point to.\n\nthe ant process is a standardized contract that contains the specific arns record specification required by ar.io gateways who resolve arns names and their arweave transaction ids. it also contains other basic functionality to establish ownership and the ability to transfer ownership and update the arweave transaction id.\n\nname tokens have an owner, who can transfer the token and control all of its modifiable settings. these settings include modifying the time to live (ttl) for each name contained in the ant, and other settings like the ant name, ticker, and an ant controller. the controller can only manage the ant and set and update records, name, and the ticker, but cannot transfer the ant. note that ants are initially created by an end user, in accordance with network standards, who then has to ability to transfer its ownership or assign a controller as they see fit.\n\nsecondary markets could be created by ecosystem partners that facilitate the trade of name tokens. additionally, tertiary markets could be created that support the leasing of these friendly names to other users. such markets, if any, would be created by third parties unrelated to and outside of the scope of this paper or control of the foundation.\n\nthe table below indicates some of the possible interactions with an ant and who can perform them:\n\nant interactions\ntype ant owner ant controller any io token holder\ntransfer ant ✔ \nadd / remove controllers ✔ \nset records (pointers) ✔ ✔ \nupdate records, name, ticker ✔ ✔ \nextend / renew lease ✔ ✔ ✔\nincrease undernames ✔ ✔ ✔\n\nant interactions\n\n\n# under_names\n\nant owners and controllers can configure multiple subdomains for their registered arns name known as “under_names” or more easily written “undernames”. these undernames are assigned individually at the time of registration or can be added on to any registered name at any time.\n\nundernames use an underscore “_” in place of a more typically used dot “.“ to separate the subdomain from the main arns domain.\n\nthis means users can trust dapp_ardrive just like you would trust ardrive since the owner of ardrive is the only one who can configure dapp_ardrive.\n\nsome other features that undernames allow include:\n\n * undernames are configured in the ant that is referenced for a given name. ant owners can add more undernames as subdomains in the ant’s records object, each of which can point to a different arweave transaction id.\n * each registered name is provided with an allocation of 10 undernames by default. additional undername space can be purchased individually and as needed.\n * other users could never register a name that resembles an undername on ardrive since “_” is not allowed to be registered in the arns registry.\n * another user can register dapp-ardrive but this is a separate arns domain altogether. in traditional dns, it’s like the difference in trusting dapp-ardrive.io(suspicious!) over the legitimate dapp.ardrive.io\n * undernames can go multiple levels deep, like version_dapp_ardrive but must not be longer than the total max_name_length of an arns name. the total amount of characters for a name string consisting of undernames and underscore separators is 63 characters.\n\nundernames give more versatility and utility to owning an arns name.\n\n\n# addressing variable market conditions\n\nthe future market landscape is unpredictable, and the ar.io network smart contract is designed to be immutable, operating without governance or mechanisms for manual intervention. in addition, the traditional method of employing a pricing oracle to fix prices relative to a stable currency is not viable due to the infancy of the network as well as the inherent reliance on outside dependencies. considering this, arns is designed to be self-contained and adaptive, ensuring that name prices always mirror network activity and market conditions.\n\nto achieve this, arns incorporates a dynamic pricing model that utilizes a “demand factor” to adjust fees in line with arns purchase activity.\n\narns is designed to ensure that name valuations are always in sync with their true market worth, despite the unchangeable nature of the smart contract it operates on.\n\n\n# dynamic pricing model\n\nthe arweave name system (arns) introduces an adaptive pricing model for registering names within the ar.io network. the core objective is to strike a balance between market demand and pricing fairness, leveraging both static and dynamic pricing elements. the system differentiates prices based on character lengths of names and offers varied purchasing options such as leasing, permanent acquisition, and undernames.\n\na unique feature of the arns pricing mechanism is the integration of a demand factor (df), a dynamic multiplier that adjusts name prices in response to market demand. the df is determined by comparing the total revenue in io tokens from the current period to a moving average of revenues from the preceding period window. depending on whether revenue is above, below, or equal to this average, the df can increase or decrease. these adjustments are contained within boundaries to prevent extreme pricing variations.\n\nthis comprehensive approach ensures that arns names are accessible and reasonably priced, adapting to market trends while maintaining an equitable and maintenance-free registration environment.\n\n\n# pricing scenarios\n\nthere are several pricing models for leasing and purchasing names:\n\n * leased name: allows a user to lease a name for a certain duration and have it available for use immediately by the lessee.\n\n * permanent name: allows a user to purchase a name permanently and have it available for use immediately by the owner.\n\n\n# dynamic pricing mechanics\n\nnames are initially priced according to the genesis registration fee (grf), as set in the ar.io smart contract, with prices varying based on the length of the name. as the network's activity progresses, these fees give way to base registration fees (brf), which are modified by periodic step adjustments. the demand factor (df) is a crucial component that dynamically scales prices, fluctuating with the network’s revenue trends.\n\nrevenue in the network accumulates within the protocol balance through various streams, such as instant name leases or purchases, lease extensions, and under_name transactions. this cumulative revenue impacts the demand factor, which in turn influences the current name prices.\n\nthe df is adjusted by comparing the recent period’s revenue against a revenue moving average (rma) from the preceding seven periods. based on this comparison, the df can either increase, to reflect greater demand, or decrease, in response to diminished revenue, all within predetermined limits to prevent drastic fluctuations in pricing\n\nthe pricing system articulates various fees:\n\n * the adjusted registration fee (arf) is the brf modified by the df.\n\n * the annual fee is set as a proportion of the arf.\n\n * instant lease registration and permabuy prices are derived from the arf, adding the calculated annual fees over the desired years.\n\nthe df’s modifications are controlled by the network's recent performance against the rma. an increase in revenue leads to a df rise, signifying a thriving market demand, while a decrease indicates the opposite. this responsive adjustment mechanism ensures that the pricing model remains aligned with actual market activity.\n\nunder_names are bundled with name registrations with additional ones available for purchase. the cost for extra under_names is a percentage of the current brf, altered by the df.\n\n\n# step pricing mechanics\n\nthe dynamic model shall utilize a “step pricing” concept that acts as a stabilizing mechanism to counteract swift and dramatic market shifts, ensuring registration costs remain aligned and predictable. step pricing adjusts the base registration fees when the demand factor reaches its minimum value for an extended period, updating the brf to align with the current arf, and resetting the df to a neutral value. this allows for base prices to lower in extended droughts of low demand or high token value resulting in lower revenue generated to the protocol balance.\n\nthe below chart represents step pricing in action:\n\nstep pricing action - declining demand",charsets:{}},{title:"Community Resources",frontmatter:{prev:!1,next:!1},regularPath:"/community-resources.html",relativePath:"community-resources.md",key:"v-b8cb630c",path:"/community-resources.html",headersStr:null,content:"# Community Resources\n\nar.io Github\n\nar.io Twitter\n\nar.io Discord\n\nContact Us Directly",normalizedContent:"# community resources\n\nar.io github\n\nar.io twitter\n\nar.io discord\n\ncontact us directly",charsets:{}},{title:"Arweave",frontmatter:{permalink:"/arweave/"},regularPath:"/arweave.html",relativePath:"arweave.md",key:"v-038b01fa",path:"/arweave/",headers:[{level:2,title:"The Permanence Pie",slug:"the-permanence-pie",normalizedTitle:"the permanence pie",charIndex:14},{level:2,title:"What Is Arweave",slug:"what-is-arweave",normalizedTitle:"what is arweave",charIndex:1451},{level:2,title:"Gateways",slug:"gateways",normalizedTitle:"gateways",charIndex:3775},{level:2,title:"aoComputer",slug:"aocomputer",normalizedTitle:"aocomputer",charIndex:5703},{level:2,title:"The Permaweb",slug:"the-permaweb",normalizedTitle:"the permaweb",charIndex:6659},{level:2,title:"References and Further Reading",slug:"references-and-further-reading",normalizedTitle:"references and further reading",charIndex:7195}],headersStr:"The Permanence Pie What Is Arweave Gateways aoComputer The Permaweb References and Further Reading",content:'# Arweave\n\n\n# The Permanence Pie\n\nThe permanent data storage ecosystem can be thought of as a three-tiered arrangement of protocols, services, and applications – dubbed here as “The Permanence Pie”.\n\nDiagram 1: The Shell of Permanence Pie\n\nThe base layer of that pie is the Arweave protocol and network, which is the backbone of the permanent data storage ecosystem. It provides the infrastructure for data to be stored on the network in a decentralized manner and incentivizes nodes to keep the data stored for long periods of time.\n\nThe second layer is made up of services that sit on top of the Arweave protocol and network. These services include gateways, data retrieval services, and computation that help to provide a seamless and functional experience for users, creators, and developers.\n\nFinally, the top layer of the pie consists of applications that utilize the data stored on the Arweave network. This includes everything from simple applications that allow users to access and view their data to complex, decentralized applications that use the Arweave network as their backbone.\n\nEach layer of the Permanence Pie is crucial to the overall success and growth of the permanent data storage ecosystem. The Arweave protocol and network provide the foundation for data storage, the services layer helps to facilitate data retrieval and usage, and the application layer brings the benefits of the ecosystem to users and developers alike.\n\n\n# What Is Arweave\n\nArweave is a decentralized Layer 1 data storage protocol optimized for long-term permanent storage through its unique proof of access mechanism and tokenomic endowment model. It can be thought of as a global, permissionless hard drive.\n\nThe information stored on Arweave is immutable and globally replicated by miner nodes. Instead of a traditional blockchain ledger which links blocks of transactions together in linear sequence, Arweave arranges blocks in a web known as the blockweave. These miner nodes secure the blockweave by operating the Succinct Proof of Random Access (SPoRA) algorithm. SPoRA requires miners to prove that they have access to recall randomly selected bits of weave data in order to produce and share a block. If successful, miners are rewarded in Arweave’s native AR token. These token rewards are derived from transaction fees as well as the network’s storage endowment. The endowment is a protocol-controlled pool of tokens designed to fund the projected cost of storage for 200+ years.\n\nDiagram 2: Arweave - The Base Storage Layer\n\nArweave is file type agnostic – any type of file ranging from simple text files to family photos to complex web applications and archival databases can be stored on the network. To upload data, users must pay an amount of AR proportional to the size of the files being uploaded. Arweave is unique when compared with other decentralized storage solutions in that users only pay once to upload their files, then that is it – the files will be stored in perpetuity without any additional upkeep or subscription fees paid by the user.\n\nThe Arweave protocol is designed to handle 1,000 base layer transactions per block with new blocks being mined roughly every two minutes. Each transaction may also store an unbounded number of signed, non-AR-transacting data items assembled into a bundle (i.e., a bundled data item). Since its launch in 2018, this scalable architecture has allowed the network\'s weave size (total data stored on the network) to grow to 140.8 TB with approximately 1.5 billion base layer transactions and bundled data items submitted from over 181k unique wallets. The Arweave protocol endowment has received 60.7k AR to cover the projected storage costs with a cost of storage 0.858 AR/GiB. *\n\n* data as of November 20, 2023\n\n\n# Gateways\n\nGateways act as the front door to the permaweb. They are infrastructure utilities that sit above the base storage layer and allow users to write, access, and query the information stored on Arweave. Gateways are specialized nodes responsible for data ingest (data "in") and data egress (data "out").\n\nFor access / egress, gateways allow for data retrieval, caching, and serving as well as indexing transactions into a database that can be easily queried at scale. With bundling functionality, gateways can act as services allowing users to write and seed new data the Arweave network.\n\nThese "in and out" functions are not performed by the Arweave mining nodes which are optimized for securing the Layer 1 blockweave and replicating information throughout the network through a mechanism known as Wildfire.\n\nDiagram 3: Gateways - The Ingest and Access Component\n\nBy taking on these responsibilities, gateways allow low cost and maintenance free hosting of static and dynamic content for users, creators, and developers. But there are costs associated with operating a gateway and Arweave does not offer any tokenomic incentives to offset these expenses. As the permaweb grows, these costs can become very significant.\n\nArweave.net, the primary community gateway, has scaled to meet the needs of the entire Arweave ecosystem and stored the entire weave. Over the last 6 months, this gateway indexed and cached approximately 3.4 million base layer transactions and bundled data items per day, served 233 million requests for data and node information per day, and responded to 3.2 million GQL queries per day. *\n\nGateway use cases, and the types of administrators who operate them, can range from at-home projects hosted by hobbyists to larger decentralized platforms and dApps run by small teams, all the way up to scaled out environments capable of supporting enterprise offerings.\n\n* data as of November 20, 2023\n\n\n# aoComputer\n\nAO is a global supercomputer built on Arweave. This actor-oriented machine is a single, unified computing environment, hosted on a heterogenous set of nodes in a distributed network. AO is designed to offer an environment in which an arbitrary number of parallel processes can be resident, coordinating through an open message passing layer. This message passing standard connects the machine\'s independently operating processes together into a \'web\' -- in the same way that websites operate on independent servers but are conjoined into a cohesive, unified experience via hyperlinks.\n\nDiagram 4: AO - The Supercomputer and Smart Contract Protocol\n\nWith AO, developers can create processes that act as smart contracts with token-like properties which can then be used to incorporate incentive structures into applications and infrastructure. The AR.IO Network leverages this technology for development of its network protocol and IO token.\n\n\n# The Permaweb\n\nThe permaweb is the third and final layer of the permanence pie. The permaweb stands for the permanent web, a collection of all the webpages, apps, and files stored on top of the Arweave network and enlivened with the functionality of the AR.IO Network. For users and builders, the permaweb offers low-cost, zero maintenance, permanent hosting of their web apps, files, and web pages.\n\nDiagram 5: The Permanence Pie\n\nAR.IO is a global network, protocol, and currency built on top of Arweave that enables the permaweb.\n\n\n# References and Further Reading\n\nThe following resources were used as reference material for this section and can provide the interested reader with additional information:\n\n * The ArWiki\n\n * Arweave GitHub repository\n\n * aoComputer',normalizedContent:'# arweave\n\n\n# the permanence pie\n\nthe permanent data storage ecosystem can be thought of as a three-tiered arrangement of protocols, services, and applications – dubbed here as “the permanence pie”.\n\ndiagram 1: the shell of permanence pie\n\nthe base layer of that pie is the arweave protocol and network, which is the backbone of the permanent data storage ecosystem. it provides the infrastructure for data to be stored on the network in a decentralized manner and incentivizes nodes to keep the data stored for long periods of time.\n\nthe second layer is made up of services that sit on top of the arweave protocol and network. these services include gateways, data retrieval services, and computation that help to provide a seamless and functional experience for users, creators, and developers.\n\nfinally, the top layer of the pie consists of applications that utilize the data stored on the arweave network. this includes everything from simple applications that allow users to access and view their data to complex, decentralized applications that use the arweave network as their backbone.\n\neach layer of the permanence pie is crucial to the overall success and growth of the permanent data storage ecosystem. the arweave protocol and network provide the foundation for data storage, the services layer helps to facilitate data retrieval and usage, and the application layer brings the benefits of the ecosystem to users and developers alike.\n\n\n# what is arweave\n\narweave is a decentralized layer 1 data storage protocol optimized for long-term permanent storage through its unique proof of access mechanism and tokenomic endowment model. it can be thought of as a global, permissionless hard drive.\n\nthe information stored on arweave is immutable and globally replicated by miner nodes. instead of a traditional blockchain ledger which links blocks of transactions together in linear sequence, arweave arranges blocks in a web known as the blockweave. these miner nodes secure the blockweave by operating the succinct proof of random access (spora) algorithm. spora requires miners to prove that they have access to recall randomly selected bits of weave data in order to produce and share a block. if successful, miners are rewarded in arweave’s native ar token. these token rewards are derived from transaction fees as well as the network’s storage endowment. the endowment is a protocol-controlled pool of tokens designed to fund the projected cost of storage for 200+ years.\n\ndiagram 2: arweave - the base storage layer\n\narweave is file type agnostic – any type of file ranging from simple text files to family photos to complex web applications and archival databases can be stored on the network. to upload data, users must pay an amount of ar proportional to the size of the files being uploaded. arweave is unique when compared with other decentralized storage solutions in that users only pay once to upload their files, then that is it – the files will be stored in perpetuity without any additional upkeep or subscription fees paid by the user.\n\nthe arweave protocol is designed to handle 1,000 base layer transactions per block with new blocks being mined roughly every two minutes. each transaction may also store an unbounded number of signed, non-ar-transacting data items assembled into a bundle (i.e., a bundled data item). since its launch in 2018, this scalable architecture has allowed the network\'s weave size (total data stored on the network) to grow to 140.8 tb with approximately 1.5 billion base layer transactions and bundled data items submitted from over 181k unique wallets. the arweave protocol endowment has received 60.7k ar to cover the projected storage costs with a cost of storage 0.858 ar/gib. *\n\n* data as of november 20, 2023\n\n\n# gateways\n\ngateways act as the front door to the permaweb. they are infrastructure utilities that sit above the base storage layer and allow users to write, access, and query the information stored on arweave. gateways are specialized nodes responsible for data ingest (data "in") and data egress (data "out").\n\nfor access / egress, gateways allow for data retrieval, caching, and serving as well as indexing transactions into a database that can be easily queried at scale. with bundling functionality, gateways can act as services allowing users to write and seed new data the arweave network.\n\nthese "in and out" functions are not performed by the arweave mining nodes which are optimized for securing the layer 1 blockweave and replicating information throughout the network through a mechanism known as wildfire.\n\ndiagram 3: gateways - the ingest and access component\n\nby taking on these responsibilities, gateways allow low cost and maintenance free hosting of static and dynamic content for users, creators, and developers. but there are costs associated with operating a gateway and arweave does not offer any tokenomic incentives to offset these expenses. as the permaweb grows, these costs can become very significant.\n\narweave.net, the primary community gateway, has scaled to meet the needs of the entire arweave ecosystem and stored the entire weave. over the last 6 months, this gateway indexed and cached approximately 3.4 million base layer transactions and bundled data items per day, served 233 million requests for data and node information per day, and responded to 3.2 million gql queries per day. *\n\ngateway use cases, and the types of administrators who operate them, can range from at-home projects hosted by hobbyists to larger decentralized platforms and dapps run by small teams, all the way up to scaled out environments capable of supporting enterprise offerings.\n\n* data as of november 20, 2023\n\n\n# aocomputer\n\nao is a global supercomputer built on arweave. this actor-oriented machine is a single, unified computing environment, hosted on a heterogenous set of nodes in a distributed network. ao is designed to offer an environment in which an arbitrary number of parallel processes can be resident, coordinating through an open message passing layer. this message passing standard connects the machine\'s independently operating processes together into a \'web\' -- in the same way that websites operate on independent servers but are conjoined into a cohesive, unified experience via hyperlinks.\n\ndiagram 4: ao - the supercomputer and smart contract protocol\n\nwith ao, developers can create processes that act as smart contracts with token-like properties which can then be used to incorporate incentive structures into applications and infrastructure. the ar.io network leverages this technology for development of its network protocol and io token.\n\n\n# the permaweb\n\nthe permaweb is the third and final layer of the permanence pie. the permaweb stands for the permanent web, a collection of all the webpages, apps, and files stored on top of the arweave network and enlivened with the functionality of the ar.io network. for users and builders, the permaweb offers low-cost, zero maintenance, permanent hosting of their web apps, files, and web pages.\n\ndiagram 5: the permanence pie\n\nar.io is a global network, protocol, and currency built on top of arweave that enables the permaweb.\n\n\n# references and further reading\n\nthe following resources were used as reference material for this section and can provide the interested reader with additional information:\n\n * the arwiki\n\n * arweave github repository\n\n * aocomputer',charsets:{}},{title:"Manifests",frontmatter:{permalink:"/manifests",sidebarDepth:3},regularPath:"/concepts/manifests.html",relativePath:"concepts/manifests.md",key:"v-aaa9b6f4",path:"/manifests/",headers:[{level:2,title:"Overview",slug:"overview",normalizedTitle:"overview",charIndex:16},{level:2,title:"What is a Manifest",slug:"what-is-a-manifest",normalizedTitle:"what is a manifest",charIndex:2339},{level:3,title:"Sample Manifest",slug:"sample-manifest",normalizedTitle:"sample manifest",charIndex:2731},{level:3,title:"How it Works",slug:"how-it-works",normalizedTitle:"how it works",charIndex:3566},{level:3,title:"Example Usage",slug:"example-usage",normalizedTitle:"example usage",charIndex:3832},{level:2,title:"Specifications",slug:"specifications",normalizedTitle:"specifications",charIndex:4872},{level:3,title:"Transaction Tags",slug:"transaction-tags",normalizedTitle:"transaction tags",charIndex:4891},{level:3,title:"Transaction Data",slug:"transaction-data",normalizedTitle:"transaction data",charIndex:5605}],headersStr:"Overview What is a Manifest Sample Manifest How it Works Example Usage Specifications Transaction Tags Transaction Data",content:'# Manifests\n\n\n# Overview\n\nar.io Gateways support friendly-path-name routing for data on Arweave via Manifests. This greatly improves the programmability of data relationships. Consider an illustrative example where data stored on Arweave and accessed like this:\n\nhttp:///cG7Hdi_iTQPoEYgQJFqJ8NMpN4KoZ-vH_j7pG4iP7NI (txID of a website\'s index.html)\nhttp:///3zFsd7bkCAUtXUKBQ4XiPiQvpLVKfZ6kiLNt2XVSfoV (txID of its js/style.css)\nhttp:///or0_fRYFcQYWh-QsozygI5Zoamw_fUsYu2w8_X1RkYZ (txID of its assets/img/logo.png)\n\n\ncan instead be accessed like this:\n\nhttp:/// (resolves to the txID of index.html)\nhttp:////js/style.css\nhttp:////assets/img/logo.png\n\n\nNFT collections also benefit from manifest-based routing:\n\nhttp:////0.png\nhttp:////1.png\nhttp:////2.png\n... and so on.\n\n\nar.io gateways are capable of resolving manifest paths in a relative manner. An HTML page loading assets from Arweave would be very difficult to develop, maintain, and harden against hosting domains leaving existence if assets had to be linked to by a fully qualified domain name and an Arweave data item ID as the path. For example:\n\n\n\n\nManifests allow HTML pages to use relative paths to assets with friendly names so that the document is easy to read, maintain, and host across any ar.io domain. For example:\n\n\n\n\nRelative routing eliminates the need for every link to contain the full Arweave transaction ID and fully qualified domain name. This makes the HTML more readable and ensures that links remain valid even if the hosting domain changes. If index.html needed to access js/style.css, the relative link ./js/style.css could be used instead of /js/style.css. This relative routing is incredibly useful for linking together files in a way that allows functional websites to be hosted entirely on Arweave.\n\nLearn more about relative path routing and structuring files into a permanently hosted website in ArDrive\'s decentralized app guide\n\n\n# What is a Manifest\n\nManifests, also known as "Path Manifests" or "Arweave Manifests," are JSON objects that connect various Arweave data items and define relational paths for easy navigation. A common use case for manifests is permanently hosting websites on Arweave by linking all necessary files together. An ar.io gateway can then resolve the manifest into a fully functional website.\n\n\n# Sample Manifest\n\n{\n "manifest": "arweave/paths",\n "version": "0.2.0",\n "index": {\n "path": "index.html"\n },\n "fallback": {\n "id": "iXo3LSfVKVtXUKBzfZ4d7bkCAp6kiLNt2XVUFsPiQvQ"\n },\n "paths": {\n "index.html": {\n "id": "cG7Hdi_iTQPoEYgQJFqJ8NMpN4KoZ-vH_j7pG4iP7NI"\n },\n "404.html": {\n "id": "iXo3LSfVKVtXUKBzfZ4d7bkCAp6kiLNt2XVUFsPiQvQ"\n },\n "js/style.css": {\n "id": "3zFsd7bkCAUtXUKBQ4XiPiQvpLVKfZ6kiLNt2XVSfoV"\n },\n "css/style.css": {\n "id": "sPiQvpAUXLVK3zF6iXSfo7bkCVQkiLNt24dVtXUKBfZ"\n },\n "css/mobile.css": {\n "id": "fZ4d7bkCAUiXSfo3zFsPiQvpLVKVtXUKB6kiLNt2XVQ"\n },\n "assets/img/logo.png": {\n "id": "or0_fRYFcQYWh-QsozygI5Zoamw_fUsYu2w8_X1RkYZ"\n },\n "assets/img/icon.png": {\n "id": "0543SMRGYuGKTaqLzmpOyK4AxAB96Fra2guHzYxjRGo"\n }\n }\n}\n\n\n\n# How it Works\n\nA resolver, typically an ar.io gateway, resolves URLs requesting content based on a manifest transaction ID to the corresponding path key in the paths object. The URL schema for this type of request is https:////.\n\n\n# Example Usage\n\nAssume the manifest above is uploaded to Arweave with the transaction ID UyC5P5qKPZaltMmmZAWdakhlDXsBF6qmyrbWYFchRTk. The below table shows https requests to the ar.io gateway arweave.dev requesting various endpoints on the manifest transaction Id, the manifest path where the gateway will find the data to return, and the resulting Arweave txId.\n\nREQUEST PATH MANIFEST PATH DATA SERVED FROM TXID\nhttps://arweave.dev/UyC5P5qKPZaltMmmZAWdakhlDXsBF6qmyrbWYFchRTk index cG7Hdi_iTQPoEYgQJFqJ8NMpN4KoZ-vH_j7pG4iP7NI\nhttps://arweave.dev/UyC5P5qKPZaltMmmZAWdakhlDXsBF6qmyrbWYFchRTk/index.html index.html cG7Hdi_iTQPoEYgQJFqJ8NMpN4KoZ-vH_j7pG4iP7NI\nhttps://arweave.dev/UyC5P5qKPZaltMmmZAWdakhlDXsBF6qmyrbWYFchRTk/js/style.css js/style.css 3zFsd7bkCAUtXUKBQ4XiPiQvpLVKfZ6kiLNt2XVSfoV\nhttps://arweave.dev/UyC5P5qKPZaltMmmZAWdakhlDXsBF6qmyrbWYFchRTk/foobar fallback iXo3LSfVKVtXUKBzfZ4d7bkCAp6kiLNt2XVUFsPiQvQ\n\n\n# Specifications\n\n\n# Transaction Tags\n\nManifest are uploaded to Arweave in the same manner as any other data item. A specific content type tag must be added while uploading so that resolvers like the ar.io gateways can recognize a manifest and properly resolve the paths. Tags must be attached to the manifest at the time of upload. They cannot be added later without uploading a new manifest, and they must be attached to the upload transaction, NOT placed inside the json object.\n\nFailure to provide this tag will result in resolvers not recognizing the manifest, so they will only return the raw json instead of the linked data items.\n\n# Content-Type\n\n{ "name": "Content-Type", "value": "application/x.arweave-manifest+json" }\n\n\n\n# Transaction Data\n\nBeing a json object, there are several attributes that make up the structure of a manifest. The json object must be fully defined and uploaded to Arweave as a data item.\n\n# manifest\n\n"manifest": "arweave/paths"\n\n\nThe manifest attribute serves as an additional validation layer. It must have the value arweave/paths in order for a gateway to resolve the manifest.\n\n# version\n\n"version": "0.2.0"\n\n\nThe version attribute defines the version of manifest schema a manifest is using.\n\n# index\n\n"index": {\n "id": "cG7Hdi_iTQPoEYgQJFqJ8NMpN4KoZ-vH_j7pG4iP7NI"\n }\n\n\nor\n\n"index": {\n "path": "index.html",\n }\n\n\nThe index attribute is an object that defines the base, or \'starting\' data item. It is similar to the / endpoint on a website. When resolving the manifest with no additional path definition, this is the data item that will be returned.\n\nindex accepts either path or id as sub attributes. path represents the key of a defined path in the manifest, while id represents a specific Arweave data item transaction Id.\n\nIf both path and id are defined in index, id will override path.\n\n# fallback\n\n"fallback": {\n "id": "iXo3LSfVKVtXUKBzfZ4d7bkCAp6kiLNt2XVUFsPiQvQ"\n }\n\n\nThe fallback attribute is an object that defines an Arweave data item transaction Id for the resolver to fall back to if it fails to correctly resolve a requested path. For example, it can act as a 404 page if a user requests manifest/non-existent-page\n\nfallback accepts id as a sub attribute, representing an Arweave data item transaction Id.\n\n# paths\n\n"paths": {\n "index.html": {\n "id": "cG7Hdi_iTQPoEYgQJFqJ8NMpN4KoZ-vH_j7pG4iP7NI"\n },\n "404.html": {\n "id": "iXo3LSfVKVtXUKBzfZ4d7bkCAp6kiLNt2XVUFsPiQvQ"\n },\n "js/style.css": {\n "id": "3zFsd7bkCAUtXUKBQ4XiPiQvpLVKfZ6kiLNt2XVSfoV"\n },\n "css/style.css": {\n "id": "sPiQvpAUXLVK3zF6iXSfo7bkCVQkiLNt24dVtXUKBfZ"\n },\n "css/mobile.css": {\n "id": "fZ4d7bkCAUiXSfo3zFsPiQvpLVKVtXUKB6kiLNt2XVQ"\n },\n "assets/img/logo.png": {\n "id": "or0_fRYFcQYWh-QsozygI5Zoamw_fUsYu2w8_X1RkYZ"\n },\n "assets/img/icon.png": {\n "id": "0543SMRGYuGKTaqLzmpOyK4AxAB96Fra2guHzYxjRGo"\n }\n }\n\n\nThe paths attribute is an object that defines the url paths that a manifest can resolve to. If a user navigates to manifest/index.html the resolver will look for index.html as a key in the paths object and return the corresponding id. (cG7Hdi_iTQPoEYgQJFqJ8NMpN4KoZ-vH_j7pG4iP7NI)',normalizedContent:'# manifests\n\n\n# overview\n\nar.io gateways support friendly-path-name routing for data on arweave via manifests. this greatly improves the programmability of data relationships. consider an illustrative example where data stored on arweave and accessed like this:\n\nhttp:///cg7hdi_itqpoeygqjfqj8nmpn4koz-vh_j7pg4ip7ni (txid of a website\'s index.html)\nhttp:///3zfsd7bkcautxukbq4xipiqvplvkfz6kilnt2xvsfov (txid of its js/style.css)\nhttp:///or0_fryfcqywh-qsozygi5zoamw_fusyu2w8_x1rkyz (txid of its assets/img/logo.png)\n\n\ncan instead be accessed like this:\n\nhttp:/// (resolves to the txid of index.html)\nhttp:////js/style.css\nhttp:////assets/img/logo.png\n\n\nnft collections also benefit from manifest-based routing:\n\nhttp:////0.png\nhttp:////1.png\nhttp:////2.png\n... and so on.\n\n\nar.io gateways are capable of resolving manifest paths in a relative manner. an html page loading assets from arweave would be very difficult to develop, maintain, and harden against hosting domains leaving existence if assets had to be linked to by a fully qualified domain name and an arweave data item id as the path. for example:\n\n\n\n\nmanifests allow html pages to use relative paths to assets with friendly names so that the document is easy to read, maintain, and host across any ar.io domain. for example:\n\n\n\n\nrelative routing eliminates the need for every link to contain the full arweave transaction id and fully qualified domain name. this makes the html more readable and ensures that links remain valid even if the hosting domain changes. if index.html needed to access js/style.css, the relative link ./js/style.css could be used instead of /js/style.css. this relative routing is incredibly useful for linking together files in a way that allows functional websites to be hosted entirely on arweave.\n\nlearn more about relative path routing and structuring files into a permanently hosted website in ardrive\'s decentralized app guide\n\n\n# what is a manifest\n\nmanifests, also known as "path manifests" or "arweave manifests," are json objects that connect various arweave data items and define relational paths for easy navigation. a common use case for manifests is permanently hosting websites on arweave by linking all necessary files together. an ar.io gateway can then resolve the manifest into a fully functional website.\n\n\n# sample manifest\n\n{\n "manifest": "arweave/paths",\n "version": "0.2.0",\n "index": {\n "path": "index.html"\n },\n "fallback": {\n "id": "ixo3lsfvkvtxukbzfz4d7bkcap6kilnt2xvufspiqvq"\n },\n "paths": {\n "index.html": {\n "id": "cg7hdi_itqpoeygqjfqj8nmpn4koz-vh_j7pg4ip7ni"\n },\n "404.html": {\n "id": "ixo3lsfvkvtxukbzfz4d7bkcap6kilnt2xvufspiqvq"\n },\n "js/style.css": {\n "id": "3zfsd7bkcautxukbq4xipiqvplvkfz6kilnt2xvsfov"\n },\n "css/style.css": {\n "id": "spiqvpauxlvk3zf6ixsfo7bkcvqkilnt24dvtxukbfz"\n },\n "css/mobile.css": {\n "id": "fz4d7bkcauixsfo3zfspiqvplvkvtxukb6kilnt2xvq"\n },\n "assets/img/logo.png": {\n "id": "or0_fryfcqywh-qsozygi5zoamw_fusyu2w8_x1rkyz"\n },\n "assets/img/icon.png": {\n "id": "0543smrgyugktaqlzmpoyk4axab96fra2guhzyxjrgo"\n }\n }\n}\n\n\n\n# how it works\n\na resolver, typically an ar.io gateway, resolves urls requesting content based on a manifest transaction id to the corresponding path key in the paths object. the url schema for this type of request is https:////.\n\n\n# example usage\n\nassume the manifest above is uploaded to arweave with the transaction id uyc5p5qkpzaltmmmzawdakhldxsbf6qmyrbwyfchrtk. the below table shows https requests to the ar.io gateway arweave.dev requesting various endpoints on the manifest transaction id, the manifest path where the gateway will find the data to return, and the resulting arweave txid.\n\nrequest path manifest path data served from txid\nhttps://arweave.dev/uyc5p5qkpzaltmmmzawdakhldxsbf6qmyrbwyfchrtk index cg7hdi_itqpoeygqjfqj8nmpn4koz-vh_j7pg4ip7ni\nhttps://arweave.dev/uyc5p5qkpzaltmmmzawdakhldxsbf6qmyrbwyfchrtk/index.html index.html cg7hdi_itqpoeygqjfqj8nmpn4koz-vh_j7pg4ip7ni\nhttps://arweave.dev/uyc5p5qkpzaltmmmzawdakhldxsbf6qmyrbwyfchrtk/js/style.css js/style.css 3zfsd7bkcautxukbq4xipiqvplvkfz6kilnt2xvsfov\nhttps://arweave.dev/uyc5p5qkpzaltmmmzawdakhldxsbf6qmyrbwyfchrtk/foobar fallback ixo3lsfvkvtxukbzfz4d7bkcap6kilnt2xvufspiqvq\n\n\n# specifications\n\n\n# transaction tags\n\nmanifest are uploaded to arweave in the same manner as any other data item. a specific content type tag must be added while uploading so that resolvers like the ar.io gateways can recognize a manifest and properly resolve the paths. tags must be attached to the manifest at the time of upload. they cannot be added later without uploading a new manifest, and they must be attached to the upload transaction, not placed inside the json object.\n\nfailure to provide this tag will result in resolvers not recognizing the manifest, so they will only return the raw json instead of the linked data items.\n\n# content-type\n\n{ "name": "content-type", "value": "application/x.arweave-manifest+json" }\n\n\n\n# transaction data\n\nbeing a json object, there are several attributes that make up the structure of a manifest. the json object must be fully defined and uploaded to arweave as a data item.\n\n# manifest\n\n"manifest": "arweave/paths"\n\n\nthe manifest attribute serves as an additional validation layer. it must have the value arweave/paths in order for a gateway to resolve the manifest.\n\n# version\n\n"version": "0.2.0"\n\n\nthe version attribute defines the version of manifest schema a manifest is using.\n\n# index\n\n"index": {\n "id": "cg7hdi_itqpoeygqjfqj8nmpn4koz-vh_j7pg4ip7ni"\n }\n\n\nor\n\n"index": {\n "path": "index.html",\n }\n\n\nthe index attribute is an object that defines the base, or \'starting\' data item. it is similar to the / endpoint on a website. when resolving the manifest with no additional path definition, this is the data item that will be returned.\n\nindex accepts either path or id as sub attributes. path represents the key of a defined path in the manifest, while id represents a specific arweave data item transaction id.\n\nif both path and id are defined in index, id will override path.\n\n# fallback\n\n"fallback": {\n "id": "ixo3lsfvkvtxukbzfz4d7bkcap6kilnt2xvufspiqvq"\n }\n\n\nthe fallback attribute is an object that defines an arweave data item transaction id for the resolver to fall back to if it fails to correctly resolve a requested path. for example, it can act as a 404 page if a user requests manifest/non-existent-page\n\nfallback accepts id as a sub attribute, representing an arweave data item transaction id.\n\n# paths\n\n"paths": {\n "index.html": {\n "id": "cg7hdi_itqpoeygqjfqj8nmpn4koz-vh_j7pg4ip7ni"\n },\n "404.html": {\n "id": "ixo3lsfvkvtxukbzfz4d7bkcap6kilnt2xvufspiqvq"\n },\n "js/style.css": {\n "id": "3zfsd7bkcautxukbq4xipiqvplvkfz6kilnt2xvsfov"\n },\n "css/style.css": {\n "id": "spiqvpauxlvk3zf6ixsfo7bkcvqkilnt24dvtxukbfz"\n },\n "css/mobile.css": {\n "id": "fz4d7bkcauixsfo3zfspiqvplvkvtxukb6kilnt2xvq"\n },\n "assets/img/logo.png": {\n "id": "or0_fryfcqywh-qsozygi5zoamw_fusyu2w8_x1rkyz"\n },\n "assets/img/icon.png": {\n "id": "0543smrgyugktaqlzmpoyk4axab96fra2guhzyxjrgo"\n }\n }\n\n\nthe paths attribute is an object that defines the url paths that a manifest can resolve to. if a user navigates to manifest/index.html the resolver will look for index.html as a key in the paths object and return the corresponding id. (cg7hdi_itqpoeygqjfqj8nmpn4koz-vh_j7pg4ip7ni)',charsets:{}},{title:"Browser Sandboxing",frontmatter:{next:!1},regularPath:"/concepts/sandboxing.html",relativePath:"concepts/sandboxing.md",key:"v-0a39d43a",path:"/concepts/sandboxing.html",headers:[{level:2,title:"Overview",slug:"overview",normalizedTitle:"overview",charIndex:25},{level:2,title:"TLS and its Role in Browser Sandboxing",slug:"tls-and-its-role-in-browser-sandboxing",normalizedTitle:"tls and its role in browser sandboxing",charIndex:1362},{level:2,title:"Deriving Sandbox Value",slug:"deriving-sandbox-value",normalizedTitle:"deriving sandbox value",charIndex:3477}],headersStr:"Overview TLS and its Role in Browser Sandboxing Deriving Sandbox Value",content:"# Browser Sandboxing\n\n\n# Overview\n\nBrowser sandboxing allows data requests to a gateway node to benefit from the security advantages of using a browser's same-origin policy by redirecting the requests to a pseudo-unique subdomain of the gateway's apex domain. For example, an attempt to access https://arweave.net/gnWKBqFXMJrrksEWrXLQRUQQQeFhv4uVxesHBcT8i6o would redirect to https://qj2yubvbk4yjv24syelk24wqivcbaqpbmg7yxfof5mdqlrh4rova.arweave.net/gnWKBqFXMJrrksEWrXLQRUQQQeFhv4uVxesHBcT8i6o\n\nTwo DNS records are required to link a domain to an Arweave transaction on a gateway node. For example, www.mycustomsite.com would need the following records to link it to www.arweave-gateway.net:\n\n * A DNS CNAME record pointing to an Arweave gateway: www CNAME arweave-gateway.net,\n * A DNS TXT record linking the domain with a specific transaction ID: arweavetx TXT kTv4OkVtmc0NAsqIcnHfudKjykJeQ83qXXrxf8hrh0S\n\nWhen a browser requests www.mycustomsite.com the user's machine will (through the usual DNS processes) resolve this to the IP address for the gateway node arweave-gateway.net. When the gateway receives an HTTP request with a non-default hostname, e.g. www.mycustomsite.com instead of www.arweave-gateway.net, the gateway will query the DNS records for www.mycustomsite.com and the 'arweavetx' TXT record will tell the node which transaction to serve.\n\n\n# TLS and its Role in Browser Sandboxing\n\nTransport Layer Security (TLS) is a cryptographic protocol designed to provide communications security over a computer network. In the context of Arweave applications and browser sandboxing, TLS plays a critical role in ensuring secure data transmission and enabling the effective use of browser security features.\n\nWhen Arweave applications are accessed without TLS, most browsers restrict the use of native cryptographic functions. These functions, which include hashing, signing, and verification, are essential for the secure operation of Arweave permaweb apps. Without TLS, not only are these functions unavailable, but the applications also become susceptible to various security threats, notably man-in-the-middle (MITM) attacks. Although Arweave transactions are signed, making direct MITM attacks challenging, the absence of encryption can expose other vulnerabilities. For instance, attackers could intercept and alter the /price endpoint, potentially causing transaction failures or leading to overcharging.\n\nTo address these concerns, gateway operators are responsible for generating and maintaining TLS certificates for their gateways. This can be achieved through various systems, such as ACME for Let's Encrypt. An important step in setting up a gateway is obtaining a wildcard TLS certificate for the gateway's domain. This certificate secures traffic on both the apex domain and its single-level subdomains (e.g., gateway.com and subdomain.gateway.com).\n\nThe integration of TLS is crucial for the implementation of browser sandboxing. When a browser requests a transaction from a gateway, the gateway issues a 301 redirect to a subdomain of the gateway, using a Base32 pseudo-unique address derived from the transaction ID. This redirection, secured by TLS, invokes the browser's same-origin policy. As a result, the requested web page is confined within a secure sandbox environment, isolated from other domains. This isolation is vital for maintaining the integrity and security of transactions and interactions within Arweave's permaweb applications.\n\n\n# Deriving Sandbox Value\n\nar.io nodes generate browser sandbox values deterministically. Because of this, it is possible to calculate ahead of time what that value will be for a particular transaction id.\n\nSandbox values are a Base32 encoding of the transaction ID. ar.io gateways use the following code snippet to accomplish the encoding:\n\nconst expectedTxSandbox = (id: string): string => {\n return toB32(fromB64Url(id));\n};\n\n\nExample:\n\nconst id = 'gnWKBqFXMJrrksEWrXLQRUQQQeFhv4uVxesHBcT8i6o';\nconst expectedTxSandbox = (id): string => {\n return toB32(fromB64Url(id));\n};\nconsole.log(expectedTxSandbox);\n\n\nExample Output:\n\nqj2yubvbk4yjv24syelk24wqivcbaqpbmg7yxfof5mdqlrh4rova\n\n\nView the full code for generating browser sandbox values here.",normalizedContent:"# browser sandboxing\n\n\n# overview\n\nbrowser sandboxing allows data requests to a gateway node to benefit from the security advantages of using a browser's same-origin policy by redirecting the requests to a pseudo-unique subdomain of the gateway's apex domain. for example, an attempt to access https://arweave.net/gnwkbqfxmjrrksewrxlqruqqqefhv4uvxeshbct8i6o would redirect to https://qj2yubvbk4yjv24syelk24wqivcbaqpbmg7yxfof5mdqlrh4rova.arweave.net/gnwkbqfxmjrrksewrxlqruqqqefhv4uvxeshbct8i6o\n\ntwo dns records are required to link a domain to an arweave transaction on a gateway node. for example, www.mycustomsite.com would need the following records to link it to www.arweave-gateway.net:\n\n * a dns cname record pointing to an arweave gateway: www cname arweave-gateway.net,\n * a dns txt record linking the domain with a specific transaction id: arweavetx txt ktv4okvtmc0nasqicnhfudkjykjeq83qxxrxf8hrh0s\n\nwhen a browser requests www.mycustomsite.com the user's machine will (through the usual dns processes) resolve this to the ip address for the gateway node arweave-gateway.net. when the gateway receives an http request with a non-default hostname, e.g. www.mycustomsite.com instead of www.arweave-gateway.net, the gateway will query the dns records for www.mycustomsite.com and the 'arweavetx' txt record will tell the node which transaction to serve.\n\n\n# tls and its role in browser sandboxing\n\ntransport layer security (tls) is a cryptographic protocol designed to provide communications security over a computer network. in the context of arweave applications and browser sandboxing, tls plays a critical role in ensuring secure data transmission and enabling the effective use of browser security features.\n\nwhen arweave applications are accessed without tls, most browsers restrict the use of native cryptographic functions. these functions, which include hashing, signing, and verification, are essential for the secure operation of arweave permaweb apps. without tls, not only are these functions unavailable, but the applications also become susceptible to various security threats, notably man-in-the-middle (mitm) attacks. although arweave transactions are signed, making direct mitm attacks challenging, the absence of encryption can expose other vulnerabilities. for instance, attackers could intercept and alter the /price endpoint, potentially causing transaction failures or leading to overcharging.\n\nto address these concerns, gateway operators are responsible for generating and maintaining tls certificates for their gateways. this can be achieved through various systems, such as acme for let's encrypt. an important step in setting up a gateway is obtaining a wildcard tls certificate for the gateway's domain. this certificate secures traffic on both the apex domain and its single-level subdomains (e.g., gateway.com and subdomain.gateway.com).\n\nthe integration of tls is crucial for the implementation of browser sandboxing. when a browser requests a transaction from a gateway, the gateway issues a 301 redirect to a subdomain of the gateway, using a base32 pseudo-unique address derived from the transaction id. this redirection, secured by tls, invokes the browser's same-origin policy. as a result, the requested web page is confined within a secure sandbox environment, isolated from other domains. this isolation is vital for maintaining the integrity and security of transactions and interactions within arweave's permaweb applications.\n\n\n# deriving sandbox value\n\nar.io nodes generate browser sandbox values deterministically. because of this, it is possible to calculate ahead of time what that value will be for a particular transaction id.\n\nsandbox values are a base32 encoding of the transaction id. ar.io gateways use the following code snippet to accomplish the encoding:\n\nconst expectedtxsandbox = (id: string): string => {\n return tob32(fromb64url(id));\n};\n\n\nexample:\n\nconst id = 'gnwkbqfxmjrrksewrxlqruqqqefhv4uvxeshbct8i6o';\nconst expectedtxsandbox = (id): string => {\n return tob32(fromb64url(id));\n};\nconsole.log(expectedtxsandbox);\n\n\nexample output:\n\nqj2yubvbk4yjv24syelk24wqivcbaqpbmg7yxfof5mdqlrh4rova\n\n\nview the full code for generating browser sandbox values here.",charsets:{}},{title:"Wayfinder Protocol",frontmatter:{permalink:"/wayfinder",prev:!1},regularPath:"/concepts/wayfinder.html",relativePath:"concepts/wayfinder.md",key:"v-d6cbe5b8",path:"/wayfinder/",headers:[{level:2,title:"Overview",slug:"overview",normalizedTitle:"overview",charIndex:25},{level:2,title:"Browser Integration",slug:"browser-integration",normalizedTitle:"browser integration",charIndex:613},{level:2,title:"Internal Application Integration",slug:"internal-application-integration",normalizedTitle:"internal application integration",charIndex:1081},{level:2,title:"Benefits of Wayfinder Over Hardcoded Gateway Links",slug:"benefits-of-wayfinder-over-hardcoded-gateway-links",normalizedTitle:"benefits of wayfinder over hardcoded gateway links",charIndex:2032},{level:2,title:"Use Cases",slug:"use-cases",normalizedTitle:"use cases",charIndex:2851},{level:3,title:"Decentralized Web Hosting with Flexible Access",slug:"decentralized-web-hosting-with-flexible-access",normalizedTitle:"decentralized web hosting with flexible access",charIndex:2865},{level:3,title:"Digital Archives and Preservation with Enhanced Sharing",slug:"digital-archives-and-preservation-with-enhanced-sharing",normalizedTitle:"digital archives and preservation with enhanced sharing",charIndex:3247},{level:3,title:"Media Sharing Platforms with Consistent Content Delivery",slug:"media-sharing-platforms-with-consistent-content-delivery",normalizedTitle:"media sharing platforms with consistent content delivery",charIndex:3693},{level:3,title:"Decentralized Applications (DApps) with Reliable Front-End Accessibility",slug:"decentralized-applications-dapps-with-reliable-front-end-accessibility",normalizedTitle:"decentralized applications (dapps) with reliable front-end accessibility",charIndex:4092},{level:2,title:"How it Works",slug:"how-it-works",normalizedTitle:"how it works",charIndex:4496},{level:3,title:"Transaction ID",slug:"transaction-id",normalizedTitle:"transaction id",charIndex:1168},{level:3,title:"ArNS",slug:"arns",normalizedTitle:"arns",charIndex:4836},{level:2,title:"Wayfinder App",slug:"wayfinder-app",normalizedTitle:"wayfinder app",charIndex:5200},{level:3,title:"v0.0.10",slug:"v0-0-10",normalizedTitle:"v0.0.10",charIndex:5318},{level:3,title:"Key Features",slug:"key-features",normalizedTitle:"key features",charIndex:6615},{level:3,title:"Use Cases",slug:"use-cases-2",normalizedTitle:"use cases",charIndex:2851}],headersStr:"Overview Browser Integration Internal Application Integration Benefits of Wayfinder Over Hardcoded Gateway Links Use Cases Decentralized Web Hosting with Flexible Access Digital Archives and Preservation with Enhanced Sharing Media Sharing Platforms with Consistent Content Delivery Decentralized Applications (DApps) with Reliable Front-End Accessibility How it Works Transaction ID ArNS Wayfinder App v0.0.10 Key Features Use Cases",content:"# Wayfinder Protocol\n\n\n# Overview\n\nThe Wayfinder protocol is a URI scheme designed to translate requests for Arweave content into https:// requests. Essentially, Wayfinder allows for transforming traditional Arweave URLs like https://arweave.net/long-txid into more concise and user-friendly forms such as ar://txid or ar://arns-name. When combined with the AR.IO WayFinder browser extension, the request can be directed to any number of functional AR.IO Gateways to serve the content.\n\nAn early technical breakdown of Wayfinder, formerly \"ARCSS\", created by Arweave community member DMac, can be found here.\n\n\n# Browser Integration\n\nThe Wayfinder Protocol is currently facilitated via the WayFinder App or internal application integration. The intention is to lead popular web browsers like Chrome and Brave towards a direct integration of the Wayfinder Protocol, similar to recent integrations of the ipfs:// protocol. Such integration would remove the need for a client-side extension and boost developers' confidence in embedding Wayfinder Protocol URLs in their websites.\n\n\n# Internal Application Integration\n\nCertain websites or apps may want to resolve Arweave Transaction ID's (TxId) internally. In these scenarios, they can process the Wayfinder Protocol internally without depending on browser support or the WayFinder App. A prime example is opensea.io. Opensea, an NFT marketplace, frequently imports NFT metadata from external sources. If metadata employs the Wayfinder Protocol, Opensea internally resolves these, presenting content without redirecting users through an https:// link.\n\nThere are two main approaches to resolving Wayfinder Protocol URLs:\n\n 1. Convert Wayfinder into a request directed at a predefined Arweave gateway.\n 2. Retrieve a list of active AR.IO Gateways from the GAR by reading the contract state, or other available resources, and then fetch content from a gateway on the list.\n\nEach strategy has its benefits and challenges, necessitating careful evaluation based on specific use cases.\n\n\n# Benefits of Wayfinder Over Hardcoded Gateway Links\n\nUsing the Wayfinder Protocol offers several advantages over hardcoded links to a specific gateway:\n\n 1. Flexibility: Wayfinder links can be routed through any available AR.IO Gateway, ensuring content remains accessible even if a specific gateway is down or congested.\n 2. Decentralization: By not being tied to a single gateway, the Wayfinder Protocol embodies the decentralized spirit of the web, reducing potential censorship points.\n 3. Ease of Maintenance: Developers and content creators don't need to modify links if a gateway changes its URL or becomes unavailable. The WayFinder extension handles routing to an active gateway.\n 4. Consistency: Users always receive the same content, regardless of the gateway used, ensuring a consistent user experience.\n\n\n# Use Cases\n\n\n# Decentralized Web Hosting with Flexible Access\n\nWith Wayfinder, not only can websites be hosted on the Arweave network, but their accessibility is also enhanced. By using the Wayfinder Protocol, web developers can ensure that if a specific AR.IO Gateway is down, the content can still be accessed through another gateway, offering a more reliable and resilient user experience.\n\n\n# Digital Archives and Preservation with Enhanced Sharing\n\nDigitally archiving public domain works, especially in light of events like \"banned books week\", becomes more efficient with Wayfinder. Historical institutions or enthusiasts can easily share specific Wayfinder links to documents or media. Unlike hardcoded links which might break if a specific gateway goes offline, Wayfinder ensures that the content remains consistently accessible.\n\n\n# Media Sharing Platforms with Consistent Content Delivery\n\nFor platforms hosting user-generated content, the Wayfinder Protocol provides not just decentralized hosting but also a guarantee of content delivery. Even if a content piece becomes viral and one gateway gets congested, Wayfinder ensures that users can still access the content through another gateway, providing a seamless experience.\n\n\n# Decentralized Applications (DApps) with Reliable Front-End Accessibility\n\nDApps, while benefiting from Arweave's permanent hosting, can further ensure their front-end remains consistently accessible to users by using Wayfinder. If a DApp's front-end is accessed frequently, causing strain on one gateway, Wayfinder can help ensure the load is distributed, and the DApp remains online and functional.\n\n\n# How it Works\n\n\n# Transaction ID\n\nTo access content tied to an Arweave Transaction ID (TxId), simply append the TxId to ar://:\n\nar://qI19W6spw-kzOGl4qUMNp2gwFH2EBfDXOFsjkcNyK9A\n\n\nInputting this into a WayFinder-equipped browser will route your request through the right AR.IO Gateway, translating it as per your Routing Method settings.\n\n\n# ArNS\n\nFetching content via an Arweave Name System (ArNS) name is straightforward. Attach the ArNS name to ar://:\n\nar://good-morning\n\n\nThe Wayfinder protocol, along with the WayFinder App, discerns between TxIds and ArNS names. Once the suitable https:// request is formulated, the chosen gateway translates the ArNS name based on the ArNS aoComputer contract.\n\n\n# Wayfinder App\n\nThe AR.IO WayFinder App is a browser extension designed to facilitate the resolving of ar:// urls.\n\n\n# v0.0.10\n\nAs of v0.0.10, Wayfinder supports the resolution of TXT records to Arweave content on top level domains. This innovative feature leverages DNS TXT records to associate Arweave transaction IDs with human-readable domain names, facilitating intuitive and memorable access to permaweb content. By simply entering an ar:// URL with a domain name, the Wayfinder App resolves the corresponding Arweave transaction ID through DNS TXT records, redirecting users directly to the content hosted on the Arweave network.\n\nSetup: Owners of a domain can set a TXT record for that domain following the format ARTX .\n\nWayfinder Redirection: With a TXT record set properly, whenever a user (who has Wayfinder installed) enters an ar:// URL containing a domain name (e.g., ar://example.com), the Wayfinder App performs a DNS lookup for that TXT record in order to redirect to the Arweave content. The lookup is completed through a secure DNS-over-HTTPS query to ensure privacy and integrity.\n\nDynamic Content Resolution: After retrieving the TXT record, the Wayfinder App extracts that Arweave transaction ID and dynamically redirects the user to the content on the permaweb. This process is transparent to the user, providing a seamless experience as if accessing a traditional website.\n\n\n# Key Features\n\n * Gasless: TXT records can be set without any onchain transactions that would require gas fees.\n * Easy Integration: Domain owners can easily link their permaweb content to their domains, making it accessible through a simple ar:// URL.\n * Dyncamic Content Access: Content links can be updated in real-time through DNS TXT records, without requiring any changes to the ar:// URL itself.\n * Enhanced User Experience: Offers users a familiar and easy-to-remember way to access permaweb content, leveraging standard web domain names.\n * Security and Privacy: Secure DNS-over-HTTPS queries for DNS lookups protect user privacy and enhances security.\n\n\n# Use Cases\n\n * Branded Content Access: Companies and individuals can brand their permaweb content, making it accessible through their domain, enhancing brand visibility and user trust.\n * Dynamic Content Updates: Domain owners can easily update what Permaweb content their AR:// URL resolves to, which is ideal for frequently updated resources like documents, blogs, and application interfaces.\n * Educational and Informational Resources: Educational institutions and information providers can make their resources permanently available on the permaweb, accessible through simple, memorable URLs.\n\nThis feature marks a significant advancement in making decentralized content more accessible and user-friendly, bridging the gap between traditional internet usability and the permaweb’s permanence and censorship-resistant nature.",normalizedContent:"# wayfinder protocol\n\n\n# overview\n\nthe wayfinder protocol is a uri scheme designed to translate requests for arweave content into https:// requests. essentially, wayfinder allows for transforming traditional arweave urls like https://arweave.net/long-txid into more concise and user-friendly forms such as ar://txid or ar://arns-name. when combined with the ar.io wayfinder browser extension, the request can be directed to any number of functional ar.io gateways to serve the content.\n\nan early technical breakdown of wayfinder, formerly \"arcss\", created by arweave community member dmac, can be found here.\n\n\n# browser integration\n\nthe wayfinder protocol is currently facilitated via the wayfinder app or internal application integration. the intention is to lead popular web browsers like chrome and brave towards a direct integration of the wayfinder protocol, similar to recent integrations of the ipfs:// protocol. such integration would remove the need for a client-side extension and boost developers' confidence in embedding wayfinder protocol urls in their websites.\n\n\n# internal application integration\n\ncertain websites or apps may want to resolve arweave transaction id's (txid) internally. in these scenarios, they can process the wayfinder protocol internally without depending on browser support or the wayfinder app. a prime example is opensea.io. opensea, an nft marketplace, frequently imports nft metadata from external sources. if metadata employs the wayfinder protocol, opensea internally resolves these, presenting content without redirecting users through an https:// link.\n\nthere are two main approaches to resolving wayfinder protocol urls:\n\n 1. convert wayfinder into a request directed at a predefined arweave gateway.\n 2. retrieve a list of active ar.io gateways from the gar by reading the contract state, or other available resources, and then fetch content from a gateway on the list.\n\neach strategy has its benefits and challenges, necessitating careful evaluation based on specific use cases.\n\n\n# benefits of wayfinder over hardcoded gateway links\n\nusing the wayfinder protocol offers several advantages over hardcoded links to a specific gateway:\n\n 1. flexibility: wayfinder links can be routed through any available ar.io gateway, ensuring content remains accessible even if a specific gateway is down or congested.\n 2. decentralization: by not being tied to a single gateway, the wayfinder protocol embodies the decentralized spirit of the web, reducing potential censorship points.\n 3. ease of maintenance: developers and content creators don't need to modify links if a gateway changes its url or becomes unavailable. the wayfinder extension handles routing to an active gateway.\n 4. consistency: users always receive the same content, regardless of the gateway used, ensuring a consistent user experience.\n\n\n# use cases\n\n\n# decentralized web hosting with flexible access\n\nwith wayfinder, not only can websites be hosted on the arweave network, but their accessibility is also enhanced. by using the wayfinder protocol, web developers can ensure that if a specific ar.io gateway is down, the content can still be accessed through another gateway, offering a more reliable and resilient user experience.\n\n\n# digital archives and preservation with enhanced sharing\n\ndigitally archiving public domain works, especially in light of events like \"banned books week\", becomes more efficient with wayfinder. historical institutions or enthusiasts can easily share specific wayfinder links to documents or media. unlike hardcoded links which might break if a specific gateway goes offline, wayfinder ensures that the content remains consistently accessible.\n\n\n# media sharing platforms with consistent content delivery\n\nfor platforms hosting user-generated content, the wayfinder protocol provides not just decentralized hosting but also a guarantee of content delivery. even if a content piece becomes viral and one gateway gets congested, wayfinder ensures that users can still access the content through another gateway, providing a seamless experience.\n\n\n# decentralized applications (dapps) with reliable front-end accessibility\n\ndapps, while benefiting from arweave's permanent hosting, can further ensure their front-end remains consistently accessible to users by using wayfinder. if a dapp's front-end is accessed frequently, causing strain on one gateway, wayfinder can help ensure the load is distributed, and the dapp remains online and functional.\n\n\n# how it works\n\n\n# transaction id\n\nto access content tied to an arweave transaction id (txid), simply append the txid to ar://:\n\nar://qi19w6spw-kzogl4qumnp2gwfh2ebfdxofsjkcnyk9a\n\n\ninputting this into a wayfinder-equipped browser will route your request through the right ar.io gateway, translating it as per your routing method settings.\n\n\n# arns\n\nfetching content via an arweave name system (arns) name is straightforward. attach the arns name to ar://:\n\nar://good-morning\n\n\nthe wayfinder protocol, along with the wayfinder app, discerns between txids and arns names. once the suitable https:// request is formulated, the chosen gateway translates the arns name based on the arns aocomputer contract.\n\n\n# wayfinder app\n\nthe ar.io wayfinder app is a browser extension designed to facilitate the resolving of ar:// urls.\n\n\n# v0.0.10\n\nas of v0.0.10, wayfinder supports the resolution of txt records to arweave content on top level domains. this innovative feature leverages dns txt records to associate arweave transaction ids with human-readable domain names, facilitating intuitive and memorable access to permaweb content. by simply entering an ar:// url with a domain name, the wayfinder app resolves the corresponding arweave transaction id through dns txt records, redirecting users directly to the content hosted on the arweave network.\n\nsetup: owners of a domain can set a txt record for that domain following the format artx .\n\nwayfinder redirection: with a txt record set properly, whenever a user (who has wayfinder installed) enters an ar:// url containing a domain name (e.g., ar://example.com), the wayfinder app performs a dns lookup for that txt record in order to redirect to the arweave content. the lookup is completed through a secure dns-over-https query to ensure privacy and integrity.\n\ndynamic content resolution: after retrieving the txt record, the wayfinder app extracts that arweave transaction id and dynamically redirects the user to the content on the permaweb. this process is transparent to the user, providing a seamless experience as if accessing a traditional website.\n\n\n# key features\n\n * gasless: txt records can be set without any onchain transactions that would require gas fees.\n * easy integration: domain owners can easily link their permaweb content to their domains, making it accessible through a simple ar:// url.\n * dyncamic content access: content links can be updated in real-time through dns txt records, without requiring any changes to the ar:// url itself.\n * enhanced user experience: offers users a familiar and easy-to-remember way to access permaweb content, leveraging standard web domain names.\n * security and privacy: secure dns-over-https queries for dns lookups protect user privacy and enhances security.\n\n\n# use cases\n\n * branded content access: companies and individuals can brand their permaweb content, making it accessible through their domain, enhancing brand visibility and user trust.\n * dynamic content updates: domain owners can easily update what permaweb content their ar:// url resolves to, which is ideal for frequently updated resources like documents, blogs, and application interfaces.\n * educational and informational resources: educational institutions and information providers can make their resources permanently available on the permaweb, accessible through simple, memorable urls.\n\nthis feature marks a significant advancement in making decentralized content more accessible and user-friendly, bridging the gap between traditional internet usability and the permaweb’s permanence and censorship-resistant nature.",charsets:{}},{title:"Contributing to AR.IO Docs",frontmatter:{next:!1},regularPath:"/contribute.html",relativePath:"contribute.md",key:"v-c0082a28",path:"/contribute.html",headers:[{level:2,title:"Overview",slug:"overview",normalizedTitle:"overview",charIndex:33},{level:2,title:"Prerequisites",slug:"prerequisites",normalizedTitle:"prerequisites",charIndex:1183},{level:2,title:"Initial Setup",slug:"initial-setup",normalizedTitle:"initial setup",charIndex:1315},{level:3,title:"Fork the Repository",slug:"fork-the-repository",normalizedTitle:"fork the repository",charIndex:1333},{level:3,title:"Clone your Fork",slug:"clone-your-fork",normalizedTitle:"clone your fork",charIndex:1859},{level:3,title:"Link Upstream",slug:"link-upstream",normalizedTitle:"link upstream",charIndex:2252},{level:3,title:"Install Dependencies for Docs Portal",slug:"install-dependencies-for-docs-portal",normalizedTitle:"install dependencies for docs portal",charIndex:3069},{level:2,title:"Editing",slug:"editing",normalizedTitle:"editing",charIndex:3754},{level:3,title:"Branches",slug:"branches",normalizedTitle:"branches",charIndex:4237},{level:3,title:"What is Markdown?",slug:"what-is-markdown",normalizedTitle:"what is markdown?",charIndex:4800},{level:3,title:"Frontmatter",slug:"frontmatter",normalizedTitle:"frontmatter",charIndex:6493},{level:3,title:"CSS",slug:"css",normalizedTitle:"css",charIndex:7817},{level:3,title:"Adding to the Sidebar",slug:"adding-to-the-sidebar",normalizedTitle:"adding to the sidebar",charIndex:8279},{level:2,title:"Development and Deployment",slug:"development-and-deployment",normalizedTitle:"development and deployment",charIndex:11564},{level:3,title:"Launching Development Server",slug:"launching-development-server",normalizedTitle:"launching development server",charIndex:11595},{level:3,title:"Building Static Files",slug:"building-static-files",normalizedTitle:"building static files",charIndex:12275},{level:3,title:"Creating Your Pull Request",slug:"creating-your-pull-request",normalizedTitle:"creating your pull request",charIndex:12732}],headersStr:"Overview Prerequisites Initial Setup Fork the Repository Clone your Fork Link Upstream Install Dependencies for Docs Portal Editing Branches What is Markdown? Frontmatter CSS Adding to the Sidebar Development and Deployment Launching Development Server Building Static Files Creating Your Pull Request",content:'# Contributing to AR.IO Docs\n\n\n# Overview\n\nThe AR.IO Docs serve as a primary source of information and guidance for users, developers, and contributors interacting with the AR.IO platform. As such, maintaining its clarity, accuracy, and comprehensiveness is paramount. This document outlines the standardized procedures and best practices for contributing to these docs. By following this guide, contributors can ensure that their additions and modifications align with the established documentation structure and conventions.\n\nContributions can range from minor typographical corrections to the addition of entire new sections. Regardless of the scale, every contribution is valuable. Proper setup, understanding the file structure, and familiarity with the submission process are essential components of effective contribution. The sections that follow delve into each stage of the contribution process, from initial setup and local development to the submission of changes for review.\n\nBy adhering to this guide, contributors can streamline the review and integration of their changes, ensuring that the AR.IO Docs remain a reliable and up-to-date resource for all its users.\n\n\n# Prerequisites\n\n * Github account\n * Git installed on your computer\n * Nodejs version 16.15.1\n * Yarn installed on your computer\n\n\n# Initial Setup\n\n\n# Fork the Repository\n\nWhile logged into your Github account, visit the repository for the AR.IO public site\n\nNear the top right of the page, there will be a button labeled "fork".\n\nClicking this will begin the process of making a copy of the public-site repo under your own account.\n\nOn the next screen, make sure the box labeled "copy the main branch only" is NOT checked, then click "create fork"\n\nThis process only needs to be completed once, you will not need to create a new fork each time you want to submit an edit.\n\n\n# Clone your Fork\n\nOnce you have your fork created, you\'ll need to clone it onto your computer in order to make your edits.\n\nNavigate the the location you want to clone the repo and open a terminal (or command prompt/powershell on Windows)\n\nrun the command:\n\ngit clone -b main https://github.com/yourusernamehere/public-site\n\n\nBe sure to replace "yourusernamehere" with your Github username\n\n\n# Link Upstream\n\nThe AR.IO Public Site, and especially the docs portal, is constantly evolving. You are going to want to be able to pull updates from the AR.IO repo into your fork without having to delete it and create a new fork. To do this, you can link the original repo to your fork as "upstream".\n\nFrom inside the fork on your computer, run the command:\n\ngit remote add upstream https://github.com/ar-io/public-site\n\n\nYou can then check to make sure the upstream source was added with:\n\ngit remote -v\n\n\n# Pull updates\n\nPeriodically, you should check if there have been updates to the original repo by using"\n\ngit fetch upstream\n\n\nIf changes show up, you can merge them into your own repo by ensuring you are on the "main" branch, and then running the merge command:\n\ngit checkout main\ngit merge upstream/main\n\n\n\n# Install Dependencies for Docs Portal\n\nThe AR.IO Public Site is primarily a static html website. There are no dependencies that need to be installed in order to launch and view the site as a whole. However, the docs portal is a Vuepress app nested inside that html website. In order to launch the docs portal for review, or to build it into static html, you are going to need to install its dependencies.\n\nFrom in the root directory of the Public Site, navigate into the docs portal and run the install command:\n\ncd docsGenerator/docs\nyarn install\n\n\nNOTE: This repository uses yarn to manage dependency versions, installing dependencies with npm instead of yarn can lead to errors.\n\n\n# Editing\n\nVuepress generates content using markdown (.md) files. Each markdown file can be displayed as its own content page. The location (url) of each page is generally determined by the file\'s location in the file-structure of the vuepress app, though this can be overridden by using frontmatter. Adding a new content page can be as simple as dropping a new file in the appropriate location in the file-structure and adding a reference to it in the sidebar configuration file.\n\n\n# Branches\n\nYou should always ensure that you are starting from an up to date version of the main branch. See Pull Updates for instructions.\n\nOnce you are up to date and on the main branch, you should always create a new branch specific to the changes you are making. This can be done with the command:\n\ngit checkout -b \n\n\nReplace with a short, descriptive name for what you are changing. Do not reuse branches for future edits, you should always create a fresh branch based on the most up to date version of the main branch.\n\n\n# What is Markdown?\n\nMarkdown is a lightweight markup language that allows you to format plain text documents with simple syntax. It\'s commonly used for creating documentation, README files, and web content. Markdown files are easy to read, write, and convert into various formats, such as HTML.\n\nHere are some commonly used Markdown syntax elements:\n\n 1. Headings: Use hash symbols (#) to denote headings. The number of hashes determines the heading level (e.g., # Heading 1, ## Heading 2).\n\n 2. Emphasis: Surround text with asterisks (*) or underscores (_) for emphasis. For example, *italic\\*or_italic_renders as italic, and**bold**or**bold** renders as bold.\n\n 3. Lists: Create unordered lists by starting lines with hyphens (-), plus signs (+), or asterisks (*). Ordered lists use numbers (1., 2., etc.).\n\n 4. Links: Enclose the linked text in square brackets [] and the URL in parentheses (). For example, AR.IO creates a link to AR.IO\'s Public website.\n\n 5. Images: Similar to links, but with an exclamation mark (!) at the beginning. For example, ![Alt Text](image.jpg) embeds an image.\n\n 6. Code: Use backticks ( ` ) to denote inline code . For code blocks, indent each line with four spaces or use triple backticks (```) before and after the code block.\n\n 7. Horizontal Rule: To create a horizontal rule, use three or more hyphens (-), asterisks (*), or underscores (_).\n\nTo denote a Markdown file, save it with the .md extension (e.g., document.md).\n\nWhen used in a VuePress app, Markdown files are rendered into HTML by VuePress\'s built-in Markdown compiler, which supports most standard html tags as well. This includes the ability to assign css classes for additional styling.\n\n\n# Frontmatter\n\nVuepress supports injecting certain options into your markdown files. These options, collectively, are known as frontmatter. There are 5 items that you will primarily use for these docs. All of them may be omitted without issue, or included for additional customization. These are:\n\n 1. title: This sets the title for the page. It will be displayed on the left side of the browser tab when a user accesses that page. If omitted, the title will be pulled from the sidebar for that page.\n\n 2. permalink: Vuepress sets urls based on the filestructure of the project. This can be overridden using permalink, and a custom url can be assigned to a specific page.\n\n 3. prev: Sets the value for the “previous page” button that appears at the bottom of the page. If omitted, this will be pulled from the sidebar. The button can be removed from the page by setting the value to “false”.\n\n 4. next: Similar to prev, this sets the “next page” button value.\n\n 5. tags: accepts a list of key words that can be accessed by the “search” function, as well as helping with SEO.\n\nFrontmatter uses YAML syntax, sandwiched inside two lines of three dashes --- , like so:\n\n---\ntitle: Frontmatter Instructions\npermalink: "/frontmatter/"\nprev: "./what-is-markdown"\nnext: false\ntags: ["frontmatter", "permalink", "other tags"]\n---\n\n\n\n# CSS\n\nIf you add html elements into your markdown file, you can assign custom css classes to them. The easiest way to customize a class is to add it to the primary global css file located at /docsGenerator/docs/src/.vuepress/theme/styles/index.styl\n\nThe file is written in stylus, but supports standard css syntax.\n\nNOTE: It is a good idea to be overly specific with your class names, as the content of the index.styl file will affect the entire docs portal.\n\n\n# Adding to the Sidebar\n\nThe sidebar is rendered from a JavaScript array of objects. It is possible to configure multiple different sidebars, and have them display depending on the filepath a user is currently viewing. The docs portal only uses a single default sidebar at the moment. The configuration file for the sidebar is located at /docs/src/.vuepress/theme/configs/default_sidebar_config.js\n\nTo add a new item to the sidebar, simply choose where you want the item to appear, and insert an object with the following format:\n\n{\ntitle: "Text you want to display",\npath: "Filepath to new file"\n}\n\n\nThe sidebar, when rendered, will find all the H2 tags (##) in the file, and automatically display them as sub-headers in the sidebar, which work as links to that specific section of the page.\n\nYou can also make a sidebar item into an expandable menu by adding a children attribute, which will be an array of objects similar to the parent:\n\n{\ntitle: "Label",\nchildren: [\n {\n title: "First Subtext",\n path: "Filepath to file"\n },\n {\n title: "Second Subtext",\n path: "Filepath to second file"\n }\n ]\n}\n\n\nChildren can be nested for several layers if desired.\n\nBelow is the current sidebar configuration to serve as an example:\n\nmodule.exports = [\n {\n title: "Welcome",\n path: "/",\n },\n {\n title: "Network Overview",\n children: [\n {\n title: "Introduction",\n path: "/introduction",\n },\n {\n title: "Arweave and the Permaweb",\n path: "/arweave",\n },\n {\n title: "The IO Token",\n path: "/token.md",\n },\n {\n title: "Gateway Architecture",\n path: "/gateways/gateways",\n },\n {\n title: "Network Protocols",\n path: "/network-protocols"\n },\n {\n title: "Arweave name System (ArNS)",\n path: "/arns.md",\n },\n ],\n },\n {\n title: "Gateway Operators",\n children: [\n {\n title: "Getting Started",\n children: [\n {\n title: "Overview",\n path: "/gateways/ar-io-node/overview"\n },\n {\n title: "Setting up on Windows",\n path: "/gateways/ar-io-node/windows-setup",\n },\n {\n title: "Setting up on Linux",\n path: "/gateways/ar-io-node/linux-setup",\n },\n {\n title: "Join the Network",\n path: "/gateways/ar-io-node/testnet"\n },\n {\n title: "Upgrading",\n path: "/gateways/ar-io-node/upgrading"\n }\n\n ],\n },\n {\n title: "Advanced Configurations",\n path: "/gateways/ar-io-node/advanced-config"\n },\n {\n title: "AR.IO HTTP API",\n path: "/gateways/ar-io-node/api",\n },\n {\n title: "AR.IO Admin API",\n path: "/gateways/ar-io-node/admin/admin-api"\n }\n ],\n },\n {\n title: "Ecosystem and Community",\n children: [\n {\n title: "AR.IO Foundation",\n path: "/foundation",\n },\n {\n title: "AR.IO Labs",\n path: "/labs",\n },\n {\n title: "Community Resources",\n path: "/community-resources",\n },\n ],\n },\n {\n title: "Glossary",\n path: "/glossary",\n },\n];\n\n\n\n# Development and Deployment\n\n\n# Launching Development Server\n\nFrom inside the docsGenerator/docs directory in your terminal, you can launch a development server in order to preview your edits. This will automatically update as you are making edits, but if some changes do not immediately appear you can shut the server down and restart it for a hard refresh:\n\nyarn dev\n\n\nThe development server will, by default, launch at localhost:8080. The server can be shut down with ctrl+c or by killing the terminal used to start it.\n\nThe most common error when attempting to launch the development server comes from not having a compatible version of Nodejs. If you get an error, try switching to Node version 16.15.1\n\n\n# Building Static Files\n\nThe Vuepress docs portal is nested inside a static html website. For ease of deployment, Vuepress can build the docs portal into static html files and place them in the docs/ folder in the root of the website. This is not necessary for submitting a pr, but it may be useful for local testing. You can do this by navigating your terminal inside the docs portal Vuepress app docsGenerator/docs and running the command:\n\nyarn build\n\n\n\n# Creating Your Pull Request\n\nOnce you have all of your local changes committed and synced to your github account, you can create a Pull Request and have the team review the changes for integration into the public site.\n\n 1. Ensure that all of your changes are committed to your own repository. All commits should follow the Conventional Commits standards.\n\n 2. Navigate to your forked repository\'s page on GitHub.\n\n 3. Switch to the branch you created for your changes.\n\n 4. You should see a banner indicating that you recently pushed a new branch. Click on the "Compare & pull request" button on that banner.\n\n 5. Make sure the base repository is set to the original AR.IO repository and the base branch is set to "staging".\n\n 6. Provide a brief description of your changes in the pull request form. Ensure your title adheres to the Conventional Commits standards.\n\n 7. Review the changes and confirm they appear as expected.\n\n 8. Once you\'re ready, click on the "Create pull request" button. The AR.IO team will review the request and, if approved, merge your changes into the staging branch of the repository. The changes will later be merged into the main branch for production deployment.',normalizedContent:'# contributing to ar.io docs\n\n\n# overview\n\nthe ar.io docs serve as a primary source of information and guidance for users, developers, and contributors interacting with the ar.io platform. as such, maintaining its clarity, accuracy, and comprehensiveness is paramount. this document outlines the standardized procedures and best practices for contributing to these docs. by following this guide, contributors can ensure that their additions and modifications align with the established documentation structure and conventions.\n\ncontributions can range from minor typographical corrections to the addition of entire new sections. regardless of the scale, every contribution is valuable. proper setup, understanding the file structure, and familiarity with the submission process are essential components of effective contribution. the sections that follow delve into each stage of the contribution process, from initial setup and local development to the submission of changes for review.\n\nby adhering to this guide, contributors can streamline the review and integration of their changes, ensuring that the ar.io docs remain a reliable and up-to-date resource for all its users.\n\n\n# prerequisites\n\n * github account\n * git installed on your computer\n * nodejs version 16.15.1\n * yarn installed on your computer\n\n\n# initial setup\n\n\n# fork the repository\n\nwhile logged into your github account, visit the repository for the ar.io public site\n\nnear the top right of the page, there will be a button labeled "fork".\n\nclicking this will begin the process of making a copy of the public-site repo under your own account.\n\non the next screen, make sure the box labeled "copy the main branch only" is not checked, then click "create fork"\n\nthis process only needs to be completed once, you will not need to create a new fork each time you want to submit an edit.\n\n\n# clone your fork\n\nonce you have your fork created, you\'ll need to clone it onto your computer in order to make your edits.\n\nnavigate the the location you want to clone the repo and open a terminal (or command prompt/powershell on windows)\n\nrun the command:\n\ngit clone -b main https://github.com/yourusernamehere/public-site\n\n\nbe sure to replace "yourusernamehere" with your github username\n\n\n# link upstream\n\nthe ar.io public site, and especially the docs portal, is constantly evolving. you are going to want to be able to pull updates from the ar.io repo into your fork without having to delete it and create a new fork. to do this, you can link the original repo to your fork as "upstream".\n\nfrom inside the fork on your computer, run the command:\n\ngit remote add upstream https://github.com/ar-io/public-site\n\n\nyou can then check to make sure the upstream source was added with:\n\ngit remote -v\n\n\n# pull updates\n\nperiodically, you should check if there have been updates to the original repo by using"\n\ngit fetch upstream\n\n\nif changes show up, you can merge them into your own repo by ensuring you are on the "main" branch, and then running the merge command:\n\ngit checkout main\ngit merge upstream/main\n\n\n\n# install dependencies for docs portal\n\nthe ar.io public site is primarily a static html website. there are no dependencies that need to be installed in order to launch and view the site as a whole. however, the docs portal is a vuepress app nested inside that html website. in order to launch the docs portal for review, or to build it into static html, you are going to need to install its dependencies.\n\nfrom in the root directory of the public site, navigate into the docs portal and run the install command:\n\ncd docsgenerator/docs\nyarn install\n\n\nnote: this repository uses yarn to manage dependency versions, installing dependencies with npm instead of yarn can lead to errors.\n\n\n# editing\n\nvuepress generates content using markdown (.md) files. each markdown file can be displayed as its own content page. the location (url) of each page is generally determined by the file\'s location in the file-structure of the vuepress app, though this can be overridden by using frontmatter. adding a new content page can be as simple as dropping a new file in the appropriate location in the file-structure and adding a reference to it in the sidebar configuration file.\n\n\n# branches\n\nyou should always ensure that you are starting from an up to date version of the main branch. see pull updates for instructions.\n\nonce you are up to date and on the main branch, you should always create a new branch specific to the changes you are making. this can be done with the command:\n\ngit checkout -b \n\n\nreplace with a short, descriptive name for what you are changing. do not reuse branches for future edits, you should always create a fresh branch based on the most up to date version of the main branch.\n\n\n# what is markdown?\n\nmarkdown is a lightweight markup language that allows you to format plain text documents with simple syntax. it\'s commonly used for creating documentation, readme files, and web content. markdown files are easy to read, write, and convert into various formats, such as html.\n\nhere are some commonly used markdown syntax elements:\n\n 1. headings: use hash symbols (#) to denote headings. the number of hashes determines the heading level (e.g., # heading 1, ## heading 2).\n\n 2. emphasis: surround text with asterisks (*) or underscores (_) for emphasis. for example, *italic\\*or_italic_renders as italic, and**bold**or**bold** renders as bold.\n\n 3. lists: create unordered lists by starting lines with hyphens (-), plus signs (+), or asterisks (*). ordered lists use numbers (1., 2., etc.).\n\n 4. links: enclose the linked text in square brackets [] and the url in parentheses (). for example, ar.io creates a link to ar.io\'s public website.\n\n 5. images: similar to links, but with an exclamation mark (!) at the beginning. for example, ![alt text](image.jpg) embeds an image.\n\n 6. code: use backticks ( ` ) to denote inline code . for code blocks, indent each line with four spaces or use triple backticks (```) before and after the code block.\n\n 7. horizontal rule: to create a horizontal rule, use three or more hyphens (-), asterisks (*), or underscores (_).\n\nto denote a markdown file, save it with the .md extension (e.g., document.md).\n\nwhen used in a vuepress app, markdown files are rendered into html by vuepress\'s built-in markdown compiler, which supports most standard html tags as well. this includes the ability to assign css classes for additional styling.\n\n\n# frontmatter\n\nvuepress supports injecting certain options into your markdown files. these options, collectively, are known as frontmatter. there are 5 items that you will primarily use for these docs. all of them may be omitted without issue, or included for additional customization. these are:\n\n 1. title: this sets the title for the page. it will be displayed on the left side of the browser tab when a user accesses that page. if omitted, the title will be pulled from the sidebar for that page.\n\n 2. permalink: vuepress sets urls based on the filestructure of the project. this can be overridden using permalink, and a custom url can be assigned to a specific page.\n\n 3. prev: sets the value for the “previous page” button that appears at the bottom of the page. if omitted, this will be pulled from the sidebar. the button can be removed from the page by setting the value to “false”.\n\n 4. next: similar to prev, this sets the “next page” button value.\n\n 5. tags: accepts a list of key words that can be accessed by the “search” function, as well as helping with seo.\n\nfrontmatter uses yaml syntax, sandwiched inside two lines of three dashes --- , like so:\n\n---\ntitle: frontmatter instructions\npermalink: "/frontmatter/"\nprev: "./what-is-markdown"\nnext: false\ntags: ["frontmatter", "permalink", "other tags"]\n---\n\n\n\n# css\n\nif you add html elements into your markdown file, you can assign custom css classes to them. the easiest way to customize a class is to add it to the primary global css file located at /docsgenerator/docs/src/.vuepress/theme/styles/index.styl\n\nthe file is written in stylus, but supports standard css syntax.\n\nnote: it is a good idea to be overly specific with your class names, as the content of the index.styl file will affect the entire docs portal.\n\n\n# adding to the sidebar\n\nthe sidebar is rendered from a javascript array of objects. it is possible to configure multiple different sidebars, and have them display depending on the filepath a user is currently viewing. the docs portal only uses a single default sidebar at the moment. the configuration file for the sidebar is located at /docs/src/.vuepress/theme/configs/default_sidebar_config.js\n\nto add a new item to the sidebar, simply choose where you want the item to appear, and insert an object with the following format:\n\n{\ntitle: "text you want to display",\npath: "filepath to new file"\n}\n\n\nthe sidebar, when rendered, will find all the h2 tags (##) in the file, and automatically display them as sub-headers in the sidebar, which work as links to that specific section of the page.\n\nyou can also make a sidebar item into an expandable menu by adding a children attribute, which will be an array of objects similar to the parent:\n\n{\ntitle: "label",\nchildren: [\n {\n title: "first subtext",\n path: "filepath to file"\n },\n {\n title: "second subtext",\n path: "filepath to second file"\n }\n ]\n}\n\n\nchildren can be nested for several layers if desired.\n\nbelow is the current sidebar configuration to serve as an example:\n\nmodule.exports = [\n {\n title: "welcome",\n path: "/",\n },\n {\n title: "network overview",\n children: [\n {\n title: "introduction",\n path: "/introduction",\n },\n {\n title: "arweave and the permaweb",\n path: "/arweave",\n },\n {\n title: "the io token",\n path: "/token.md",\n },\n {\n title: "gateway architecture",\n path: "/gateways/gateways",\n },\n {\n title: "network protocols",\n path: "/network-protocols"\n },\n {\n title: "arweave name system (arns)",\n path: "/arns.md",\n },\n ],\n },\n {\n title: "gateway operators",\n children: [\n {\n title: "getting started",\n children: [\n {\n title: "overview",\n path: "/gateways/ar-io-node/overview"\n },\n {\n title: "setting up on windows",\n path: "/gateways/ar-io-node/windows-setup",\n },\n {\n title: "setting up on linux",\n path: "/gateways/ar-io-node/linux-setup",\n },\n {\n title: "join the network",\n path: "/gateways/ar-io-node/testnet"\n },\n {\n title: "upgrading",\n path: "/gateways/ar-io-node/upgrading"\n }\n\n ],\n },\n {\n title: "advanced configurations",\n path: "/gateways/ar-io-node/advanced-config"\n },\n {\n title: "ar.io http api",\n path: "/gateways/ar-io-node/api",\n },\n {\n title: "ar.io admin api",\n path: "/gateways/ar-io-node/admin/admin-api"\n }\n ],\n },\n {\n title: "ecosystem and community",\n children: [\n {\n title: "ar.io foundation",\n path: "/foundation",\n },\n {\n title: "ar.io labs",\n path: "/labs",\n },\n {\n title: "community resources",\n path: "/community-resources",\n },\n ],\n },\n {\n title: "glossary",\n path: "/glossary",\n },\n];\n\n\n\n# development and deployment\n\n\n# launching development server\n\nfrom inside the docsgenerator/docs directory in your terminal, you can launch a development server in order to preview your edits. this will automatically update as you are making edits, but if some changes do not immediately appear you can shut the server down and restart it for a hard refresh:\n\nyarn dev\n\n\nthe development server will, by default, launch at localhost:8080. the server can be shut down with ctrl+c or by killing the terminal used to start it.\n\nthe most common error when attempting to launch the development server comes from not having a compatible version of nodejs. if you get an error, try switching to node version 16.15.1\n\n\n# building static files\n\nthe vuepress docs portal is nested inside a static html website. for ease of deployment, vuepress can build the docs portal into static html files and place them in the docs/ folder in the root of the website. this is not necessary for submitting a pr, but it may be useful for local testing. you can do this by navigating your terminal inside the docs portal vuepress app docsgenerator/docs and running the command:\n\nyarn build\n\n\n\n# creating your pull request\n\nonce you have all of your local changes committed and synced to your github account, you can create a pull request and have the team review the changes for integration into the public site.\n\n 1. ensure that all of your changes are committed to your own repository. all commits should follow the conventional commits standards.\n\n 2. navigate to your forked repository\'s page on github.\n\n 3. switch to the branch you created for your changes.\n\n 4. you should see a banner indicating that you recently pushed a new branch. click on the "compare & pull request" button on that banner.\n\n 5. make sure the base repository is set to the original ar.io repository and the base branch is set to "staging".\n\n 6. provide a brief description of your changes in the pull request form. ensure your title adheres to the conventional commits standards.\n\n 7. review the changes and confirm they appear as expected.\n\n 8. once you\'re ready, click on the "create pull request" button. the ar.io team will review the request and, if approved, merge your changes into the staging branch of the repository. the changes will later be merged into the main branch for production deployment.',charsets:{}},{title:"AO ANT",frontmatter:{permalink:"/guides/experimental/ao-ant",next:!1},regularPath:"/experimental/ao-ant.html",relativePath:"experimental/ao-ant.md",key:"v-4c2c563a",path:"/guides/experimental/ao-ant/",headers:[{level:2,title:"Overview",slug:"overview",normalizedTitle:"overview",charIndex:13},{level:2,title:"Installation",slug:"installation",normalizedTitle:"installation",charIndex:256},{level:2,title:"Usage",slug:"usage",normalizedTitle:"usage",charIndex:882},{level:3,title:"Set Controller",slug:"set-controller",normalizedTitle:"set controller",charIndex:1109},{level:3,title:"Initiate Record Sync and Update",slug:"initiate-record-sync-and-update",normalizedTitle:"initiate record sync and update",charIndex:1363}],headersStr:"Overview Installation Usage Set Controller Initiate Record Sync and Update",content:'# AO ANT\n\n\n# Overview\n\nArweave Name Tokens, or ANTs, are the aoComputer contracts that control each ArNS name. You can easily set up an ao process to function as an ANT by loading the ant.lua file from the ao-pilot github repository into your process.\n\n\n# Installation\n\nThe ao ANT code is a single file within the ao-pilot Github repository from ar.io. The specific file is located here.\n\nYou can install the ao-pilot repo on your computer with\n\ngit clone https://github.com/ar-io/ao-pilot\n\nNavigating the file system inside of ao is not as straightforward as it is in a regular terminal, so opening ao directly in the same folder as the file you are going to load can make things significantly easier.\n\ncd ao-pilot/src\naos\n\n\nFrom here, simply load the arns-resolver file into your process.\n\n.load ant.lua\n\nIf things work successfully, your aos terminal will print "undefined".\n\n\n# Usage\n\nSimply loading the script into your process will set variables and handlers to make your process conform to the ant standard, but you will still need to send an initiate request to add your ANT into the ao registry.\n\n\n# Set Controller\n\nOnly authorized people can make updates to your ArNS name. Because of this, you will need to add your process ID as a \'controller\' under your ArNS name at arns.app. This will give your process permissions needed to make these updates\n\n\n# Initiate Record Sync and Update\n\nWhen you purchase an ArNS name on arns.app, that name is not automatically synced to the ao-ArNS registry. Anyone can initiate a sync, which loads the data of an ArNS name from the aoComputer contract into the ao-ArNS registry:\n\nSend({ Target = "TyduW6spZTr3gkdIsdktduJhgtilaR_ex5JukK8gI9o", Tags = { Action = "Initiate-Record-Sync", Name = "" }})\n\n\nBe sure to replace with the correct ArNS name.\n\nOnce your process is a controller, and you have loaded the ANT script, you can initiate an update to the ao-ArNS registry by running the following command:\n\nSend({ Target = ARNS_PROCESS_ID, Tags = { Action = "Initiate-Record-Update", Name = "", ProcessId = ao.id }})\n\n\nMake sure to change with the correct arns name.\n\nonce your process is a controller, and you have loaded the ant script, you can initiate an update to the ao-arns registry by running the following command:\n\nsend({ target = arns_process_id, tags = { action = "initiate-record-update", name = "", processid = ao.id }})\n\n\nmake sure to change with the correct ArNS name.\n\nNOTE: Syncing data from the ArNS smartweave contract relies on the Orbit Oracle. ao and Orbit are still in early development, and may not perform exactly as expected.',normalizedContent:'# ao arns resolver\n\n\n# overview\n\nao is in the early stages of development, with its infrastructure evolving quickly. among the developments is the arns-resolver, a set of rules and commands that facilitate the integration of arns names from the arns registry contract into your ao process. currently, the interaction with the arns registry contract is unidirectional; ao can receive updates but cannot modify the contract. as this feature is experimental, it is expected to undergo significant changes, but users are welcome to test the current iteration.\n\n\n# installation\n\n\n# from blueprint\n\nfrom inside aos, simply type .load-blueprint arns to load the arns resolver into your aos process.\n\n\n# from source\n\nto get access to the latest development version, you can install directly from the source code.\n\nthe arns-resolver is a single file within the ao-pilot github repository from ar.io. the specific file is located here.\n\nyou can install the ao-pilot repo on your computer with\n\ngit clone https://github.com/ar-io/ao-pilot\n\nnavigating the file system inside of ao is not as straightforward as it is in a regular terminal, so opening ao directly in the same folder as the file you are going to load can make things significantly easier.\n\ncd ao-pilot/src\naos\n\n\nfrom here, simply load the arns-resolver file into your process.\n\n.load arns-resolver.lua\n\nif things work successfully, your aos terminal will print "undefined".\n\n\n# usage\n\n\n# resolve\n\nyou can resolve an arns name with the arns.resolve command.\n\narns.resolve(\'ardrive\')\n\n\nthis will fetch all of the data related to the arns name ardrive and store it locally in your names table. you can print that data by typing\n\nnames[\'ardrive\']\n\n\nand use that variable in other commands that need to reference any of the data.\n\nthe resolve command will first check the ao-arns registry for any information on the name. if there is a contracttxid field present, it will then make a request to the arns smartweave contract, using the orbit oracle, in order to try and get more information about the contract state for the underlying ant. then, if there is a processid field, a request will be made to that process to try and get ao specific information. this loads information into your local process at each step. for example, the first bit of information coming from the ao-arns registry will look like this:\n\n ardrive = {\n contracttxid = "bh9l1cy0aksil_x9m359fagzm_yjralachiuo8_nqxm",\n lastupdated = 1710951400626,\n record = {\n type = "lease",\n contracttxid = "bh9l1cy0aksil_x9m359fagzm_yjralachiuo8_nqxm",\n undernames = 100,\n starttimestamp = 1694101828,\n endtimestamp = 1711122739,\n purchaseprice = 0\n }\n }\n\n\nafter orbit returns the information from the arns smartweave contract, that data will be added under a contract key:\n\nardrive = {\n contracttxid = "bh9l1cy0aksil_x9m359fagzm_yjralachiuo8_nqxm",\n contract = {\n controller = "6z-ifqgvi1jowmvsnwkws6ewueq0gu9eo4ahyc3rn1m",\n ticker = "ant-ardrive",\n name = "ardrive.io",\n lastupdated = 1711118753890,\n owner = "qgwqtjdllgm2ehfwiipzmaofld50cnguzzipedodrgq",\n balances = {\n qgwqtjdllgm2ehfwiipzmaofld50cnguzzipedodrgq = 1\n },\n records = {\n @ = {\n ttlseconds = 3600,\n transactionid = "noxjjj_vk0dc1ycgdwd8kti_1ihrugzlqlnnbhvpn0y"\n },\n cn = {\n ttlseconds = 3300,\n transactionid = "_hquert6pfgfxrvxrxqtkj7pv5rcizcqvmjltuy0c1k"\n },\n og = {\n ttlseconds = 3600,\n transactionid = "yzd_pm5vafypmd3zqcgmuckkulegheh7axlrnrdckbo"\n },\n logo = {\n ttlseconds = 3600,\n transactionid = "kkmrbifrc7wilcg0zvy1etlo0nbx1926dscksxcin3a"\n },\n og_logo = {\n ttlseconds = 3600,\n transactionid = "tb2wjykrpnkaw79dawljywpgdhkpijejwqfcwx715co"\n },\n dapp = {\n ttlseconds = 3600,\n transactionid = "qrwdhy_pxrnibulyn0macf-ybngbmnmv5ovsrvrxxv8"\n },\n og_dapp = {\n ttlseconds = 3600,\n transactionid = "5ir4wbu4kuv1puz1ypye1arxsrhut5g2ptmuon2jdli"\n }\n }\n },\n lastupdated = 1711118166407,\n record = {\n type = "lease",\n contracttxid = "bh9l1cy0aksil_x9m359fagzm_yjralachiuo8_nqxm",\n undernames = 100,\n starttimestamp = 1694101828,\n endtimestamp = 1711122739,\n purchaseprice = 0\n }\n }\n\n\nand an arns name with ao process information could look like this:\n\nblackjack = {\n contracttxid = "ydbc4jljkeurnbtbp15vlzx1zz9stgfpz7prvzoga3i",\n process = {\n denomination = "1",\n lastupdated = 1711049563689,\n ticker = "ant-blackjack",\n name = "blackjack",\n logo = "sie_26dvgyok0pzd_-iqafohod5yxdtkczoloqttl_a",\n owner = "cf0h0skdnadtqwky9ijkbkttpdewgb3gnlnde7abv0q",\n controllers = "["ikryoezqmoni2965nkz528htmmn_sbcjlhc-vncorja","w4aorx9fhpbicngbgtzq-ulyasut4pkw_tjsfs-k3tc","oey0wkxod2dangjby28dhyiad150sajlqaffnrbbeby"]",\n records = {\n @ = {\n ttlseconds = 3600,\n transactionid = "lt3pycxsdm9r2_lxhnqj3rzzhulszt8s-p8vm1fpejc"\n }\n }\n },\n lastupdated = 1711049561377,\n processid = "vo7o7wj2oplkbtudjfeodzjcjpi_-v_rle27vpzp8ja",\n record = {\n type = "lease",\n contracttxid = "ydbc4jljkeurnbtbp15vlzx1zz9stgfpz7prvzoga3i",\n undernames = 10,\n processid = "vo7o7wj2oplkbtudjfeodzjcjpi_-v_rle27vpzp8ja",\n starttimestamp = 1710964910,\n endtimestamp = 1742500910,\n purchaseprice = 875\n }\n }\n\n\nnote: syncing data from the arns smartweave contract relies on the orbit oracle. ao and orbit are still in early development, and may not perform exactly as expected.\n\n\n# data\n\nthe data command arns.data will search through the names you have already resolved and try to find the process id or transaction id that the name has in its records. if the specified name isn\'t in your resolved list already, a request to resolve it will be sent.\n\nfor example:\n\narns.data(\'blackjack\')\n\n\nwould give the output vo7o7wj2oplkbtudjfeodzjcjpi_-v_rle27vpzp8ja, which is the process id of an ao black jack game. the command arns.data(\'blackjack\') can be used in place of anywhere that you would normally have to input that process id.\n\nprocess id information will be prioritized over contract information, so if an arns name has both, the process id will be returned instead of the contract id.\n\n# undernames\n\narns supports undernames, which are subdomains that exist on an arns name. they are separated by underscores (_) instead of dots (.) like a subdomain on a traditional domain would be. the data method can return information about a specific undername on an arns name if you specify it.\n\narns.data(\'dapp_ardrive\')\n\n\nwill return qrwdhy_pxrnibulyn0macf-ybngbmnmv5ovsrvrxxv8, which is the transaction id for the dapp undername on the ardrive arns name.\n\n\n# owner\n\nowner will, as its name indicates, return the arweave wallet address that owns an arns name. it also uses the same syntax as the other commands:\n\narns.owner(\'ardrive\')\n\n\n\n# id\n\nid is another method of getting a processid or transactionid from an arns name. unlike arns.data, arns.id doesn\'t rely on the "contract" or "process" fields of the name. instead, it grabs the processid or contractid from the top level. for example, the ardrive example shown above:\n\n ardrive = {\n contracttxid = "bh9l1cy0aksil_x9m359fagzm_yjralachiuo8_nqxm",\n lastupdated = 1710951400626,\n record = {\n type = "lease",\n contracttxid = "bh9l1cy0aksil_x9m359fagzm_yjralachiuo8_nqxm",\n undernames = 100,\n starttimestamp = 1694101828,\n endtimestamp = 1711122739,\n purchaseprice = 0\n }\n }\n\n\ndoes not have the fields "contract" or "process", so if you tried to get arns.data(\'ardrive\') it would return nil (or undefined). using\n\narns.id(\'ardrive\')\n\n\ninstead will get the contracttxid value from the top level, and return that value. just like with data, a process id is prioritized over a contract id.\n\n\n# clear\n\narns.clear will reset your names table, emptying your locally saved cache of arns data.\n\n\n# sync\n\nwhen someone purchases an arns name on arns.app, that name is not automatically synced to the ao-arns registry. anyone can initiate a sync, which loads the data of an arns name from the smartweave contract into the ao-arns registry:\n\nsend({ target = "tyduw6spztr3gkdisdktdujhgtilar_ex5jukk8gi9o", tags = { action = "initiate-record-sync", name = "" }})\n\n\nbe sure to replace with the correct arns name.\n\nnote: syncing data from the arns smartweave contract relies on the orbit oracle. ao and orbit are still in early development, and may not perform exactly as expected.',charsets:{}},{title:"AR.IO Foundation",frontmatter:{permalink:"/foundation",prev:!1},regularPath:"/foundation.html",relativePath:"foundation.md",key:"v-ecd6cf40",path:"/foundation/",headers:[{level:2,title:"What is the AR.IO Foundation?",slug:"what-is-the-ar-io-foundation",normalizedTitle:"what is the ar.io foundation?",charIndex:23},{level:2,title:"Guiding Philosophy",slug:"guiding-philosophy",normalizedTitle:"guiding philosophy",charIndex:686}],headersStr:"What is the AR.IO Foundation? Guiding Philosophy",content:"# AR.IO Foundation\n\n\n# What is the AR.IO Foundation?\n\nThe AR.IO Foundation is dedicated to the stewardship and prosperity of The AR.IO Network and its associated token ecosystem. It holds a non-revocable, exclusive license to promote the development of the network, prioritizing the ecosystem's wellbeing, particularly the users.\n\nKey strategies employed by the Foundation (with the assistance of third-party teams) in support of the network include:\n\n * Providing grants and incentive programs\n\n * Making strategic investments\n\n * Engaging in direct software development\n\n * Producing educational content\n\n * Conducting publicity and marketing initiatives\n\n * Forming partnerships\n\n\n# Guiding Philosophy\n\nThe AR.IO Foundation serves as a unifying force within the ecosystem, facilitating communication, fostering innovation, and driving overall progress. Its primary aim is to function as a supportive entity rather than exerting excessive control over the network or disrupting its economic processes.\n\nThe key objectives of the AR.IO Foundation are as follows:\n\n * Sustaining and advancing the AR.IO Network: The Foundation takes responsibility for the continued development and enhancement of the AR.IO Network. It works collaboratively with developers, contributors, and stakeholders to ensure the network remains robust, secure, and adaptable to evolving technological landscapes.\n\n * Allocating resources to promote ecosystem and community growth: The Foundation is entrusted with managing and allocating resources to fuel the growth and expansion of the AR.IO ecosystem. This includes funding research initiatives, supporting innovative projects, and encouraging community-driven initiatives that contribute to the network's overall health and vitality.\n\n * Managing the core development of the AR.IO Network: The Foundation oversees and coordinates the core development efforts of the AR.IO Network. This involves coordinating with developers and technical teams to implement upgrades, address vulnerabilities, and introduce new features that align with the network's vision and community consensus.\n\n * Fostering collaboration and inclusivity: The Foundation actively fosters a culture of collaboration and inclusivity within the AR.IO ecosystem. It encourages diverse perspectives and welcomes contributions from individuals and organizations, fostering an environment where all participants can thrive and collectively shape the network's future.\n\nBy diligently pursuing these objectives, the AR.IO Foundation aims to create an environment where the AR.IO Network can flourish as a decentralized, secure, and resilient platform, contributing positively to the broader permaweb and decentralized storage landscape.",normalizedContent:"# ar.io foundation\n\n\n# what is the ar.io foundation?\n\nthe ar.io foundation is dedicated to the stewardship and prosperity of the ar.io network and its associated token ecosystem. it holds a non-revocable, exclusive license to promote the development of the network, prioritizing the ecosystem's wellbeing, particularly the users.\n\nkey strategies employed by the foundation (with the assistance of third-party teams) in support of the network include:\n\n * providing grants and incentive programs\n\n * making strategic investments\n\n * engaging in direct software development\n\n * producing educational content\n\n * conducting publicity and marketing initiatives\n\n * forming partnerships\n\n\n# guiding philosophy\n\nthe ar.io foundation serves as a unifying force within the ecosystem, facilitating communication, fostering innovation, and driving overall progress. its primary aim is to function as a supportive entity rather than exerting excessive control over the network or disrupting its economic processes.\n\nthe key objectives of the ar.io foundation are as follows:\n\n * sustaining and advancing the ar.io network: the foundation takes responsibility for the continued development and enhancement of the ar.io network. it works collaboratively with developers, contributors, and stakeholders to ensure the network remains robust, secure, and adaptable to evolving technological landscapes.\n\n * allocating resources to promote ecosystem and community growth: the foundation is entrusted with managing and allocating resources to fuel the growth and expansion of the ar.io ecosystem. this includes funding research initiatives, supporting innovative projects, and encouraging community-driven initiatives that contribute to the network's overall health and vitality.\n\n * managing the core development of the ar.io network: the foundation oversees and coordinates the core development efforts of the ar.io network. this involves coordinating with developers and technical teams to implement upgrades, address vulnerabilities, and introduce new features that align with the network's vision and community consensus.\n\n * fostering collaboration and inclusivity: the foundation actively fosters a culture of collaboration and inclusivity within the ar.io ecosystem. it encourages diverse perspectives and welcomes contributions from individuals and organizations, fostering an environment where all participants can thrive and collectively shape the network's future.\n\nby diligently pursuing these objectives, the ar.io foundation aims to create an environment where the ar.io network can flourish as a decentralized, secure, and resilient platform, contributing positively to the broader permaweb and decentralized storage landscape.",charsets:{}},{title:"Gateway network",frontmatter:{permalink:"/gateway-network/"},regularPath:"/gateway-network.html",relativePath:"gateway-network.md",key:"v-90d4f50c",path:"/gateway-network/",headers:[{level:2,title:"Overview",slug:"overview",normalizedTitle:"overview",charIndex:22},{level:2,title:"Gateway Address Registry (GAR)",slug:"gateway-address-registry-gar",normalizedTitle:"gateway address registry (gar)",charIndex:235},{level:2,title:"Staking",slug:"staking",normalizedTitle:"staking",charIndex:2650},{level:2,title:"Schema",slug:"schema",normalizedTitle:"schema",charIndex:3834},{level:3,title:"Gateway Schema",slug:"gateway-schema",normalizedTitle:"gateway schema",charIndex:3845},{level:3,title:"Token Vault",slug:"token-vault",normalizedTitle:"token vault",charIndex:5414},{level:3,title:"Gateway Settings",slug:"gateway-settings",normalizedTitle:"gateway settings",charIndex:5706}],headersStr:"Overview Gateway Address Registry (GAR) Staking Schema Gateway Schema Token Vault Gateway Settings",content:'# Gateway network\n\n\n# Overview\n\nThe AR.IO Network consists of AR.IO Gateway nodes, which are identified by their registered Arweave wallet addresses and either their IP addresses or hostnames, as stored in the network\'s smart contract Gateway Address Registry (GAR).\n\nThese nodes adhere to the AR.IO Network Protocols, creating a collaborative environment of Gateway nodes that vary in scale and specialization. The network ensures a fundamental level of service quality and trust minimization among its participants.\n\nBeing part of the network grants AR.IO Gateways an array of advantages, such as:\n\n * Simplified advertising of services and end user discovery via the Gateway Address Registry.\n\n * More rapid bootstrapping of key Gateway operational data due to prioritized data request fulfillment among Gateways joined to the network.\n\n * Sharing of data processing results.\n\n * Access to support channels tailored for operators.\n\n * Enhanced trust and transparency through the use of AGPL-3 licenses, which mandate public disclosure of any software changes, thereby reinforcing the network\'s integrity and reliability.\n\n * Improved network reliability and performance through an incentive protocol, which uses a system of rewards and evaluations to encourage high-quality service from Gateways.\n\n\n# Gateway Address Registry (GAR)\n\nAny Gateway operator that whishes to join the AR.IO Network must register their node in the AR.IO smart contract\'s "Gateway Address Registry", known as the GAR. Registration involves staking a minimum amount of IO tokens and providing additional metadata describing the Gateway service offered.\n\nAfter joining the network, the operator\'s Gateway can be easily discovered by permaweb apps, its health can be observed, and it can participate in the AR.IO data sharing protocol.\n\nThe Gateway operator can modify their Gateway\'s GAR configuration as needed, which includes adding more tokens to their stake or removing them. Operators can completely remove their stake and leave the AR.IO Network following a minimum network exit wait time. This exit time ensures that Gateways cannot quickly escape from an anticipated penalty.\n\nThe GAR advertises the specific attributes of each Gateway including its stake and settings. This enables permaweb apps and users to discover which Gateways are currently available and meet their needs. Apps that read the GAR can sort and filter it using the Gateway metadata, for example, ranking Gateways with the highest stake at the top of the list. This would allow users to prefer the lower-trust, higher staked Gateways before settling on a higher-trust, lower staked Gateway.\n\n\n# Staking\n\nStaking tokens serves a dual purpose in the AR.IO Network:\n\n * It acts as a method of public commitment, and\n\n * It qualifies participants for reward distribution.\n\nIn the AR.IO Network, "staking" designates the act of locking a specified amount of IO tokens into a protocol-controlled vault. These tokens act as a form of collateral and public commitment, encouraging network participants to act in the network\'s best interests. Once tokens are deposited in the vault, they remain locked until either the participant triggers the "unstake" function or the vault\'s predetermined lock period expires.\n\nIt is important to note that unlike other protocols, the IO token is non-inflationary. Therefore, the staking mechanism in the AR.IO Network is not designed to function as a yield-generation tool. By staking their tokens, participants become eligible for potential rewards, fostering an atmosphere of mutual trust within the network. Specifically, Gateway operators stake tokens to facilitate their Gateway integration and establish public trust. Once connected, they become eligible for rewards driven by the protocol and gain access to the network\'s shared resources.\n\n\n# Schema\n\n\n# Gateway Schema\n\nGATEWAY\nNAME TYPE DESCRIPTION\nOPERATORSTAKE number The total stake of the Gateway\'s operator.\nSTART number Block number in which the Gateway joined the network.\nEND number Block number in which the Gateway can leave the network,\n setting to 0 means no end date.\nSTATUS string Participation status of the Gateway, "joined" -\n participating in the network, "hidden" - not leaving, but\n not participating, "leaving" - in the process of withdrawing\n from the network.\nVAULTS array of objects The locked tokens staked by the Gateway operator, view\n schema.\nSETTINGS object Additional configuration settings for the Gateway, view\n schema.\nDELEGATES object Wallets that have delegated a stake of IO tokens to the\n Gateway.\nTOTALDELEGATEDSTAKE number The total number of IO tokens delegated to the Gateway\nOBSERVERWALLET string The public address for the wallet being used to sign and\n upload Observer reports\nSTATS object Information about the Gateways Network performance\n\n\n# Token Vault\n\nTOKEN VAULT\nNAME TYPE DESCRIPTION\nBALANCE number Positive integer, the number of IO tokens locked.\nSTART number Block number in which locking starts.\nEND number Block number in which locking ends. Setting to 0 means no\n end date.\n\n\n# Gateway Settings\n\nGATEWAY SETTINGS\nNAME TYPE REQUIRED DESCRIPTION\nLABEL string yes The friendly name used to label the Gateway.\nFQDN string yes The fully qualified domain name at which the Gateway can be\n reached. e.g. arweave.net\nPORT number yes The port used by the Gateway. e.g. 443\nPROTOCOL string yes Web protocol used by this Gateway "https", or "http"\nPROPERTIES string no An Arweave transaction ID containing additional properties\n of the Gateway.\nNOTE string no An Arweave transaction ID containing additional notes the\n Gateway operator can set to include things like\n announcements, maintenance, or other operational updates.\nALLOWDELEGATEDSTAKING boolean no The Gateway Operator can allow or disallow other wallets to\n stake IO tokens on the Gateway.\nDELEGATEDREWARDSHARERATIO number no The percentage of Gateway rewards given to delegated stakers\nAUTOSTAKE boolean no If true, Gateway rewards will automatically be added to the\n Gateway\'s Operator stake',normalizedContent:'# gateway network\n\n\n# overview\n\nthe ar.io network consists of ar.io gateway nodes, which are identified by their registered arweave wallet addresses and either their ip addresses or hostnames, as stored in the network\'s smart contract gateway address registry (gar).\n\nthese nodes adhere to the ar.io network protocols, creating a collaborative environment of gateway nodes that vary in scale and specialization. the network ensures a fundamental level of service quality and trust minimization among its participants.\n\nbeing part of the network grants ar.io gateways an array of advantages, such as:\n\n * simplified advertising of services and end user discovery via the gateway address registry.\n\n * more rapid bootstrapping of key gateway operational data due to prioritized data request fulfillment among gateways joined to the network.\n\n * sharing of data processing results.\n\n * access to support channels tailored for operators.\n\n * enhanced trust and transparency through the use of agpl-3 licenses, which mandate public disclosure of any software changes, thereby reinforcing the network\'s integrity and reliability.\n\n * improved network reliability and performance through an incentive protocol, which uses a system of rewards and evaluations to encourage high-quality service from gateways.\n\n\n# gateway address registry (gar)\n\nany gateway operator that whishes to join the ar.io network must register their node in the ar.io smart contract\'s "gateway address registry", known as the gar. registration involves staking a minimum amount of io tokens and providing additional metadata describing the gateway service offered.\n\nafter joining the network, the operator\'s gateway can be easily discovered by permaweb apps, its health can be observed, and it can participate in the ar.io data sharing protocol.\n\nthe gateway operator can modify their gateway\'s gar configuration as needed, which includes adding more tokens to their stake or removing them. operators can completely remove their stake and leave the ar.io network following a minimum network exit wait time. this exit time ensures that gateways cannot quickly escape from an anticipated penalty.\n\nthe gar advertises the specific attributes of each gateway including its stake and settings. this enables permaweb apps and users to discover which gateways are currently available and meet their needs. apps that read the gar can sort and filter it using the gateway metadata, for example, ranking gateways with the highest stake at the top of the list. this would allow users to prefer the lower-trust, higher staked gateways before settling on a higher-trust, lower staked gateway.\n\n\n# staking\n\nstaking tokens serves a dual purpose in the ar.io network:\n\n * it acts as a method of public commitment, and\n\n * it qualifies participants for reward distribution.\n\nin the ar.io network, "staking" designates the act of locking a specified amount of io tokens into a protocol-controlled vault. these tokens act as a form of collateral and public commitment, encouraging network participants to act in the network\'s best interests. once tokens are deposited in the vault, they remain locked until either the participant triggers the "unstake" function or the vault\'s predetermined lock period expires.\n\nit is important to note that unlike other protocols, the io token is non-inflationary. therefore, the staking mechanism in the ar.io network is not designed to function as a yield-generation tool. by staking their tokens, participants become eligible for potential rewards, fostering an atmosphere of mutual trust within the network. specifically, gateway operators stake tokens to facilitate their gateway integration and establish public trust. once connected, they become eligible for rewards driven by the protocol and gain access to the network\'s shared resources.\n\n\n# schema\n\n\n# gateway schema\n\ngateway\nname type description\noperatorstake number the total stake of the gateway\'s operator.\nstart number block number in which the gateway joined the network.\nend number block number in which the gateway can leave the network,\n setting to 0 means no end date.\nstatus string participation status of the gateway, "joined" -\n participating in the network, "hidden" - not leaving, but\n not participating, "leaving" - in the process of withdrawing\n from the network.\nvaults array of objects the locked tokens staked by the gateway operator, view\n schema.\nsettings object additional configuration settings for the gateway, view\n schema.\ndelegates object wallets that have delegated a stake of io tokens to the\n gateway.\ntotaldelegatedstake number the total number of io tokens delegated to the gateway\nobserverwallet string the public address for the wallet being used to sign and\n upload observer reports\nstats object information about the gateways network performance\n\n\n# token vault\n\ntoken vault\nname type description\nbalance number positive integer, the number of io tokens locked.\nstart number block number in which locking starts.\nend number block number in which locking ends. setting to 0 means no\n end date.\n\n\n# gateway settings\n\ngateway settings\nname type required description\nlabel string yes the friendly name used to label the gateway.\nfqdn string yes the fully qualified domain name at which the gateway can be\n reached. e.g. arweave.net\nport number yes the port used by the gateway. e.g. 443\nprotocol string yes web protocol used by this gateway "https", or "http"\nproperties string no an arweave transaction id containing additional properties\n of the gateway.\nnote string no an arweave transaction id containing additional notes the\n gateway operator can set to include things like\n announcements, maintenance, or other operational updates.\nallowdelegatedstaking boolean no the gateway operator can allow or disallow other wallets to\n stake io tokens on the gateway.\ndelegatedrewardshareratio number no the percentage of gateway rewards given to delegated stakers\nautostake boolean no if true, gateway rewards will automatically be added to the\n gateway\'s operator stake',charsets:{}},{title:"Advanced Configuration",frontmatter:{},regularPath:"/gateways/ar-io-node/advanced-config.html",relativePath:"gateways/ar-io-node/advanced-config.md",key:"v-9172688c",path:"/gateways/ar-io-node/advanced-config.html",headers:[{level:2,title:"Overview",slug:"overview",normalizedTitle:"overview",charIndex:29},{level:2,title:"Data Storage Location",slug:"data-storage-location",normalizedTitle:"data storage location",charIndex:685},{level:2,title:"Admin API Key",slug:"admin-api-key",normalizedTitle:"admin api key",charIndex:1390},{level:2,title:"Wallet Association",slug:"wallet-association",normalizedTitle:"wallet association",charIndex:1867},{level:2,title:"Unbundling",slug:"unbundling",normalizedTitle:"unbundling",charIndex:2151},{level:2,title:"Content Moderation",slug:"content-moderation",normalizedTitle:"content moderation",charIndex:2814},{level:2,title:"Contiguous Data Cleanup",slug:"contiguous-data-cleanup",normalizedTitle:"contiguous data cleanup",charIndex:3918},{level:2,title:"ArNS Resolver",slug:"arns-resolver",normalizedTitle:"arns resolver",charIndex:4949}],headersStr:"Overview Data Storage Location Admin API Key Wallet Association Unbundling Content Moderation Contiguous Data Cleanup ArNS Resolver",content:'# Advanced Configuration\n\n\n# Overview\n\nThe Getting Started guides for windows and linux contain all the information needed to start your ar.io Gateway node successfully with basic configurations. There are also ever expanding advanced configuration options that allow you to run your node in a way that is customized to your specific use case.\n\nMost of the below options can be added to your .env file in order to customize its operation. Any changes made to your .env require you to stop the docker containers running your node, and restarting them with the --build flag in order for the changes to take effect. See ENV for a complete list of environmental variables you can set.\n\n\n# Data Storage Location\n\nYou can set a custom location for your AR.IO Gateway to save the data it pulls from the Arweave network. There are three primary types of data stored, and you can set a unique storage location for each of these independently. These are "chunks data", "contiguous data", and "headers data". The custom location for each of these can be set in your .env file like this:\n\nCHUNKS_DATA_PATH=\nCONTIGUOUS_DATA_PATH=\nHEADERS_DATA_PATH=\n\n\nBe sure to replace "" with the path to the location where you would like the data stored. If these values are omitted, the data will be stored in the "data" directory inside your Gateway code repository.\n\n\n# Admin API Key\n\nHTTP endpoints under "/ar-io/admin" are protected by an admin API key. These endpoints allow you to get certain analytics data or make adjustments to your node as it\'s running. When your node starts, it reads your environmental variables to see if a key is set. If not, a random key is generated. The key name is ADMIN_API_KEY and it should be set in your .env file like this:\n\nADMIN_API_KEY=SUPER_SECRET_PASSWORD\n\n\nView examples of the admin endpoints here\n\n\n# Wallet Association\n\nIn order to participate in the greater ar.io network, Gateway nodes need to associate themselves with an Arweave wallet. This can be configured by setting the AR_IO_WALLET key value in your .env file.\n\nAR_IO_WALLET=1seRanklLU_1VTGowDZdD7s_-7k1qowT6oeFZHUZiZo\n\n\n\n# Unbundling\n\nAR.IO Gateway nodes support unbundling and indexing ANS-104 bundle data. This is disabled by default, but can be turned on with several different configuration options. You can set these configurations with the ANS104_UNBUNDLE_FILTER and ANS104_INDEX_FILTER keys in your .env:\n\nANS104_UNBUNDLE_FILTER=""\nANS104_INDEX_FILTER=""\n\n\nThe following types of filters are supported:\n\n{ "never": true } # the default\n{ "always": true }\n{ "attributes": { "owner": , ... }}\n{ "tags": [{ "name": , "value": }, ...]}\n{ "and": [ , ... ]}\n{ "or": [ , ... ]}\n\n\n\n# Content Moderation\n\nYou are able to set your Gateway to block specific transactions or data-items you don\'t want to serve. Unlike previous configuration options in this list, blocking content can be achieved without the need to add to your .env file and rebuild your Gateway. Instead, make a PUT request to your Gateway at /ar-io/admin/block-data. As this is an admin endpoint, you will need to have configured your ADMIN_API_KEY. Using curl as an example, the request should be formatted as follows:\n\ncurl -X PUT -H "Authorization: Bearer " \\\n -H "Content-Type: application/json" \\\n "http://:/ar-io/admin/block-data" \\\n -d \'{ "id": "", "notes": "Example notes", "source": "Example source" }\'\n\n\n * id (string): This will be the transaction ID of the content you want to add to your block list.\n * notes (string): Internal notes regarding why a particular ID is blocked.\n * source (string): Identifier of a particular source of IDs to block. (e.g. the name of a block list)\n\nnotes and source are used for documentation only, and have no effect on your block list itself.\n\n\n# Contiguous Data Cleanup\n\nTransaction data on Arweave is stored in a chunked manner. It is commonly retrieved, however, in the the transaction data\'s original, contiguous form with all of its component chunks assembled end-to-end. Gateways cache contiguous representations of the transaction data to assist in various workloads, including serving transaction data to clients, allowing for efficient utilization of valuable system resources. Gateway operators will need to determine for themselves the best balance between disk space and other resource usage based on the size of their gateway and their particular use case.\n\nContiguous data cache cleanup can be enabled using the CONTIGUOUS_DATA_CACHE_CLEANUP_THRESHOLD environmental variable. This variable sets the number of seconds from the creation of a file in the contiguous data cache after which that file will be deleted. For example:\n\nCONTIGUOUS_DATA_CACHE_CLEANUP_THRESHOLD=10000\n\n\nwill clear items from the contiguous data cache after ten thousand (10,000) seconds.\n\n\n# ArNS Resolver\n\nGateways, by default, forward requests to resolve ArNS names to arweave.dev. Starting with Release 9 gateways can instead build and maintain their own local cache. Doing so removes external dependencies and allows faster resolution.\n\nView the code for the ArNS resolver service here: https://github.com/ar-io/arns-resolver\n\nNOTE: The ArNS resolver is still an experimental feature. It is possible it may behave in unexpected ways when presented with rare edge case scenarios.\n\nIn order to enable the local ArNS resolver, three environmental variables will need to be set:\n\nRUN_RESOLVER=true\nTRUSTED_ARNS_RESOLVER_TYPE=resolver\nTRUSTED_ARNS_RESOLVER_URL=http://resolver:6000\n\n\n * RUN_RESOLVER is a boolean representing an on/off switch for the local resolver.\n * TRUSTED_ARNS_RESOLVER_TYPE sets the method the gateway uses for resolving ArNS names. Use resolver for the local resolver, or gateway for default functionality.\n * TRUSTED_ARNS_RESOLVER_URL is the url a gateway will use to request ArNS name resolution.',normalizedContent:'# advanced configuration\n\n\n# overview\n\nthe getting started guides for windows and linux contain all the information needed to start your ar.io gateway node successfully with basic configurations. there are also ever expanding advanced configuration options that allow you to run your node in a way that is customized to your specific use case.\n\nmost of the below options can be added to your .env file in order to customize its operation. any changes made to your .env require you to stop the docker containers running your node, and restarting them with the --build flag in order for the changes to take effect. see env for a complete list of environmental variables you can set.\n\n\n# data storage location\n\nyou can set a custom location for your ar.io gateway to save the data it pulls from the arweave network. there are three primary types of data stored, and you can set a unique storage location for each of these independently. these are "chunks data", "contiguous data", and "headers data". the custom location for each of these can be set in your .env file like this:\n\nchunks_data_path=\ncontiguous_data_path=\nheaders_data_path=\n\n\nbe sure to replace "" with the path to the location where you would like the data stored. if these values are omitted, the data will be stored in the "data" directory inside your gateway code repository.\n\n\n# admin api key\n\nhttp endpoints under "/ar-io/admin" are protected by an admin api key. these endpoints allow you to get certain analytics data or make adjustments to your node as it\'s running. when your node starts, it reads your environmental variables to see if a key is set. if not, a random key is generated. the key name is admin_api_key and it should be set in your .env file like this:\n\nadmin_api_key=super_secret_password\n\n\nview examples of the admin endpoints here\n\n\n# wallet association\n\nin order to participate in the greater ar.io network, gateway nodes need to associate themselves with an arweave wallet. this can be configured by setting the ar_io_wallet key value in your .env file.\n\nar_io_wallet=1serankllu_1vtgowdzdd7s_-7k1qowt6oefzhuzizo\n\n\n\n# unbundling\n\nar.io gateway nodes support unbundling and indexing ans-104 bundle data. this is disabled by default, but can be turned on with several different configuration options. you can set these configurations with the ans104_unbundle_filter and ans104_index_filter keys in your .env:\n\nans104_unbundle_filter=""\nans104_index_filter=""\n\n\nthe following types of filters are supported:\n\n{ "never": true } # the default\n{ "always": true }\n{ "attributes": { "owner": , ... }}\n{ "tags": [{ "name": , "value": }, ...]}\n{ "and": [ , ... ]}\n{ "or": [ , ... ]}\n\n\n\n# content moderation\n\nyou are able to set your gateway to block specific transactions or data-items you don\'t want to serve. unlike previous configuration options in this list, blocking content can be achieved without the need to add to your .env file and rebuild your gateway. instead, make a put request to your gateway at /ar-io/admin/block-data. as this is an admin endpoint, you will need to have configured your admin_api_key. using curl as an example, the request should be formatted as follows:\n\ncurl -x put -h "authorization: bearer " \\\n -h "content-type: application/json" \\\n "http://:/ar-io/admin/block-data" \\\n -d \'{ "id": "", "notes": "example notes", "source": "example source" }\'\n\n\n * id (string): this will be the transaction id of the content you want to add to your block list.\n * notes (string): internal notes regarding why a particular id is blocked.\n * source (string): identifier of a particular source of ids to block. (e.g. the name of a block list)\n\nnotes and source are used for documentation only, and have no effect on your block list itself.\n\n\n# contiguous data cleanup\n\ntransaction data on arweave is stored in a chunked manner. it is commonly retrieved, however, in the the transaction data\'s original, contiguous form with all of its component chunks assembled end-to-end. gateways cache contiguous representations of the transaction data to assist in various workloads, including serving transaction data to clients, allowing for efficient utilization of valuable system resources. gateway operators will need to determine for themselves the best balance between disk space and other resource usage based on the size of their gateway and their particular use case.\n\ncontiguous data cache cleanup can be enabled using the contiguous_data_cache_cleanup_threshold environmental variable. this variable sets the number of seconds from the creation of a file in the contiguous data cache after which that file will be deleted. for example:\n\ncontiguous_data_cache_cleanup_threshold=10000\n\n\nwill clear items from the contiguous data cache after ten thousand (10,000) seconds.\n\n\n# arns resolver\n\ngateways, by default, forward requests to resolve arns names to arweave.dev. starting with release 9 gateways can instead build and maintain their own local cache. doing so removes external dependencies and allows faster resolution.\n\nview the code for the arns resolver service here: https://github.com/ar-io/arns-resolver\n\nnote: the arns resolver is still an experimental feature. it is possible it may behave in unexpected ways when presented with rare edge case scenarios.\n\nin order to enable the local arns resolver, three environmental variables will need to be set:\n\nrun_resolver=true\ntrusted_arns_resolver_type=resolver\ntrusted_arns_resolver_url=http://resolver:6000\n\n\n * run_resolver is a boolean representing an on/off switch for the local resolver.\n * trusted_arns_resolver_type sets the method the gateway uses for resolving arns names. use resolver for the local resolver, or gateway for default functionality.\n * trusted_arns_resolver_url is the url a gateway will use to request arns name resolution.',charsets:{}},{title:"AR.IO HTTP API Admin Endpoints",frontmatter:{},regularPath:"/gateways/ar-io-node/admin/admin-api.html",relativePath:"gateways/ar-io-node/admin/admin-api.md",key:"v-48851acc",path:"/gateways/ar-io-node/admin/admin-api.html",headers:[{level:2,title:"Overview",slug:"overview",normalizedTitle:"overview",charIndex:37},{level:2,title:"Debug",slug:"debug",normalizedTitle:"debug",charIndex:648},{level:2,title:"Queue Transaction",slug:"queue-transaction",normalizedTitle:"queue transaction",charIndex:1756},{level:2,title:"Block Data",slug:"block-data",normalizedTitle:"block data",charIndex:2297}],headersStr:"Overview Debug Queue Transaction Block Data",content:'# AR.IO HTTP API Admin Endpoints\n\n\n# Overview\n\nThe AR.IO HTTP API offers several endpoints that allow access to internal information and the ability to make adjustments without restarting your Gateway. Each of these endpoints behind /ar-io/admin/ have access restricted, so you will need to have set up your ADMIN_API_KEY variable and include "Authorization: "Bearer ${ADMIN_API_KEY}" in the header of your request.\n\nWhen testing endpoints at /api-docs, you can enter your ADMIN_API_KEY using the green "Authorize" button near the top of the page, or by clicking any of the open lock icons next to a password protected end point.\n\n\n# Debug\n\nThe ar-io/admin/debug endpoint provides a comprehensive view of the current state of your Gateway. This endpoint has been designed to offer developers and administrators insights into the operational status of the gateway, including any errors or warnings that have occurred since the last startup.\n\nExample response\n\n{\n db: {\n counts: {\n wallets: 137,\n tagNames: 61,\n tagValues: 892,\n stableTxs: 0,\n stableBlocks: 0,\n stableBlockTxs: 0,\n missingStableBlocks: 0,\n missingStableTxs: 0,\n missingTxs: 0,\n newBlocks: 32,\n newTxs: 4436,\n bundleCount: 159,\n bundleDataItems: 0,\n matcheDataItems: 0,\n dataItems: 0,\n nestedDataItems: null\n },\n heights: { minStable: -1, maxStable: -1, minNew: 1000000, maxNew: 1000031 },\n timestamps: {\n now: 1692230403,\n maxBundleQueuedAt: -1,\n maxBundleSkippedAt: 1692230390,\n maxBundleUnbundledAt: -1,\n maxBundleFullyIndexedAt: -1,\n maxNewDataItemIndexedAt: -1,\n maxStableDataItemIndexedAt: -1\n },\n errors: [],\n warnings: []\n }\n}\n\n\n\n# Queue Transaction\n\nThe ar-io/admin/queue-tx endpoint allows you to prioritize processing of a specific transaction, based on that transaction\'s ID. The id key must be set in the body of your request, and a POST request should be used.\n\nThis endpoint will also enable you to prioritize opening and indexing bundles by providing the L1 TX ID for the bundle, but only if your Gateway is operating with the ANS104_UNBUNDLE_FILTER and ANS104_INDEX_FILTER keys set.\n\nYour Gateway will either respond with an error, or { message: \'TX queued\' }\n\n\n# Block Data\n\nThe ar-io/admin/block-data endpoint allows you to tell your Gateway to refuse to serve certain data. In order to add to this block list, make a PUT request to this endpoint with the following in the body:\n\n{\n "id": "",\n "notes": "Example notes",\n "source": "Example source"\n}\n\n\n * id: This should be the transaction id of the content you want to block.\n * notes: Notes regarding the reason this content was blocked. For documentation purposes only.\n * source: Identifier for the source of TX IDs you are blocking. For example, the name of a public block list. For documentation purposes only.\n\nYour Gateway will either respond with an error, or { message: \'Content blocked\' }',normalizedContent:'# ar.io http api admin endpoints\n\n\n# overview\n\nthe ar.io http api offers several endpoints that allow access to internal information and the ability to make adjustments without restarting your gateway. each of these endpoints behind /ar-io/admin/ have access restricted, so you will need to have set up your admin_api_key variable and include "authorization: "bearer ${admin_api_key}" in the header of your request.\n\nwhen testing endpoints at /api-docs, you can enter your admin_api_key using the green "authorize" button near the top of the page, or by clicking any of the open lock icons next to a password protected end point.\n\n\n# debug\n\nthe ar-io/admin/debug endpoint provides a comprehensive view of the current state of your gateway. this endpoint has been designed to offer developers and administrators insights into the operational status of the gateway, including any errors or warnings that have occurred since the last startup.\n\nexample response\n\n{\n db: {\n counts: {\n wallets: 137,\n tagnames: 61,\n tagvalues: 892,\n stabletxs: 0,\n stableblocks: 0,\n stableblocktxs: 0,\n missingstableblocks: 0,\n missingstabletxs: 0,\n missingtxs: 0,\n newblocks: 32,\n newtxs: 4436,\n bundlecount: 159,\n bundledataitems: 0,\n matchedataitems: 0,\n dataitems: 0,\n nesteddataitems: null\n },\n heights: { minstable: -1, maxstable: -1, minnew: 1000000, maxnew: 1000031 },\n timestamps: {\n now: 1692230403,\n maxbundlequeuedat: -1,\n maxbundleskippedat: 1692230390,\n maxbundleunbundledat: -1,\n maxbundlefullyindexedat: -1,\n maxnewdataitemindexedat: -1,\n maxstabledataitemindexedat: -1\n },\n errors: [],\n warnings: []\n }\n}\n\n\n\n# queue transaction\n\nthe ar-io/admin/queue-tx endpoint allows you to prioritize processing of a specific transaction, based on that transaction\'s id. the id key must be set in the body of your request, and a post request should be used.\n\nthis endpoint will also enable you to prioritize opening and indexing bundles by providing the l1 tx id for the bundle, but only if your gateway is operating with the ans104_unbundle_filter and ans104_index_filter keys set.\n\nyour gateway will either respond with an error, or { message: \'tx queued\' }\n\n\n# block data\n\nthe ar-io/admin/block-data endpoint allows you to tell your gateway to refuse to serve certain data. in order to add to this block list, make a put request to this endpoint with the following in the body:\n\n{\n "id": "",\n "notes": "example notes",\n "source": "example source"\n}\n\n\n * id: this should be the transaction id of the content you want to block.\n * notes: notes regarding the reason this content was blocked. for documentation purposes only.\n * source: identifier for the source of tx ids you are blocking. for example, the name of a public block list. for documentation purposes only.\n\nyour gateway will either respond with an error, or { message: \'content blocked\' }',charsets:{}},{title:"AR.IO HTTP API",frontmatter:{},regularPath:"/gateways/ar-io-node/api.html",relativePath:"gateways/ar-io-node/api.md",key:"v-172dfc5a",path:"/gateways/ar-io-node/api.html",headersStr:null,content:"# AR.IO HTTP API\n\nUp to date documentation of endpoints for the AR.IO HTTP API used to access your Gateway can be found here.\n\nYou can also view endpoint documentation and test the endpoints against your own Gateway by going to /api-docs",normalizedContent:"# ar.io http api\n\nup to date documentation of endpoints for the ar.io http api used to access your gateway can be found here.\n\nyou can also view endpoint documentation and test the endpoints against your own gateway by going to /api-docs",charsets:{}},{title:"Bundler",frontmatter:{permalink:"/gateways/bundler"},regularPath:"/gateways/ar-io-node/bundler.html",relativePath:"gateways/ar-io-node/bundler.md",key:"v-d314c1cc",path:"/gateways/bundler/",headers:[{level:2,title:"Overview",slug:"overview",normalizedTitle:"overview",charIndex:14},{level:2,title:"Getting Started",slug:"getting-started",normalizedTitle:"getting started",charIndex:806},{level:3,title:"Environmental Variables",slug:"environmental-variables",normalizedTitle:"environmental variables",charIndex:1084},{level:3,title:"Managing Bundler Access",slug:"managing-bundler-access",normalizedTitle:"managing bundler access",charIndex:2529},{level:3,title:"Indexing",slug:"indexing",normalizedTitle:"indexing",charIndex:3895},{level:2,title:"Starting and Stopping the Bundler",slug:"starting-and-stopping-the-bundler",normalizedTitle:"starting and stopping the bundler",charIndex:5586},{level:3,title:"Starting",slug:"starting",normalizedTitle:"starting",charIndex:5586},{level:3,title:"Stopping",slug:"stopping",normalizedTitle:"stopping",charIndex:5599},{level:3,title:"logs",slug:"logs",normalizedTitle:"logs",charIndex:6424}],headersStr:"Overview Getting Started Environmental Variables Managing Bundler Access Indexing Starting and Stopping the Bundler Starting Stopping logs",content:"# Bundler\n\n\n# Overview\n\nA Turbo ANS-104 data item bundler can be run alongside an ar.io gateway. This allows gateways the ability to accept data items to be submit to the Arweave blockweave.\n\nThe bundler service can be easily run inside Docker in the same way that the gateway is. It utilizes a separate docker compose file for configuration and deployment, which also allows for the use of a separate file for environmental variables specific to the bundler service. Additionally, the separation allows operators to spin their bundler service up or down at any time without affecting their core gateway service. Despite the use of separate docker compose files, the bundler service shares a docker network with the ar.io gateway, and so is able to directly interact with the gateway service and data.\n\n\n# Getting Started\n\nNOTE: The bundler service relies on GraphQL indexing of recently bundled and uploaded data to manage its pipeline operations. The ar.io gateway should have its indexes synced up to Arweave's current block height before starting the bundler's service stack.\n\n\n# Environmental Variables\n\nEnvironmental variables must be provided for the bundler to function and integrate properly with an existing ar.io gateway. The gateway repository provides a .env.bundler.example file that can be renamed to .env.bundler and used as a starting point. It contains the following:\n\nBUNDLER_ARWEAVE_WALLET='Stringified JWK wallet. e.g: '{ \"n\": \"...\", ... }'\nBUNDLER_ARWEAVE_ADDRESS='Address for above wallet'\n\nAPP_NAME='ar.io bundler service'\n\n# Use localstack s3 bucket for shared data source between ar.io gateway and bundler\nAWS_S3_BUCKET=ar.io\nAWS_S3_PREFIX='data'\nAWS_ACCESS_KEY_ID='test'\nAWS_SECRET_ACCESS_KEY='test'\nAWS_REGION='us-east-1'\nAWS_ENDPOINT='http://localstack:4566'\n\n\n * BUNDLER_ARWEAVE_WALLET must be the entire jwk of an Arweave wallet's keyfile, stringified. All uploads of bundled data items to Arweave will be signed and paid for by this wallet, so it must maintain a balance of AR tokens sufficient to handle the uploads.\n * BUNDLER_ARWEAVE_ADDRESS must be the normalized public address for the provided Arweave wallet.\n * APP_NAME is a GraphQL tag that will be added to uploaded bundles.\n\nThe remaining lines in the .env.bundler.example file control settings that allow the bundler service to share data with the ar.io gateway. Data sharing of contiguous data between a bundler and a gateway allows the gateway to serve optimistically cached data without waiting for it to fully settle on chain.\n\n\n# Managing Bundler Access\n\nBy default, the bundler will only accept data items uploaded by data item signers whose normalized wallet addresses are in the ALLOW_LISTED_ADDRESSES list. This is an additional environmental variable that can be added to your .env.bundler file, and must be a comma separated list of normalized public wallet addresses for wallets that should be allowed to bundle and upload data through your gateway.\n\nALLOW_LISTED_ADDRESSES=,\n\n\nThe following permissioning configurations schemes are also possible:\n\nSCHEME ALLOW_LISTED_ADDRESSES SKIP_BALANCE_CHECKS ALLOW_LISTED_SIGNATURE_TYPES PAYMENT_SERVICE_BASE_URL\nALLOW SPECIFIC WALLETS Comma-separated normalized wallet addresses false EMPTY or supplied EMPTY\nALLOW SPECIFIC CHAINS EMPTY or supplied false arbundles sigtype int EMPTY\nALLOW ALL n/a true n/a n/a\nALLOW NONE EMPTY false EMPTY EMPTY\nALLOW PAYERS EMPTY or supplied false EMPTY or supplied Your payment service url\n\n\n# Indexing\n\nBundlers submit data to the Arweave network as an ANS-104 data item bundle. This means it is several transactions wrapped into one. A gateway will need to unbundle these transactions in order to index them. A gateway should include the following ANS-104 filters in order to unbundle and index transactions from a particular bundler:\n\nANS104_INDEX_FILTER={ \"always\": true }\nANS104_UNBUNDLE_FILTER={ \"attributes\": { \"owner_address\": \"$BUNDLER_ARWEAVE_ADDRESS\" } }\n\n\n$BUNDLER_ARWEAVE_ADDRESS should be replaced with the normalized public wallet address associated with the bundler.\n\nNOTE: The above filters must be placed in the .env file for the core gateway service, not the bundler.\n\nGateways handle data item indexing asynchronously. This means they establish a queue of items to index, and work on processing the queue in the background while the gateway continues with its normal operations. If a gateway has broad indexing filters, there can be some latency in indexing data items from the bundler while the gateway works through its queue.\n\n# Optimistic Indexing\n\nGateway operators control access to their optimistic data item indexing API via an admin key that must be supplied by all bundling clients in order for their requests to be accepted. This key should be made available in the environment configuration files for BOTH the core gateway, and the bundler, and should be provided as AR_IO_ADMIN_KEY:\n\nAR_IO_ADMIN_KEY=\"Admin password\"\n\n\nNOTE: If a gateway is started without providing the admin key, a random string will be generated to protect the gateway's admin endpoints. This can be reset by restarting the gateway with the admin key provided in the .env file.\n\n\n# Starting and Stopping the Bundler\n\n\n# Starting\n\nThe bundler service is designed to run in conjunction with an ar.io gateway, and so relies on the ar-io-network network created in Docker when the core gateway services are spun up. It is possible to spin up the bundler while the core services are down, but the network must exist in Docker.\n\nTo start the bundler, specify the env and docker-compose files being used in a docker compose up command:\n\ndocker compose --env-file ./.env.bundler --file docker-compose.bundler.yaml up -d\n\n\nThe -d flag runs the command in \"detached\" mode, so it will run in the background without requiring the terminal to remain active.\n\n\n# Stopping\n\nTo spin the bundler service down, specify the docker-compose file in a docker compose down command:\n\ndocker compose --file docker-compose.bundler.yaml down\n\n\n\n# logs\n\nWhile the bundler service is running in detached mode, logs can be checked by specifying the docker-compose file in a docker compose logs command:\n\ndocker compose --file docker-compose.bundler.yaml logs -f --tail=0\n\n\n * -f runs the command in \"follow\" mode, so the terminal will continue to watch and display new logs.\n * --tail= defines the number of logs to display that existed prior to running the command. 0 displays only new logs.",normalizedContent:"# bundler\n\n\n# overview\n\na turbo ans-104 data item bundler can be run alongside an ar.io gateway. this allows gateways the ability to accept data items to be submit to the arweave blockweave.\n\nthe bundler service can be easily run inside docker in the same way that the gateway is. it utilizes a separate docker compose file for configuration and deployment, which also allows for the use of a separate file for environmental variables specific to the bundler service. additionally, the separation allows operators to spin their bundler service up or down at any time without affecting their core gateway service. despite the use of separate docker compose files, the bundler service shares a docker network with the ar.io gateway, and so is able to directly interact with the gateway service and data.\n\n\n# getting started\n\nnote: the bundler service relies on graphql indexing of recently bundled and uploaded data to manage its pipeline operations. the ar.io gateway should have its indexes synced up to arweave's current block height before starting the bundler's service stack.\n\n\n# environmental variables\n\nenvironmental variables must be provided for the bundler to function and integrate properly with an existing ar.io gateway. the gateway repository provides a .env.bundler.example file that can be renamed to .env.bundler and used as a starting point. it contains the following:\n\nbundler_arweave_wallet='stringified jwk wallet. e.g: '{ \"n\": \"...\", ... }'\nbundler_arweave_address='address for above wallet'\n\napp_name='ar.io bundler service'\n\n# use localstack s3 bucket for shared data source between ar.io gateway and bundler\naws_s3_bucket=ar.io\naws_s3_prefix='data'\naws_access_key_id='test'\naws_secret_access_key='test'\naws_region='us-east-1'\naws_endpoint='http://localstack:4566'\n\n\n * bundler_arweave_wallet must be the entire jwk of an arweave wallet's keyfile, stringified. all uploads of bundled data items to arweave will be signed and paid for by this wallet, so it must maintain a balance of ar tokens sufficient to handle the uploads.\n * bundler_arweave_address must be the normalized public address for the provided arweave wallet.\n * app_name is a graphql tag that will be added to uploaded bundles.\n\nthe remaining lines in the .env.bundler.example file control settings that allow the bundler service to share data with the ar.io gateway. data sharing of contiguous data between a bundler and a gateway allows the gateway to serve optimistically cached data without waiting for it to fully settle on chain.\n\n\n# managing bundler access\n\nby default, the bundler will only accept data items uploaded by data item signers whose normalized wallet addresses are in the allow_listed_addresses list. this is an additional environmental variable that can be added to your .env.bundler file, and must be a comma separated list of normalized public wallet addresses for wallets that should be allowed to bundle and upload data through your gateway.\n\nallow_listed_addresses=,\n\n\nthe following permissioning configurations schemes are also possible:\n\nscheme allow_listed_addresses skip_balance_checks allow_listed_signature_types payment_service_base_url\nallow specific wallets comma-separated normalized wallet addresses false empty or supplied empty\nallow specific chains empty or supplied false arbundles sigtype int empty\nallow all n/a true n/a n/a\nallow none empty false empty empty\nallow payers empty or supplied false empty or supplied your payment service url\n\n\n# indexing\n\nbundlers submit data to the arweave network as an ans-104 data item bundle. this means it is several transactions wrapped into one. a gateway will need to unbundle these transactions in order to index them. a gateway should include the following ans-104 filters in order to unbundle and index transactions from a particular bundler:\n\nans104_index_filter={ \"always\": true }\nans104_unbundle_filter={ \"attributes\": { \"owner_address\": \"$bundler_arweave_address\" } }\n\n\n$bundler_arweave_address should be replaced with the normalized public wallet address associated with the bundler.\n\nnote: the above filters must be placed in the .env file for the core gateway service, not the bundler.\n\ngateways handle data item indexing asynchronously. this means they establish a queue of items to index, and work on processing the queue in the background while the gateway continues with its normal operations. if a gateway has broad indexing filters, there can be some latency in indexing data items from the bundler while the gateway works through its queue.\n\n# optimistic indexing\n\ngateway operators control access to their optimistic data item indexing api via an admin key that must be supplied by all bundling clients in order for their requests to be accepted. this key should be made available in the environment configuration files for both the core gateway, and the bundler, and should be provided as ar_io_admin_key:\n\nar_io_admin_key=\"admin password\"\n\n\nnote: if a gateway is started without providing the admin key, a random string will be generated to protect the gateway's admin endpoints. this can be reset by restarting the gateway with the admin key provided in the .env file.\n\n\n# starting and stopping the bundler\n\n\n# starting\n\nthe bundler service is designed to run in conjunction with an ar.io gateway, and so relies on the ar-io-network network created in docker when the core gateway services are spun up. it is possible to spin up the bundler while the core services are down, but the network must exist in docker.\n\nto start the bundler, specify the env and docker-compose files being used in a docker compose up command:\n\ndocker compose --env-file ./.env.bundler --file docker-compose.bundler.yaml up -d\n\n\nthe -d flag runs the command in \"detached\" mode, so it will run in the background without requiring the terminal to remain active.\n\n\n# stopping\n\nto spin the bundler service down, specify the docker-compose file in a docker compose down command:\n\ndocker compose --file docker-compose.bundler.yaml down\n\n\n\n# logs\n\nwhile the bundler service is running in detached mode, logs can be checked by specifying the docker-compose file in a docker compose logs command:\n\ndocker compose --file docker-compose.bundler.yaml logs -f --tail=0\n\n\n * -f runs the command in \"follow\" mode, so the terminal will continue to watch and display new logs.\n * --tail= defines the number of logs to display that existed prior to running the command. 0 displays only new logs.",charsets:{}},{title:"Observation and Incentives",frontmatter:{permalink:"/gateways/ar-io-node/arnsoip/observer/",next:!1},regularPath:"/gateways/ar-io-node/arnsoip/observer.html",relativePath:"gateways/ar-io-node/arnsoip/observer.md",key:"v-30ab1e90",path:"/gateways/ar-io-node/arnsoip/observer/",headers:[{level:2,title:"Overview",slug:"overview",normalizedTitle:"overview",charIndex:33},{level:2,title:"Observation Protocol",slug:"observation-protocol",normalizedTitle:"observation protocol",charIndex:1637},{level:2,title:"Onchain Reports",slug:"onchain-reports",normalizedTitle:"onchain reports",charIndex:3280},{level:2,title:"Selection of Observers",slug:"selection-of-observers",normalizedTitle:"selection of observers",charIndex:4861},{level:3,title:"Criteria for Selection",slug:"criteria-for-selection",normalizedTitle:"criteria for selection",charIndex:5247},{level:3,title:"Weight Calculation and Normalization",slug:"weight-calculation-and-normalization",normalizedTitle:"weight calculation and normalization",charIndex:6711},{level:3,title:"Random Selection Process",slug:"random-selection-process",normalizedTitle:"random selection process",charIndex:7303},{level:2,title:"Performance Evaluation",slug:"performance-evaluation",normalizedTitle:"performance evaluation",charIndex:7827},{level:2,title:"Reward Distribution",slug:"reward-distribution",normalizedTitle:"reward distribution",charIndex:9101},{level:3,title:"Distribution Based on Performance",slug:"distribution-based-on-performance",normalizedTitle:"distribution based on performance",charIndex:9713},{level:3,title:"Undistributed Rewards",slug:"undistributed-rewards",normalizedTitle:"undistributed rewards",charIndex:10434},{level:2,title:"Handling Inactive Gateways",slug:"handling-inactive-gateways",normalizedTitle:"handling inactive gateways",charIndex:10827},{level:2,title:"Observer Report Details",slug:"observer-report-details",normalizedTitle:"observer report details",charIndex:11201},{level:2,title:"General Information",slug:"general-information",normalizedTitle:"general information",charIndex:3904},{level:2,title:"Overall Gateway Operator Assessment",slug:"overall-gateway-operator-assessment",normalizedTitle:"overall gateway operator assessment",charIndex:11556},{level:2,title:"ArNS Assessments",slug:"arns-assessments",normalizedTitle:"arns assessments",charIndex:11882},{level:2,title:"Example Observation Report",slug:"example-observation-report",normalizedTitle:"example observation report",charIndex:12684},{level:2,title:"Viewing Observation Reports",slug:"viewing-observation-reports",normalizedTitle:"viewing observation reports",charIndex:12780},{level:3,title:"example",slug:"example",normalizedTitle:"example",charIndex:13056}],headersStr:"Overview Observation Protocol Onchain Reports Selection of Observers Criteria for Selection Weight Calculation and Normalization Random Selection Process Performance Evaluation Reward Distribution Distribution Based on Performance Undistributed Rewards Handling Inactive Gateways Observer Report Details General Information Overall Gateway Operator Assessment ArNS Assessments Example Observation Report Viewing Observation Reports example",content:"# Observation and Incentives\n\n\n# Overview\n\nThe Observation and Incentive Protocol is designed to maintain and enhance the operational integrity of gateways on the AR.IO Network. It achieves this through a combination of incentivizing gateways for good performance and tasking those gateways to fulfill the role of \"observers\". The protocol is intentionally simple and adaptable, employing a smart contract-based method for onchain “voting” to assess peer performance while being flexible on how that performance is measured. This setup permits gateway and observer nodes to experiment and evolve best practices for performance evaluation, all while operating within the bounds of the network's immutable smart contract, thus eliminating the need for frequent contract updates (forks).\n\nIn this protocol, observers evaluate their gateway peers' performance to resolve ArNS names. Their aim is to ensure each gateway in the network accurately resolves a subset of names and assigning a pass / fail score based on their findings.\n\nA key component of the protocol is its reward mechanism. This system is predicated on gateway performance and compliance with observation duties. Gateways that excel are tagged as \"Functional Gateways\" and earn rewards, while those that do not meet the criteria, “Deficient Gateways” risk facing penalties – namely, the lack of rewards.\n\nFunds for incentive rewards are derived from the protocol balance, which consists of IO tokens collected from ArNS asset purchases. Every epoch, this balance is utilized to distribute rewards to qualifying gateways and observers based on certain performance metrics.\n\n\n# Observation Protocol\n\nThe Observation protocol is organized around epochs, periods of time that are broken into an observation reporting and tallying phase. The protocol is followed across each epoch, promoting consistent healthy network activity that can form pro-social behaviors and react to malicious circumstances.\n\nObservation and Incentive Protocol\n * To participate in the epoch, a gateway must have already staked IO tokens and joined the network before it starts.\n * Each epoch (approximately 7 block-days), a random pool of active gateways will be selected (prescribed) to perform observation duties.\n * Within the epoch, observers are tasked with evaluating a subset of ArNS names for each gateway in the network.\n * By the end of the epoch’s observation reporting period, the observer must upload its standardized health observation report to Arweave.\n * The observer must also submit an interaction to the AR.IO contract to save its report transaction ID and a summary of all failed gateways for tallying by the incentive protocol.\n * After the observation reporting period and tallying periods have closed, the payout is performed on the next contract state tick.\n * This payout rewards gateways and observers who have performed their duties.\n * Gateways that did not meet the performance threshold will not receive rewards.\n * Observers that did not perform their duties are not rewarded and in addition, are penalized on any gateway rewards received.\n * Community builders and application users can verify and leverage the report and distribution information to make more informed decisions on which gateway to use.\n\n\n# Onchain Reports\n\nThe to-be-evaluated ArNS names include a set of names randomly determined by the protocol, known as “prescribed names”, which are common across all observers within the epoch, as well as a set of “chosen names” picked at the discretion of each individual observer. “Prescribed names” are assigned to act as a common denominator / baseline while “chosen names” allow each observer to evaluate names that may be important to their operation.\n\nEach observer shall assess the performance of the selected ArNS names (across all gateways) and summarize those findings in a report which details the following:\n\n * General Information: Observer's Arweave address, starting and concluding block heights for the epoch.\n\n * Gateway Operator Assessment: The expected and actual Arweave addresses of observed gateways, along with a summary verdict (pass or fail), and accompanying reasons for failure.\n\n * Detailed ArNS Evaluations: For each gateway, it includes the domain name, evaluated ArNS names, the associated block height, transaction IDs, data hashes, a \"pass or fail\" score, reasons for failure (if any), and performance metrics like time to the first byte.\n\nA comprehensive list of report criteria can be found in the Appendix.\n\nObservers shall upload their completed reports (in JSON format) to the Arweave network as an onchain audit trail. In addition, observers shall submit an interaction to the AR.IO smart contact detailing each gateway that they observed to have “failed” their assessments. This is tallied and used to determine the reward distribution.\n\n\n# Selection of Observers\n\nThe observer selection process employs a random-weighted selection method. By combining random selection with weighted criteria like stake, tenure, and past rewards, the process aims to ensure both fairness and acknowledgment of consistent performance. This method allows for a systematic yet randomized approach to selecting gateways for observation tasks.\n\n\n# Criteria for Selection\n\nUp to 50 gateways can be chosen as observers per epoch. If the GAR contains 50 or fewer gateways, then every gateway is designated as an observer for that epoch. If there are greater than 50, then randomized selection shall be utilized.\n\nThe weighted selection criteria will consider the following for each gateway:\n\n * Stake Weight (SW): This factor considers how financially committed a gateway is to the network. It is the ratio of the amount of IO tokens staked by the gateway relative to the network minimum and is expressed as SW = Gateway Stake / Minimum Stake.\n\n * Tenure Weight (TW): This factor considers how long a gateway has been part of the network, with a maximum value capped at 4. It is calculated as TW = Gateway Network Tenure / 6 block-months. This means that the maximum value is achieved after 2 block-years of participation in the network.\n\n * Gateway Reward Ratio Weight (GRRW): This factor is a proxy for a gateway’s performance at resolving ArNS names. The weight represents the ratio of epochs in which a gateway received rewards for correctly resolving names relative to their total time on the network.\n\n * Observer Reward Ratio Weight (ORRW): This factor is a proxy for a gateway’s performance at fulfilling observation duties. The weight reflects the ratio of epochs in which a gateway, as an observer, successfully submitted observation reports relative to their total periods of service as an observer.\n\n\n# Weight Calculation and Normalization\n\nFor each gateway, a composite weight (CW) is computed, combining the Stake Weight, Tenure Weight, Gateway Reward Ratio Weight, and Observer Reward Ratio Weight.\n\nThe formula used is: CW = SW x TW x GRRW x ORRW.\n\nThese weights are then normalized across the network to create a continuous range, allowing for proportional random selection based on the weighted scores. The normalized composite weight (N_CW) for each gateway indicates its likelihood of being chosen as an observer and is calculated by dividing the gateway's CW by the sum of all CWs.\n\n\n# Random Selection Process\n\nThe selection of observers is randomized within the framework of these weights. A set of unique random numbers is generated within the total range of normalized weights. For each random number, the gateway whose normalized weight range encompasses this number is selected. This system ensures that while gateways with higher weights are more likely to be chosen, all gateways maintain a non-zero chance of selection, preserving both fairness and meritocracy in the observer assignment process.\n\n\n# Performance Evaluation\n\nConsider the following classifications:\n\n * Functional or Passed Gateways: are gateways that meet or surpass the network’s performance and quality standards.\n\n * Deficient or Failed Gateways: are gateways that fall short of the network's performance expectations.\n\n * Functional or Submitted Observers: are selected observers who diligently perform their duties and submit observation reports and contract interactions.\n\n * Deficient or Failed Observers: are selected observers who do not fulfill their duty of submitting observation reports and contract interactions.\n\nAt the end of an epoch, the smart contract will assess the results from the observers during a “tallying period” and determine a pass / fail score for each gateway:\n\n * If greater than or equal to 50% of submitted observer contract interactions indicate a PASS score, then that gateway is considered Functional and eligible for gateway rewards.\n\n * Else, if greater than 50% of submitted observer contract interactions indicate a FAIL score, then that gateway is considered Deficient and ineligible for gateway rewards.\n\nThese results will determine how reward distributions are made for that epoch. Rewards shall be distributed after the epoch’s tallying period is complete.\n\n\n# Reward Distribution\n\nEach epoch, a defined portion of the protocol balance (e.g., 0.05%) is earmarked for distribution as rewards. From this allocation, two distinct reward categories are derived:\n\n 1. Base Gateway Reward: This is the portion of the reward allocated to each Functional Gateway within the network and is calculated as:\n \n [Epoch Reward Allocation x 90% / Total Gateways in the Network]\n\n 2. Base Observer Reward: Observers, due to their additional responsibilities, have a separate reward calculated as:\n \n [Epoch Reward Allocation x 10% / Total Selected Observers for the Epoch]\n\n\n# Distribution Based on Performance\n\nThe reward distribution is contingent on the performance classifications derived from the Performance Evaluation:\n\n * Functional Gateways: Gateways that meet the performance criteria receive the Base Gateway Reward.\n\n * Deficient Gateways: Gateways falling short in performance do not receive any gateway rewards.\n\n * Functional Observers: Observers that fulfilled their duty receive the Base Observer Reward.\n\n * Deficient Observers: Observers failing to meet their responsibilities do not receive observer rewards. Furthermore, if they are also Functional Gateways, their gateway reward is reduced by 25% for that epoch as a consequence for not performing their observation duty.\n\n\n# Undistributed Rewards\n\nIn cases where rewards are not distributed, either due to the inactivity or deficiency of gateways or observers, the allocated tokens shall remain in the protocol balance and carry forward to the next epoch. This mechanism is in place to discourage observers from frivolously marking their peers as offline in hopes of attaining a higher portion of the reward pool.\n\n\n# Handling Inactive Gateways\n\nTo maintain network efficiency and reduce contract state bloat, gateways that are consistently offline, specifically for thirty (30) consecutive epochs, and thus fail to receive rewards, will be automatically removed from the Gateway Active Registry (GAR) as well as have their staked IO tokens unlocked and returned to the gateway operator.\n\n\n# Observer Report Details\n\nEach observer shall assess the performance of the selected ArNS names (across all AR.IO gateways) and summarize those findings in a report which details the following:\n\n\n# General Information\n\n * The observer's Arweave address.\n * The starting block height of the epoch.\n * The block height at which the report was generated.\n\n\n# Overall Gateway Operator Assessment\n\n * Gateway FQDN.\n * The Arweave address that the observer expects to be the owner / operator of the gateway.\n * The Arweave address that the observed gateway actually reports.\n * A final “pass or fail” rollup determination for each observed gateway.\n * Failure reason (if applicable).\n\n\n# ArNS Assessments\n\n * Observed ArNS name (for all prescribed and chosen names).\n * The block height at which the name was assessed.\n * The expected status code.\n * The resolved status code.\n * The transaction ID that the observer expects the associated name to resolve to.\n * The transaction ID that the gateway actually resolves to.\n * The data hash that the observer expects the associated name to resolve to.\n * The data hash that the gateway actually resolves to.\n * The “pass or fail” score associated with the observed name, at the observer’s discretion.\n * Failure reason (if applicable).\n * Timing / performance information associated with the name resolution such as time to first byte and total duration.\n\nThe above is repeated for the entire name pool and across each gateway in the GAR.\n\n\n# Example Observation Report\n\nhttps://arweave.net/GG1YCFc7wQxKvQ1qD1lTEp2OAMBs4VzrpfdmeeLyjDI\n\n\n# Viewing Observation Reports\n\nYou can easily view an observation report in a human readable format through your terminal with the following command:\n\ncurl -L https://arweave.net/ | zcat | jq .\n\n\nBe sure to replace with the txId of the report you want to view.\n\n\n# example\n\ncurl -L https://arweave.net/H3zDmoDkpOg0U95rejBEq6gUnww_CEVscTuQVqfSbxk | zcat | jq .\n",normalizedContent:"# observation and incentives\n\n\n# overview\n\nthe observation and incentive protocol is designed to maintain and enhance the operational integrity of gateways on the ar.io network. it achieves this through a combination of incentivizing gateways for good performance and tasking those gateways to fulfill the role of \"observers\". the protocol is intentionally simple and adaptable, employing a smart contract-based method for onchain “voting” to assess peer performance while being flexible on how that performance is measured. this setup permits gateway and observer nodes to experiment and evolve best practices for performance evaluation, all while operating within the bounds of the network's immutable smart contract, thus eliminating the need for frequent contract updates (forks).\n\nin this protocol, observers evaluate their gateway peers' performance to resolve arns names. their aim is to ensure each gateway in the network accurately resolves a subset of names and assigning a pass / fail score based on their findings.\n\na key component of the protocol is its reward mechanism. this system is predicated on gateway performance and compliance with observation duties. gateways that excel are tagged as \"functional gateways\" and earn rewards, while those that do not meet the criteria, “deficient gateways” risk facing penalties – namely, the lack of rewards.\n\nfunds for incentive rewards are derived from the protocol balance, which consists of io tokens collected from arns asset purchases. every epoch, this balance is utilized to distribute rewards to qualifying gateways and observers based on certain performance metrics.\n\n\n# observation protocol\n\nthe observation protocol is organized around epochs, periods of time that are broken into an observation reporting and tallying phase. the protocol is followed across each epoch, promoting consistent healthy network activity that can form pro-social behaviors and react to malicious circumstances.\n\nobservation and incentive protocol\n * to participate in the epoch, a gateway must have already staked io tokens and joined the network before it starts.\n * each epoch (approximately 7 block-days), a random pool of active gateways will be selected (prescribed) to perform observation duties.\n * within the epoch, observers are tasked with evaluating a subset of arns names for each gateway in the network.\n * by the end of the epoch’s observation reporting period, the observer must upload its standardized health observation report to arweave.\n * the observer must also submit an interaction to the ar.io contract to save its report transaction id and a summary of all failed gateways for tallying by the incentive protocol.\n * after the observation reporting period and tallying periods have closed, the payout is performed on the next contract state tick.\n * this payout rewards gateways and observers who have performed their duties.\n * gateways that did not meet the performance threshold will not receive rewards.\n * observers that did not perform their duties are not rewarded and in addition, are penalized on any gateway rewards received.\n * community builders and application users can verify and leverage the report and distribution information to make more informed decisions on which gateway to use.\n\n\n# onchain reports\n\nthe to-be-evaluated arns names include a set of names randomly determined by the protocol, known as “prescribed names”, which are common across all observers within the epoch, as well as a set of “chosen names” picked at the discretion of each individual observer. “prescribed names” are assigned to act as a common denominator / baseline while “chosen names” allow each observer to evaluate names that may be important to their operation.\n\neach observer shall assess the performance of the selected arns names (across all gateways) and summarize those findings in a report which details the following:\n\n * general information: observer's arweave address, starting and concluding block heights for the epoch.\n\n * gateway operator assessment: the expected and actual arweave addresses of observed gateways, along with a summary verdict (pass or fail), and accompanying reasons for failure.\n\n * detailed arns evaluations: for each gateway, it includes the domain name, evaluated arns names, the associated block height, transaction ids, data hashes, a \"pass or fail\" score, reasons for failure (if any), and performance metrics like time to the first byte.\n\na comprehensive list of report criteria can be found in the appendix.\n\nobservers shall upload their completed reports (in json format) to the arweave network as an onchain audit trail. in addition, observers shall submit an interaction to the ar.io smart contact detailing each gateway that they observed to have “failed” their assessments. this is tallied and used to determine the reward distribution.\n\n\n# selection of observers\n\nthe observer selection process employs a random-weighted selection method. by combining random selection with weighted criteria like stake, tenure, and past rewards, the process aims to ensure both fairness and acknowledgment of consistent performance. this method allows for a systematic yet randomized approach to selecting gateways for observation tasks.\n\n\n# criteria for selection\n\nup to 50 gateways can be chosen as observers per epoch. if the gar contains 50 or fewer gateways, then every gateway is designated as an observer for that epoch. if there are greater than 50, then randomized selection shall be utilized.\n\nthe weighted selection criteria will consider the following for each gateway:\n\n * stake weight (sw): this factor considers how financially committed a gateway is to the network. it is the ratio of the amount of io tokens staked by the gateway relative to the network minimum and is expressed as sw = gateway stake / minimum stake.\n\n * tenure weight (tw): this factor considers how long a gateway has been part of the network, with a maximum value capped at 4. it is calculated as tw = gateway network tenure / 6 block-months. this means that the maximum value is achieved after 2 block-years of participation in the network.\n\n * gateway reward ratio weight (grrw): this factor is a proxy for a gateway’s performance at resolving arns names. the weight represents the ratio of epochs in which a gateway received rewards for correctly resolving names relative to their total time on the network.\n\n * observer reward ratio weight (orrw): this factor is a proxy for a gateway’s performance at fulfilling observation duties. the weight reflects the ratio of epochs in which a gateway, as an observer, successfully submitted observation reports relative to their total periods of service as an observer.\n\n\n# weight calculation and normalization\n\nfor each gateway, a composite weight (cw) is computed, combining the stake weight, tenure weight, gateway reward ratio weight, and observer reward ratio weight.\n\nthe formula used is: cw = sw x tw x grrw x orrw.\n\nthese weights are then normalized across the network to create a continuous range, allowing for proportional random selection based on the weighted scores. the normalized composite weight (n_cw) for each gateway indicates its likelihood of being chosen as an observer and is calculated by dividing the gateway's cw by the sum of all cws.\n\n\n# random selection process\n\nthe selection of observers is randomized within the framework of these weights. a set of unique random numbers is generated within the total range of normalized weights. for each random number, the gateway whose normalized weight range encompasses this number is selected. this system ensures that while gateways with higher weights are more likely to be chosen, all gateways maintain a non-zero chance of selection, preserving both fairness and meritocracy in the observer assignment process.\n\n\n# performance evaluation\n\nconsider the following classifications:\n\n * functional or passed gateways: are gateways that meet or surpass the network’s performance and quality standards.\n\n * deficient or failed gateways: are gateways that fall short of the network's performance expectations.\n\n * functional or submitted observers: are selected observers who diligently perform their duties and submit observation reports and contract interactions.\n\n * deficient or failed observers: are selected observers who do not fulfill their duty of submitting observation reports and contract interactions.\n\nat the end of an epoch, the smart contract will assess the results from the observers during a “tallying period” and determine a pass / fail score for each gateway:\n\n * if greater than or equal to 50% of submitted observer contract interactions indicate a pass score, then that gateway is considered functional and eligible for gateway rewards.\n\n * else, if greater than 50% of submitted observer contract interactions indicate a fail score, then that gateway is considered deficient and ineligible for gateway rewards.\n\nthese results will determine how reward distributions are made for that epoch. rewards shall be distributed after the epoch’s tallying period is complete.\n\n\n# reward distribution\n\neach epoch, a defined portion of the protocol balance (e.g., 0.05%) is earmarked for distribution as rewards. from this allocation, two distinct reward categories are derived:\n\n 1. base gateway reward: this is the portion of the reward allocated to each functional gateway within the network and is calculated as:\n \n [epoch reward allocation x 90% / total gateways in the network]\n\n 2. base observer reward: observers, due to their additional responsibilities, have a separate reward calculated as:\n \n [epoch reward allocation x 10% / total selected observers for the epoch]\n\n\n# distribution based on performance\n\nthe reward distribution is contingent on the performance classifications derived from the performance evaluation:\n\n * functional gateways: gateways that meet the performance criteria receive the base gateway reward.\n\n * deficient gateways: gateways falling short in performance do not receive any gateway rewards.\n\n * functional observers: observers that fulfilled their duty receive the base observer reward.\n\n * deficient observers: observers failing to meet their responsibilities do not receive observer rewards. furthermore, if they are also functional gateways, their gateway reward is reduced by 25% for that epoch as a consequence for not performing their observation duty.\n\n\n# undistributed rewards\n\nin cases where rewards are not distributed, either due to the inactivity or deficiency of gateways or observers, the allocated tokens shall remain in the protocol balance and carry forward to the next epoch. this mechanism is in place to discourage observers from frivolously marking their peers as offline in hopes of attaining a higher portion of the reward pool.\n\n\n# handling inactive gateways\n\nto maintain network efficiency and reduce contract state bloat, gateways that are consistently offline, specifically for thirty (30) consecutive epochs, and thus fail to receive rewards, will be automatically removed from the gateway active registry (gar) as well as have their staked io tokens unlocked and returned to the gateway operator.\n\n\n# observer report details\n\neach observer shall assess the performance of the selected arns names (across all ar.io gateways) and summarize those findings in a report which details the following:\n\n\n# general information\n\n * the observer's arweave address.\n * the starting block height of the epoch.\n * the block height at which the report was generated.\n\n\n# overall gateway operator assessment\n\n * gateway fqdn.\n * the arweave address that the observer expects to be the owner / operator of the gateway.\n * the arweave address that the observed gateway actually reports.\n * a final “pass or fail” rollup determination for each observed gateway.\n * failure reason (if applicable).\n\n\n# arns assessments\n\n * observed arns name (for all prescribed and chosen names).\n * the block height at which the name was assessed.\n * the expected status code.\n * the resolved status code.\n * the transaction id that the observer expects the associated name to resolve to.\n * the transaction id that the gateway actually resolves to.\n * the data hash that the observer expects the associated name to resolve to.\n * the data hash that the gateway actually resolves to.\n * the “pass or fail” score associated with the observed name, at the observer’s discretion.\n * failure reason (if applicable).\n * timing / performance information associated with the name resolution such as time to first byte and total duration.\n\nthe above is repeated for the entire name pool and across each gateway in the gar.\n\n\n# example observation report\n\nhttps://arweave.net/gg1ycfc7wqxkvq1qd1ltep2oambs4vzrpfdmeelyjdi\n\n\n# viewing observation reports\n\nyou can easily view an observation report in a human readable format through your terminal with the following command:\n\ncurl -l https://arweave.net/ | zcat | jq .\n\n\nbe sure to replace with the txid of the report you want to view.\n\n\n# example\n\ncurl -l https://arweave.net/h3zdmodkpog0u95rejbeq6gunww_cevsctuqvqfsbxk | zcat | jq .\n",charsets:{cjk:!0}},{title:"Delegated Staking Settings",frontmatter:{permalink:"/gateways/delegated-staking"},regularPath:"/gateways/ar-io-node/delegated-staking.html",relativePath:"gateways/ar-io-node/delegated-staking.md",key:"v-3f2c877a",path:"/gateways/delegated-staking/",headers:[{level:2,title:"Overview",slug:"overview",normalizedTitle:"overview",charIndex:33}],headersStr:"Overview",content:"# Delegated Staking Settings\n\n\n# Overview\n\nGateway operators can choose to allow other people to stake tokens on their gateway. This is called “delegated staking”, and it increases the number of tokens staked for a given gateway. The additionally staked tokens result in a greater stakeWeight for the gateway - increasing it’s likelihood chosen as an observer and potentially receive additional rewards for a given epoch (assuming that the gateway’s observer is working properly). To incentivize this, you can set a portion of your gateway and observer rewards to be given to the people who stake on your gateway.\n\n--\x3e",normalizedContent:"# delegated staking settings\n\n\n# overview\n\ngateway operators can choose to allow other people to stake tokens on their gateway. this is called “delegated staking”, and it increases the number of tokens staked for a given gateway. the additionally staked tokens result in a greater stakeweight for the gateway - increasing it’s likelihood chosen as an observer and potentially receive additional rewards for a given epoch (assuming that the gateway’s observer is working properly). to incentivize this, you can set a portion of your gateway and observer rewards to be given to the people who stake on your gateway.\n\n--\x3e",charsets:{}},{title:"Environmental Variables",frontmatter:{},regularPath:"/gateways/ar-io-node/env.html",relativePath:"gateways/ar-io-node/env.md",key:"v-2fa5878c",path:"/gateways/ar-io-node/env.html",headers:[{level:2,title:"Overview",slug:"overview",normalizedTitle:"overview",charIndex:30},{level:2,title:"Variables",slug:"variables",normalizedTitle:"variables",charIndex:16}],headersStr:"Overview Variables",content:'# Environmental Variables\n\n\n# Overview\n\nThe AR.IO Gateway allows configuration customization through environmental variables. These variables dictate the gateway\'s behavior, from block synchronization settings to log formatting. Detailed below is a table enumerating all available environmental variables, their respective types, default values, and a brief description. Note that certain variables, such as SANDBOX_PROTOCOL, rely on others (e.g., ARNS_ROOT_HOST) to function effectively. Ensure proper understanding of these dependencies when configuring.\n\n\n# Variables\n\nENV NAME TYPE DEFAULT VALUE DESCRIPTION\nSTART_HEIGHT Number or "Infinity" 0 Starting block height for node synchronization (0 = start\n from genesis block)\nSTOP_HEIGHT Number or "Infinity" "Infinity" Stop block height for node synchronization (Infinity = keep\n syncing until stopped)\nTRUSTED_NODE_URL String "https://arweave.net" Arweave node to use for fetching data\nTRUSTED_GATEWAY_URL String "https://arweave.net" Arweave node to use for proxying reqeusts\nTRUSTED_ARNS_GATEWAY_URL String https://NAME.arweave.dev ArNS gateway\nINSTANCE_ID String "" Adds an "INSTANCE_ID" field to output logs\nLOG_FORMAT String "simple" Sets the format of output logs, accepts "simple" and "json"\nSKIP_CACHE Boolean false If true, skips the local cache and always fetches headers\n from the node\nPORT Number 4000 AR.IO node exposed port number\nSIMULATED_REQUEST_FAILURE_RATE Number 0 Number from 0 to 1, representing the probability of a\n request failing\nAR_IO_WALLET String "" Arweave wallet address used for staking and rewards\nADMIN_API_KEY String Generated API key used for admin API requests (if not set, it is\n generated and logged into the console)\nBACKFILL_BUNDLE_RECORDS Boolean false If true, AR.IO node will start indexing missing bundles\nFILTER_CHANGE_REPROCESS Boolean false If true, all indexed bundles will be reprocessed with the\n new filters (you can use this when you change the filters)\nANS104_UNBUNDLE_FILTER String {"never": true} Only bundles compliant with this filter will be unbundled\nANS104_INDEX_FILTER String {"never": true} Only bundles compliant with this filter will be indexed\nARNS_ROOT_HOST String undefined Domain name for ArNS host\nSANDBOX_PROTOCOL String undefined Protocol setting in process of creating sandbox domains in\n ArNS (ARNS_ROOT_HOST needs to be set for this env to have\n any effect) accepts "http" or "https"\nSTART_WRITERS Boolean true If true, start indexing blocks, tx, ANS104 bundles\nRUN_OBSERVER Boolean true If true, runs the Observer alongside the gateway to generate\n Network compliance reports\nMIN_RELEASE_NUMBER string "0"\nAR_IO_NODE_RELEASE string "0"\nOBSERVER_WALLET String undefined\n\nCHUNKS_DATA_PATH string "data/chunks"\nCONTIGUOUS_DATA_PATH string "data/contiguous"\nHEADERS_DATA_PATH string "data/headers"\nSQLITE_DATA_PATH string "data/sqlite"\nTEMP_DATA_PATH string "data/tmp"\nLMDB_DATA_PATH string "data/LMDB"\nCHAIN_CACHE_TYPE String "redis"\n\n\nREDIS_CACHE_URL String (URL) "redis://localhost:6379"\nREDIS_CACHE_TTL_SECONDS Number 28800\n\nENABLE_FS_HEADER_CACHE_CLEANUP Boolean false\nNODE_JS_MAX_OLD_SPACE_SIZE Number system default\n\nSUBMIT_CONTRACT_INTERACTIONS Boolean true\n\n\nREDIS_MAX_MEMORY String 256mb\nREDIS_EXTRA_FLAGS String --save "" --appendonly no\nWEBHOOK_TARGET_SERVERS String undefined\nWEBHOOK_INDEX_FILTER String {"never": true}\n\nWEBHOOK_BLOCK_FILTER String {"never": true}\nCONTIGUOUS_DATA_CACHE_CLEANUP_THRESHOLD Number undefined\n\nRUN_RESOLVER Boolean false\n\nTRUSTED_ARNS_RESOLVER_TYPE String gateway\n\n\nTRUSTED_ARNS_RESOLVER_URL String https:__NAME__.arweave.dev\n\nENABLE_MEMPOOL_WATCHER Boolean false\n\nMEMPOOL_POLLING_INTERVAL_MS Number 30000',normalizedContent:'# environmental variables\n\n\n# overview\n\nthe ar.io gateway allows configuration customization through environmental variables. these variables dictate the gateway\'s behavior, from block synchronization settings to log formatting. detailed below is a table enumerating all available environmental variables, their respective types, default values, and a brief description. note that certain variables, such as sandbox_protocol, rely on others (e.g., arns_root_host) to function effectively. ensure proper understanding of these dependencies when configuring.\n\n\n# variables\n\nenv name type default value description\nstart_height number or "infinity" 0 starting block height for node synchronization (0 = start\n from genesis block)\nstop_height number or "infinity" "infinity" stop block height for node synchronization (infinity = keep\n syncing until stopped)\ntrusted_node_url string "https://arweave.net" arweave node to use for fetching data\ntrusted_gateway_url string "https://arweave.net" arweave node to use for proxying reqeusts\ntrusted_arns_gateway_url string https://name.arweave.dev arns gateway\ninstance_id string "" adds an "instance_id" field to output logs\nlog_format string "simple" sets the format of output logs, accepts "simple" and "json"\nskip_cache boolean false if true, skips the local cache and always fetches headers\n from the node\nport number 4000 ar.io node exposed port number\nsimulated_request_failure_rate number 0 number from 0 to 1, representing the probability of a\n request failing\nar_io_wallet string "" arweave wallet address used for staking and rewards\nadmin_api_key string generated api key used for admin api requests (if not set, it is\n generated and logged into the console)\nbackfill_bundle_records boolean false if true, ar.io node will start indexing missing bundles\nfilter_change_reprocess boolean false if true, all indexed bundles will be reprocessed with the\n new filters (you can use this when you change the filters)\nans104_unbundle_filter string {"never": true} only bundles compliant with this filter will be unbundled\nans104_index_filter string {"never": true} only bundles compliant with this filter will be indexed\narns_root_host string undefined domain name for arns host\nsandbox_protocol string undefined protocol setting in process of creating sandbox domains in\n arns (arns_root_host needs to be set for this env to have\n any effect) accepts "http" or "https"\nstart_writers boolean true if true, start indexing blocks, tx, ans104 bundles\nrun_observer boolean true if true, runs the observer alongside the gateway to generate\n network compliance reports\nmin_release_number string "0"\nar_io_node_release string "0"\nobserver_wallet string undefined\n\nchunks_data_path string "data/chunks"\ncontiguous_data_path string "data/contiguous"\nheaders_data_path string "data/headers"\nsqlite_data_path string "data/sqlite"\ntemp_data_path string "data/tmp"\nlmdb_data_path string "data/lmdb"\nchain_cache_type string "redis"\n\n\nredis_cache_url string (url) "redis://localhost:6379"\nredis_cache_ttl_seconds number 28800\n\nenable_fs_header_cache_cleanup boolean false\nnode_js_max_old_space_size number system default\n\nsubmit_contract_interactions boolean true\n\n\nredis_max_memory string 256mb\nredis_extra_flags string --save "" --appendonly no\nwebhook_target_servers string undefined\nwebhook_index_filter string {"never": true}\n\nwebhook_block_filter string {"never": true}\ncontiguous_data_cache_cleanup_threshold number undefined\n\nrun_resolver boolean false\n\ntrusted_arns_resolver_type string gateway\n\n\ntrusted_arns_resolver_url string https:__name__.arweave.dev\n\nenable_mempool_watcher boolean false\n\nmempool_polling_interval_ms number 30000',charsets:{}},{title:"Farcaster Frames",frontmatter:{permalink:"/experimental/frames"},regularPath:"/gateways/ar-io-node/experimental/frames.html",relativePath:"gateways/ar-io-node/experimental/frames.md",key:"v-b292638c",path:"/experimental/frames/",headers:[{level:2,title:"Overview",slug:"overview",normalizedTitle:"overview",charIndex:23},{level:2,title:"Experimental Gateway Support",slug:"experimental-gateway-support",normalizedTitle:"experimental gateway support",charIndex:598},{level:2,title:"Using Frames",slug:"using-frames",normalizedTitle:"using frames",charIndex:1056},{level:2,title:"Example",slug:"example",normalizedTitle:"example",charIndex:1546}],headersStr:"Overview Experimental Gateway Support Using Frames Example",content:'# Farcaster Frames\n\n\n# Overview\n\nFrames by Farcaster is a standard for posts, or "casts", that allows them to be interactive and easily authenticated self contained apps. Because the standard relies on HTML Meta tags, they can easily be integrated into dApps hosted permanently on Arweave. Until recently, the full capabilities of Frames hosted on Arweave were not accessible through ar.io gateways. This is because a specific type of interaction between the frame and the hosting server, a POST, is needed to facilitate interactivity, and ar.io gateways did not support this interaction type.\n\n\n# Experimental Gateway Support\n\nWith Release 9 of the ar.io gateways, a new experimental endpoint was added that supports the POST requests needed by frames. The /local endpoint on a gateway is used to facilitate experimental new features, as well as features which may be specific to an individual gateway. Operators and users should be fully aware that all endpoints stemming from /local are experimental, and may not always perform exactly as expected.\n\n\n# Using Frames\n\nThe full path for accessing a frame hosted on Arweave is https:///local/farcaster/frame/ where represents any ar.io gateway using release 9 or higher, and represents the txId of the frame on Arweave. Since frames require full, absolute url paths, you will need to choose specific, supported gateway when you are embedding the frame in your cast.\n\nBeyond that, simply embed the url for a frame in a cast and farcaster will be able to render it.\n\n\n# Example\n\nArweave community member K, who is a pioneer in permaweb frames, created the below frame to demonstrate how permaweb frames can be interactive when embedded from ar.io gateways.\n\nThe ID for the frame he uploaded to Arweave is JFfYkpW5--I5UOxnJTYHhY9-F8X6WrvDsXQv8jYr0WE. Using this, He made a Farcaster cast with the embedded url https://erl5reuvxh56eokq5rtsknqhqwhx4f6f7jnlxq5roqx7enrl2fqq.ar-io.dev/local/farcaster/frame/JFfYkpW5--I5UOxnJTYHhY9-F8X6WrvDsXQv8jYr0WE/. This full url includes the sandbox prefix generated by an ar.io gateway when serving content.\n\nWhen embedding this full url in a cast, farcaster will render the content into a frame:\n\nView the original post here to experience the interactivity first hand.',normalizedContent:'# farcaster frames\n\n\n# overview\n\nframes by farcaster is a standard for posts, or "casts", that allows them to be interactive and easily authenticated self contained apps. because the standard relies on html meta tags, they can easily be integrated into dapps hosted permanently on arweave. until recently, the full capabilities of frames hosted on arweave were not accessible through ar.io gateways. this is because a specific type of interaction between the frame and the hosting server, a post, is needed to facilitate interactivity, and ar.io gateways did not support this interaction type.\n\n\n# experimental gateway support\n\nwith release 9 of the ar.io gateways, a new experimental endpoint was added that supports the post requests needed by frames. the /local endpoint on a gateway is used to facilitate experimental new features, as well as features which may be specific to an individual gateway. operators and users should be fully aware that all endpoints stemming from /local are experimental, and may not always perform exactly as expected.\n\n\n# using frames\n\nthe full path for accessing a frame hosted on arweave is https:///local/farcaster/frame/ where represents any ar.io gateway using release 9 or higher, and represents the txid of the frame on arweave. since frames require full, absolute url paths, you will need to choose specific, supported gateway when you are embedding the frame in your cast.\n\nbeyond that, simply embed the url for a frame in a cast and farcaster will be able to render it.\n\n\n# example\n\narweave community member k, who is a pioneer in permaweb frames, created the below frame to demonstrate how permaweb frames can be interactive when embedded from ar.io gateways.\n\nthe id for the frame he uploaded to arweave is jffykpw5--i5uoxnjtyhhy9-f8x6wrvdsxqv8jyr0we. using this, he made a farcaster cast with the embedded url https://erl5reuvxh56eokq5rtsknqhqwhx4f6f7jnlxq5roqx7enrl2fqq.ar-io.dev/local/farcaster/frame/jffykpw5--i5uoxnjtyhhy9-f8x6wrvdsxqv8jyr0we/. this full url includes the sandbox prefix generated by an ar.io gateway when serving content.\n\nwhen embedding this full url in a cast, farcaster will render the content into a frame:\n\nview the original post here to experience the interactivity first hand.',charsets:{}},{title:"Linux Installation Instructions",frontmatter:{prev:!1,next:"/gateways/ar-io-node/testnet.html",tags:["domain","url","setup","start","help","how to","ubuntu","testnet"],permalink:"/gateways/ar-io-node/linux-setup/"},regularPath:"/gateways/ar-io-node/linux-setup.html",relativePath:"gateways/ar-io-node/linux-setup.md",key:"v-e0d70ecc",path:"/gateways/ar-io-node/linux-setup/",headers:[{level:2,title:"Overview",slug:"overview",normalizedTitle:"overview",charIndex:38},{level:2,title:"System Requirements",slug:"system-requirements",normalizedTitle:"system requirements",charIndex:482},{level:3,title:"Minimum requirements",slug:"minimum-requirements",normalizedTitle:"minimum requirements",charIndex:683},{level:3,title:"Recommended",slug:"recommended",normalizedTitle:"recommended",charIndex:1145},{level:2,title:"Install Packages",slug:"install-packages",normalizedTitle:"install packages",charIndex:1247},{level:3,title:"Required packages",slug:"required-packages",normalizedTitle:"required packages",charIndex:2030},{level:3,title:"Suggested packages",slug:"suggested-packages",normalizedTitle:"suggested packages",charIndex:2716},{level:2,title:"Install the Node",slug:"install-the-node",normalizedTitle:"install the node",charIndex:3694},{level:2,title:"Set up Networking",slug:"set-up-networking",normalizedTitle:"set up networking",charIndex:7694}],headersStr:"Overview System Requirements Minimum requirements Recommended Install Packages Required packages Suggested packages Install the Node Set up Networking",content:"# Linux Installation Instructions\n\n\n# Overview\n\nThe following instructions will guide you through the process of installing the AR.IO node on a Linux machine, specifically Ubuntu 22.04.3 desktop on a home computer. Actual steps may differ slightly on different versions or distributions. This guide will cover how to set up your node, point a domain name to your home network, and create an nginx server for routing traffic to your node. No prior coding experience is required.\n\n\n# System Requirements\n\nPlease note, The AR.IO Node software is still in development and testing, all system requirements are subject to change.\n\nExternal storage devices should be formatted as ext4.\n\n\n# Minimum requirements\n\nThe hardware specifications listed below represent the minimum system requirements at which the AR.IO Node has been tested. While your Node may still operate on systems with lesser specifications, please note that AR.IO cannot guarantee performance or functionality under those conditions. Use below-minimum hardware at your own risk.\n\n * 4 core CPU\n * 4 GB Ram\n * 500 GB storage (SSD recommended)\n * Stable 50 Mbps internet connection\n\n\n# Recommended\n\n * 12 core CPU\n * 32 GB Ram\n * 2 TB SSD storage\n * Stable 1 Gbps internet connection\n\n\n# Install Packages\n\nIf you would like to quickly install all required and suggested packages, you can run the following 2 commands in your terminal, and skip to installing the Node.\n\nsudo apt update -y && sudo apt upgrade -y && sudo apt install -y curl openssh-server docker-compose git certbot nginx sqlite3 build-essential && sudo systemctl enable ssh && curl -sSL https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add - && echo \"deb https://dl.yarnpkg.com/debian/ stable main\" | sudo tee /etc/apt/sources.list.d/yarn.list && sudo apt-get update -y && sudo apt-get install -y yarn && curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash && source ~/.bashrc && sudo ufw allow 22 80 443 && sudo ufw enable\n\n\nnvm install 20.11.1 && nvm use 20.11.1\n\n\n\n# Required packages\n\n 1. Update your software:\n \n sudo apt update\n sudo apt upgrade\n \n\n 2. Enable your firewall and open necessary ports:\n \n sudo ufw enable\n \n # Optional: If using SSH, allow port 22\n sudo ufw allow 22\n \n # Allow ports 80 and 443 for HTTP and HTTPS\n sudo ufw allow 80\n sudo ufw allow 443\n \n\n 3. Install nginx:\n \n sudo apt install nginx -y\n \n\n 4. Install git:\n \n sudo apt install git -y\n \n\n 5. Install Docker:\n \n sudo apt install docker-compose -y\n \n \n * Test Docker installation:\n \n sudo docker run hello-world\n \n\n 6. Install Certbot:\n \n sudo apt install certbot -y\n \n\n\n# Suggested packages\n\nThese packages are not required to run a node in its basic form. However, they will become necessary for more advanced usage or customization.\n\n 7. Install ssh (optional, for remote access to your Linux machine):\n \n sudo apt install openssh-server -y\n sudo systemctl enable ssh\n \n\n 8. Install Yarn:\n \n curl -sSL https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -\n \n echo \"deb https://dl.yarnpkg.com/debian/ stable main\" | sudo tee /etc/apt/sources.list.d/yarn.list\n \n sudo apt-get update -y\n \n sudo apt-get install yarn -y\n \n\n 9. Install NVM (Node Version Manager):\n \n curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash\n source ~/.bashrc\n \n\n 10. Install Node.js:\n \n nvm install 20.11.1\n \n\n 11. Install build tools\n \n sudo apt install build-essential\n \n\n 12. Install SQLite:\n \n sudo apt install sqlite3 -y\n \n\n\n# Install the Node\n\n * Navigate to the desired installation location:\n \n * NOTE: Your database of Arweave Transaction Headers will be created in the project directory, not Docker. So, if you are using an external hard drive to turn an old machine into a node, install the node directly to that external drive.\n\n * Clone the ar-io-node repository and navigate into it:\n \n git clone -b main https://github.com/ar-io/ar-io-node\n cd ar-io-node\n \n\n * Create an environmental variables file:\n \n nano .env\n \n \n Paste the following content into the new file, replacing with the domain address you are using to access the node, and with the public address of your Arweave wallet, save, and exit:\n \n \n GRAPHQL_HOST=arweave.net\n GRAPHQL_PORT=443\n START_HEIGHT=0\n RUN_OBSERVER=true\n ARNS_ROOT_HOST=\n AR_IO_WALLET=\n OBSERVER_WALLET=\n \n \n * The GRAPHQL values set the proxy for GQL queries to arweave.net, You may use any available gateway that supports GQL queries. If omitted, your node can support GQL queries on locally indexed transactions, but only L1 transactions are indexed by default.\n * START_HEIGHT is an optional line. It sets the block number where your node will start downloading and indexing transactions headers. Omitting this line will begin indexing at block 0.\n * RUN_OBSERVER turns on the Observer to generate Network Compliance Reports. This is required for full participation in the AR.IO Network. Set to false to run your gateway without Observer.\n * ARNS_ROOT_HOST sets the starting point for resolving ARNS names, which are accessed as a subdomain of a gateway. It should be set to the url you are pointing to your node, excluding any protocol prefix. For example, use node-ar.io and not https://node-ar.io. If you are using a subdomain to access your node and do not set this value, the node will not understand incoming requests.\n * AR_IO_WALLET is optional, and sets the wallet you want associated with your Gateway. An associated wallet is required to join the AR.IO network.\n * OBSERVER_WALLET is the public address of the wallet used to sign Observer transactions. This is required for Observer to run, but may be omitted if you are running a gateway outside of the AR.IO network and do not plan to run Observer. You will need to supply the keyfile to this wallet in the next step.\n \n Advanced configuration options can be found at docs.ar.io\n\n * Supply Your Observer Wallet Keyfile:\n \n If you are running Observer, you need to provide a wallet keyfile in order to sign report upload transactions. The keyfile must be saved in the wallets directory in the root of the repository. Name the file .json, replacing \"\" with the public address of the wallet. This should match your OBSERVER_WALLET environmental variable.\n \n Learn more about creating Arweave wallets and obtaining keyfiles here\n\n * Start the Docker container:\n \n sudo docker-compose up -d\n \n \n * Explanation of flags:\n * up: Start the Docker containers.\n * -d: Run the containers as background processes (detached mode).\n \n NOTE: Effective with Release #3, it is no longer required to include the --build flag when starting your gateway. Docker will automatically build using the image specified in the docker-commpose.yaml file.\n \n To shut down your gateway, run the command:\n \n sudo docker-compose down\n \n\nTo ensure your node is running correctly, check the logs for errors:\n\nsudo docker-compose logs -f --tail=0\n\n\n * Explanation of flags:\n * -f: Follow the logs in real time.\n * --tail=0: Ignore all logs from before running the command.\n\nNOTE: Previous versions of these instructions advised checking a gateway's ability to fetch content using localhost. Subsequent security updates prevent this without first disabling ARNS_ROOT_HOST in your .env.\n\n\n# Set up Networking\n\nThe following guide assumes you are running your node on a local home computer.\n\n * Register a Domain Name: Choose a domain registrar (e.g., Namecheap) to register a domain name.\n\n * Point the Domain at Your Home Internet:\n \n * Obtain your public IP address by visiting https://www.whatsmyip.org/ or running:\n \n curl ifconfig.me\n \n \n * Create an A record with your registrar for your domain and wildcard subdomains, using your public IP address. For example, if your domain is \"ar.io,\" create a record for \"ar.io\" and \"*.ar.io.\"\n\n * Set up Port Forwarding:\n \n * Obtain the local IP address of the machine where the node is installed by running:\n \n ip addr show | grep -w inet | awk '{print $2}' | awk -F'/' '{print $1}'\n \n \n * If there are multiple lines of output, choose the one starting with 192 (usually).\n * Enter your router's IP address in the address bar of a browser (e.g., 192.168.0.1).\n * If you're unsure of your router's IP address, consult your router's documentation or contact your Internet Service Provider (ISP).\n * Navigate to the port forwarding settings in your router configuration.\n * The exact steps may vary depending on your router model. Consult your router's documentation or support for detailed steps.\n * Set up port forwarding rules to forward incoming traffic on ports 80 (HTTP) and 443 (HTTPS) to the same ports on the machine running your node. You may also forward port 22 if you want to enable SSH access to your node from outside your home network.\n\n * Create SSL (HTTPS) Certificates for Your Domain:\n \n sudo certbot certonly --manual --preferred-challenges dns --email -d .com -d '*..com'\n \n \n Follow the instructions to create the required TXT records for your domain in your chosen registrar. Use a DNS checker to verify the propagation of each record. This can take some time.\n \n IMPORTANT: Wild card subdomain (*..com) cannot auto renew without obtaining an API key from your domain registrar. Not all registrars offer this. Certbot certificates expire every 90 days. Be sure to consult with your chosen registrar to see if they offer an API for this purpose, or run the above command again to renew your certificates. You will receive an email warning at the address you provided to remind you when it is time to renew.\n\n * Configure nginx: nginx is a free and open-source web server and reverse proxy server. It will handle incoming traffic, provide SSL certificates, and redirect the traffic to your node.\n \n * Open the default configuration file:\n \n sudo nano /etc/nginx/sites-available/default\n \n \n * Replace the file's contents with the following configuration (replace \"\" when necessary):\n \n # Force redirects from HTTP to HTTPS\n server {\n listen 80;\n listen [::]:80;\n server_name .com *..com;\n \n location / {\n return 301 https://$host$request_uri;\n }\n }\n \n # Forward traffic to your node and provide SSL certificates\n server {\n listen 443 ssl;\n listen [::]:443 ssl;\n server_name .com *..com;\n \n ssl_certificate /etc/letsencrypt/live/.com/fullchain.pem;\n ssl_certificate_key /etc/letsencrypt/live/.com/privkey.pem;\n \n location / {\n proxy_pass http://localhost:3000;\n proxy_set_header Host $host;\n proxy_set_header X-Real-IP $remote_addr;\n proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n proxy_http_version 1.1;\n }\n }\n \n \n * Save and exit nano.\n \n * Test the configuration:\n \n sudo nginx -t\n \n \n * If there are no errors, restart nginx:\n \n sudo service nginx restart\n \n\nYour node should now be running and connected to the internet. Test it by entering https:///3lyxgbgEvqNSvJrTX2J7CfRychUD5KClFhhVLyTPNCQ in your browser.\n\nNote: If you encounter any issues during the installation process, please seek assistance from the AR.IO community.",normalizedContent:"# linux installation instructions\n\n\n# overview\n\nthe following instructions will guide you through the process of installing the ar.io node on a linux machine, specifically ubuntu 22.04.3 desktop on a home computer. actual steps may differ slightly on different versions or distributions. this guide will cover how to set up your node, point a domain name to your home network, and create an nginx server for routing traffic to your node. no prior coding experience is required.\n\n\n# system requirements\n\nplease note, the ar.io node software is still in development and testing, all system requirements are subject to change.\n\nexternal storage devices should be formatted as ext4.\n\n\n# minimum requirements\n\nthe hardware specifications listed below represent the minimum system requirements at which the ar.io node has been tested. while your node may still operate on systems with lesser specifications, please note that ar.io cannot guarantee performance or functionality under those conditions. use below-minimum hardware at your own risk.\n\n * 4 core cpu\n * 4 gb ram\n * 500 gb storage (ssd recommended)\n * stable 50 mbps internet connection\n\n\n# recommended\n\n * 12 core cpu\n * 32 gb ram\n * 2 tb ssd storage\n * stable 1 gbps internet connection\n\n\n# install packages\n\nif you would like to quickly install all required and suggested packages, you can run the following 2 commands in your terminal, and skip to installing the node.\n\nsudo apt update -y && sudo apt upgrade -y && sudo apt install -y curl openssh-server docker-compose git certbot nginx sqlite3 build-essential && sudo systemctl enable ssh && curl -ssl https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add - && echo \"deb https://dl.yarnpkg.com/debian/ stable main\" | sudo tee /etc/apt/sources.list.d/yarn.list && sudo apt-get update -y && sudo apt-get install -y yarn && curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash && source ~/.bashrc && sudo ufw allow 22 80 443 && sudo ufw enable\n\n\nnvm install 20.11.1 && nvm use 20.11.1\n\n\n\n# required packages\n\n 1. update your software:\n \n sudo apt update\n sudo apt upgrade\n \n\n 2. enable your firewall and open necessary ports:\n \n sudo ufw enable\n \n # optional: if using ssh, allow port 22\n sudo ufw allow 22\n \n # allow ports 80 and 443 for http and https\n sudo ufw allow 80\n sudo ufw allow 443\n \n\n 3. install nginx:\n \n sudo apt install nginx -y\n \n\n 4. install git:\n \n sudo apt install git -y\n \n\n 5. install docker:\n \n sudo apt install docker-compose -y\n \n \n * test docker installation:\n \n sudo docker run hello-world\n \n\n 6. install certbot:\n \n sudo apt install certbot -y\n \n\n\n# suggested packages\n\nthese packages are not required to run a node in its basic form. however, they will become necessary for more advanced usage or customization.\n\n 7. install ssh (optional, for remote access to your linux machine):\n \n sudo apt install openssh-server -y\n sudo systemctl enable ssh\n \n\n 8. install yarn:\n \n curl -ssl https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -\n \n echo \"deb https://dl.yarnpkg.com/debian/ stable main\" | sudo tee /etc/apt/sources.list.d/yarn.list\n \n sudo apt-get update -y\n \n sudo apt-get install yarn -y\n \n\n 9. install nvm (node version manager):\n \n curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash\n source ~/.bashrc\n \n\n 10. install node.js:\n \n nvm install 20.11.1\n \n\n 11. install build tools\n \n sudo apt install build-essential\n \n\n 12. install sqlite:\n \n sudo apt install sqlite3 -y\n \n\n\n# install the node\n\n * navigate to the desired installation location:\n \n * note: your database of arweave transaction headers will be created in the project directory, not docker. so, if you are using an external hard drive to turn an old machine into a node, install the node directly to that external drive.\n\n * clone the ar-io-node repository and navigate into it:\n \n git clone -b main https://github.com/ar-io/ar-io-node\n cd ar-io-node\n \n\n * create an environmental variables file:\n \n nano .env\n \n \n paste the following content into the new file, replacing with the domain address you are using to access the node, and with the public address of your arweave wallet, save, and exit:\n \n \n graphql_host=arweave.net\n graphql_port=443\n start_height=0\n run_observer=true\n arns_root_host=\n ar_io_wallet=\n observer_wallet=\n \n \n * the graphql values set the proxy for gql queries to arweave.net, you may use any available gateway that supports gql queries. if omitted, your node can support gql queries on locally indexed transactions, but only l1 transactions are indexed by default.\n * start_height is an optional line. it sets the block number where your node will start downloading and indexing transactions headers. omitting this line will begin indexing at block 0.\n * run_observer turns on the observer to generate network compliance reports. this is required for full participation in the ar.io network. set to false to run your gateway without observer.\n * arns_root_host sets the starting point for resolving arns names, which are accessed as a subdomain of a gateway. it should be set to the url you are pointing to your node, excluding any protocol prefix. for example, use node-ar.io and not https://node-ar.io. if you are using a subdomain to access your node and do not set this value, the node will not understand incoming requests.\n * ar_io_wallet is optional, and sets the wallet you want associated with your gateway. an associated wallet is required to join the ar.io network.\n * observer_wallet is the public address of the wallet used to sign observer transactions. this is required for observer to run, but may be omitted if you are running a gateway outside of the ar.io network and do not plan to run observer. you will need to supply the keyfile to this wallet in the next step.\n \n advanced configuration options can be found at docs.ar.io\n\n * supply your observer wallet keyfile:\n \n if you are running observer, you need to provide a wallet keyfile in order to sign report upload transactions. the keyfile must be saved in the wallets directory in the root of the repository. name the file .json, replacing \"\" with the public address of the wallet. this should match your observer_wallet environmental variable.\n \n learn more about creating arweave wallets and obtaining keyfiles here\n\n * start the docker container:\n \n sudo docker-compose up -d\n \n \n * explanation of flags:\n * up: start the docker containers.\n * -d: run the containers as background processes (detached mode).\n \n note: effective with release #3, it is no longer required to include the --build flag when starting your gateway. docker will automatically build using the image specified in the docker-commpose.yaml file.\n \n to shut down your gateway, run the command:\n \n sudo docker-compose down\n \n\nto ensure your node is running correctly, check the logs for errors:\n\nsudo docker-compose logs -f --tail=0\n\n\n * explanation of flags:\n * -f: follow the logs in real time.\n * --tail=0: ignore all logs from before running the command.\n\nnote: previous versions of these instructions advised checking a gateway's ability to fetch content using localhost. subsequent security updates prevent this without first disabling arns_root_host in your .env.\n\n\n# set up networking\n\nthe following guide assumes you are running your node on a local home computer.\n\n * register a domain name: choose a domain registrar (e.g., namecheap) to register a domain name.\n\n * point the domain at your home internet:\n \n * obtain your public ip address by visiting https://www.whatsmyip.org/ or running:\n \n curl ifconfig.me\n \n \n * create an a record with your registrar for your domain and wildcard subdomains, using your public ip address. for example, if your domain is \"ar.io,\" create a record for \"ar.io\" and \"*.ar.io.\"\n\n * set up port forwarding:\n \n * obtain the local ip address of the machine where the node is installed by running:\n \n ip addr show | grep -w inet | awk '{print $2}' | awk -f'/' '{print $1}'\n \n \n * if there are multiple lines of output, choose the one starting with 192 (usually).\n * enter your router's ip address in the address bar of a browser (e.g., 192.168.0.1).\n * if you're unsure of your router's ip address, consult your router's documentation or contact your internet service provider (isp).\n * navigate to the port forwarding settings in your router configuration.\n * the exact steps may vary depending on your router model. consult your router's documentation or support for detailed steps.\n * set up port forwarding rules to forward incoming traffic on ports 80 (http) and 443 (https) to the same ports on the machine running your node. you may also forward port 22 if you want to enable ssh access to your node from outside your home network.\n\n * create ssl (https) certificates for your domain:\n \n sudo certbot certonly --manual --preferred-challenges dns --email -d .com -d '*..com'\n \n \n follow the instructions to create the required txt records for your domain in your chosen registrar. use a dns checker to verify the propagation of each record. this can take some time.\n \n important: wild card subdomain (*..com) cannot auto renew without obtaining an api key from your domain registrar. not all registrars offer this. certbot certificates expire every 90 days. be sure to consult with your chosen registrar to see if they offer an api for this purpose, or run the above command again to renew your certificates. you will receive an email warning at the address you provided to remind you when it is time to renew.\n\n * configure nginx: nginx is a free and open-source web server and reverse proxy server. it will handle incoming traffic, provide ssl certificates, and redirect the traffic to your node.\n \n * open the default configuration file:\n \n sudo nano /etc/nginx/sites-available/default\n \n \n * replace the file's contents with the following configuration (replace \"\" when necessary):\n \n # force redirects from http to https\n server {\n listen 80;\n listen [::]:80;\n server_name .com *..com;\n \n location / {\n return 301 https://$host$request_uri;\n }\n }\n \n # forward traffic to your node and provide ssl certificates\n server {\n listen 443 ssl;\n listen [::]:443 ssl;\n server_name .com *..com;\n \n ssl_certificate /etc/letsencrypt/live/.com/fullchain.pem;\n ssl_certificate_key /etc/letsencrypt/live/.com/privkey.pem;\n \n location / {\n proxy_pass http://localhost:3000;\n proxy_set_header host $host;\n proxy_set_header x-real-ip $remote_addr;\n proxy_set_header x-forwarded-for $proxy_add_x_forwarded_for;\n proxy_http_version 1.1;\n }\n }\n \n \n * save and exit nano.\n \n * test the configuration:\n \n sudo nginx -t\n \n \n * if there are no errors, restart nginx:\n \n sudo service nginx restart\n \n\nyour node should now be running and connected to the internet. test it by entering https:///3lyxgbgevqnsvjrtx2j7cfrychud5kclfhhvlytpncq in your browser.\n\nnote: if you encounter any issues during the installation process, please seek assistance from the ar.io community.",charsets:{cjk:!0}},{title:"Upgrading to the Observer Module",frontmatter:{},regularPath:"/gateways/ar-io-node/observer-upgrade.html",relativePath:"gateways/ar-io-node/observer-upgrade.md",key:"v-2151a890",path:"/gateways/ar-io-node/observer-upgrade.html",headers:[{level:2,title:"Overview",slug:"overview",normalizedTitle:"overview",charIndex:39},{level:2,title:"Supply a Keyfile",slug:"supply-a-keyfile",normalizedTitle:"supply a keyfile",charIndex:691},{level:2,title:"Environmental variables",slug:"environmental-variables",normalizedTitle:"environmental variables",charIndex:1695}],headersStr:"Overview Supply a Keyfile Environmental variables",content:'# Upgrading to the Observer Module\n\n\n# Overview\n\nFrom time to time, significant updates to the AR.IO Gateway node software might necessitate additional configuration steps to harness the entirety of the new features. The recent addition of the "Observer" module, designed to monitor the health of the AR.IO network, is a case in point. To integrate this module successfully, users will need to undertake two supplementary steps beyond the conventional upgrade routine:\n\n 1. Supply the keyfile for an active Arweave wallet.\n\n 2. Configure specific environmental variables.\n\nBoth of these steps can be completed during the normal upgrade process BEFORE you rebuild your gateway (step #5).\n\n\n# Supply a Keyfile\n\nA primary function of the Observer Module is to upload reports on the health of the AR.IO network to the Arweave blockweave. In order to do this, transactions must be signed and paid for. This requires the keyfile for an Arweave wallet be provided to your gateway.\n\nYou may use the same wallet linked to your gateway in the AR.IO network (AR_IO_WALLET in your .env file) but in most situations it is safer to use a separate fresh wallet, or a "hot" wallet you use for safely interacting with Dapps, especially if you host your gateway on a remote server where other people may have access. Find more information about creating fresh wallets here.\n\nRemember, your keyfile contains the public keys to your Arweave wallet, always be extremely careful not to expose it to unsafe conditions.\n\nYour keyfile must be saved in the new wallets directory in the root of the gateway repository, with the name .json\n\nFor example: QGWqtJdLLgm2ehFWiiPzMaoFLD50CnGuzZIPEdoDRGQ.json\n\n\n# Environmental variables\n\nThere are two new environmental variables that should be set when upgrading to Observer. Both of these should be added to the .env file prior to rebuilding your gateway:\n\n * RUN_OBSERVER (optional) - This is the on/off switch for Observer. The default value is true, so omitting this from your environmental variables will not prevent Observer from running. Set the value to false if you want your gateway to run without Observer.\n * RUN_OBSERVER=true\n * OBSERVER_WALLET - This should be set to the public address of the wallet you are using to sign Observer transactions.\n * OBSERVER_WALLET=QGWqtJdLLgm2ehFWiiPzMaoFLD50CnGuzZIPEdoDRGQ\n\nNote: If you encounter any issues during the upgrade process, please seek assistance from the AR.IO community.',normalizedContent:'# upgrading to the observer module\n\n\n# overview\n\nfrom time to time, significant updates to the ar.io gateway node software might necessitate additional configuration steps to harness the entirety of the new features. the recent addition of the "observer" module, designed to monitor the health of the ar.io network, is a case in point. to integrate this module successfully, users will need to undertake two supplementary steps beyond the conventional upgrade routine:\n\n 1. supply the keyfile for an active arweave wallet.\n\n 2. configure specific environmental variables.\n\nboth of these steps can be completed during the normal upgrade process before you rebuild your gateway (step #5).\n\n\n# supply a keyfile\n\na primary function of the observer module is to upload reports on the health of the ar.io network to the arweave blockweave. in order to do this, transactions must be signed and paid for. this requires the keyfile for an arweave wallet be provided to your gateway.\n\nyou may use the same wallet linked to your gateway in the ar.io network (ar_io_wallet in your .env file) but in most situations it is safer to use a separate fresh wallet, or a "hot" wallet you use for safely interacting with dapps, especially if you host your gateway on a remote server where other people may have access. find more information about creating fresh wallets here.\n\nremember, your keyfile contains the public keys to your arweave wallet, always be extremely careful not to expose it to unsafe conditions.\n\nyour keyfile must be saved in the new wallets directory in the root of the gateway repository, with the name .json\n\nfor example: qgwqtjdllgm2ehfwiipzmaofld50cnguzzipedodrgq.json\n\n\n# environmental variables\n\nthere are two new environmental variables that should be set when upgrading to observer. both of these should be added to the .env file prior to rebuilding your gateway:\n\n * run_observer (optional) - this is the on/off switch for observer. the default value is true, so omitting this from your environmental variables will not prevent observer from running. set the value to false if you want your gateway to run without observer.\n * run_observer=true\n * observer_wallet - this should be set to the public address of the wallet you are using to sign observer transactions.\n * observer_wallet=qgwqtjdllgm2ehfwiipzmaofld50cnguzzipedodrgq\n\nnote: if you encounter any issues during the upgrade process, please seek assistance from the ar.io community.',charsets:{}},{title:"Troubleshooting Observer",frontmatter:{permalink:"/troubleshooting-observer",next:!1},regularPath:"/gateways/ar-io-node/observer-troubleshooting.html",relativePath:"gateways/ar-io-node/observer-troubleshooting.md",key:"v-6e1e3488",path:"/troubleshooting-observer/",headers:[{level:2,title:"Overview",slug:"overview",normalizedTitle:"overview",charIndex:31},{level:2,title:"Observer not running and/or unable to connect",slug:"observer-not-running-and-or-unable-to-connect",normalizedTitle:"observer not running and/or unable to connect",charIndex:425},{level:3,title:"",slug:"",normalizedTitle:"",charIndex:0},{level:2,title:"Observer wallet has no AR",slug:"observer-wallet-has-no-ar",normalizedTitle:"observer wallet has no ar",charIndex:2360},{level:3,title:"",slug:"-2",normalizedTitle:"",charIndex:0},{level:2,title:"Observer wallet ... does not match the 'observerWallet' set on the gateway ...",slug:"observer-wallet-does-not-match-the-observerwallet-set-on-the-gateway",normalizedTitle:"observer wallet ... does not match the 'observerwallet' set on the gateway ...",charIndex:2751},{level:3,title:"",slug:"-3",normalizedTitle:"",charIndex:0},{level:2,title:"Uncertain - confirm your OBSERVER_WALLET is set in the .env file and corresponding wallet is located in wallets/.json...",slug:"uncertain-confirm-your-observer-wallet-is-set-in-the-env-file-and-corresponding-wallet-is-located-in-wallets-address-json",normalizedTitle:"uncertain - confirm your observer_wallet is set in the .env file and corresponding wallet is located in wallets/.json...",charIndex:null},{level:3,title:"",slug:"-4",normalizedTitle:"",charIndex:0}],headersStr:"Overview Observer not running and/or unable to connect Observer wallet has no AR Observer wallet ... does not match the 'observerWallet' set on the gateway ... Uncertain - confirm your OBSERVER_WALLET is set in the .env file and corresponding wallet is located in wallets/.json... ",content:'# Troubleshooting Observer\n\n\n# Overview\n\nar.io observer epoch distribution reports include a list of failed observers for the epoch, along with an accounting of the errors which caused the observer to fail. When possible, the error messages will give you a starting point to being the troubleshooting process. Below is a list of possible error messages, along with more detailed information on how to address the issues.\n\n\n# Observer not running and/or unable to connect\n\n\n#\n\nYour observer was not able to connect with the contract at all. The most likely causes for this are internet connection problems, or your observer not running.\n\nVerify your observer is running\n\nsudo docker ps\n\nYour output should look something like this:\n\n CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES\n 264637d3e24d ghcr.io/ar-io/ar-io-envoy:01952702b78be1e464b9d192e77b38a119bdc4ee "/docker-entrypoint.…" 2 days ago Up 2 days 0.0.0.0:3000->3000/tcp, :::3000->3000/tcp, 0.0.0.0:9901->9901/tcp, :::9901->9901/tcp, 10000/tcp ar-io-node_envoy_1\n f42a4fbed8c5 ghcr.io/ar-io/ar-io-core:484bd31abb78709e09395f139ca57792bc6c3eb0 "/bin/sh docker-entr…" 2 days ago Up 2 days (healthy) 0.0.0.0:4000->4000/tcp, :::4000->4000/tcp ar-io-node_core_1\n dd2e0b64b0b4 redis:7 "docker-entrypoint.s…" 10 days ago Up 2 days 0.0.0.0:6379->6379/tcp, :::6379->6379/tcp ar-io-node_redis_1\n ed98aba1c4f6 ghcr.io/ar-io/ar-io-observer:6449bcb6dda778fef68a94bd29343190524439db "/nodejs/bin/node ./…" 10 days ago Up 2 days (healthy) 0.0.0.0:5000->5000/tcp, :::5000->5000/tcp ar-io-node_observer_1\n\n\nIf the line for observer does not say "up", then your observer is not running. You should restart your gateway, and then watch your observer logs to get a better idea of why your observer stopped:\n\nsudo docker-compose down\n\nsudo docker-compose up -d\n\nsudo docker-compose logs -f observer\n\n\n# Observer wallet has no AR\n\n\n#\n\nYour Observer Wallet does not have any AR tokens.\n\nYour observer wallet needs to be able to submit reports to the Arweave blockchain. To do this, it needs to have a small amount of AR tokens in order to pay for the submission. ar.io recommends depositing 1 AR token into your observer wallet to ensure that you remain funded throughout the entire testnet.\n\n\n# Observer wallet ... does not match the \'observerWallet\' set on the gateway ...\n\n\n#\n\nThe observer wallet set locally on your gateway does not match the observer wallet for your gateway in the ar.io network.\n\nCheck to make sure that you have OBSERVER_WALLET set in your .env file, and that the keyfile for your observer wallet is properly provided in the wallets directory in your gateway.\n\nYou will need to restart your gateway if you make any changes to the .env file or your observer wallet keyfile.\n\nThen check to make sure that the value for observerWallet on your gateway in the testnet contract matches that.\n\nThis video shows exactly what should be done to correct it if it does not.\n\n\n# Uncertain - confirm your OBSERVER_WALLET is set in the .env file and corresponding wallet is located in wallets/< address >.json...\n\n\n#\n\nThe cause for the error could not be reliably determined.\n\n"Uncertain" is the default value returned when evaluating a failed observer. It means that none of the above error messages perfectly matched the problems with your gateway.\n\nYou should first ensure that your observer wallet is set correctly locally, and then check your observer logs for any additional error messages.\n\nsudo docker-compose logs -f --tail=50 observer',normalizedContent:'# troubleshooting observer\n\n\n# overview\n\nar.io observer epoch distribution reports include a list of failed observers for the epoch, along with an accounting of the errors which caused the observer to fail. when possible, the error messages will give you a starting point to being the troubleshooting process. below is a list of possible error messages, along with more detailed information on how to address the issues.\n\n\n# observer not running and/or unable to connect\n\n\n#\n\nyour observer was not able to connect with the contract at all. the most likely causes for this are internet connection problems, or your observer not running.\n\nverify your observer is running\n\nsudo docker ps\n\nyour output should look something like this:\n\n container id image command created status ports names\n 264637d3e24d ghcr.io/ar-io/ar-io-envoy:01952702b78be1e464b9d192e77b38a119bdc4ee "/docker-entrypoint.…" 2 days ago up 2 days 0.0.0.0:3000->3000/tcp, :::3000->3000/tcp, 0.0.0.0:9901->9901/tcp, :::9901->9901/tcp, 10000/tcp ar-io-node_envoy_1\n f42a4fbed8c5 ghcr.io/ar-io/ar-io-core:484bd31abb78709e09395f139ca57792bc6c3eb0 "/bin/sh docker-entr…" 2 days ago up 2 days (healthy) 0.0.0.0:4000->4000/tcp, :::4000->4000/tcp ar-io-node_core_1\n dd2e0b64b0b4 redis:7 "docker-entrypoint.s…" 10 days ago up 2 days 0.0.0.0:6379->6379/tcp, :::6379->6379/tcp ar-io-node_redis_1\n ed98aba1c4f6 ghcr.io/ar-io/ar-io-observer:6449bcb6dda778fef68a94bd29343190524439db "/nodejs/bin/node ./…" 10 days ago up 2 days (healthy) 0.0.0.0:5000->5000/tcp, :::5000->5000/tcp ar-io-node_observer_1\n\n\nif the line for observer does not say "up", then your observer is not running. you should restart your gateway, and then watch your observer logs to get a better idea of why your observer stopped:\n\nsudo docker-compose down\n\nsudo docker-compose up -d\n\nsudo docker-compose logs -f observer\n\n\n# observer wallet has no ar\n\n\n#\n\nyour observer wallet does not have any ar tokens.\n\nyour observer wallet needs to be able to submit reports to the arweave blockchain. to do this, it needs to have a small amount of ar tokens in order to pay for the submission. ar.io recommends depositing 1 ar token into your observer wallet to ensure that you remain funded throughout the entire testnet.\n\n\n# observer wallet ... does not match the \'observerwallet\' set on the gateway ...\n\n\n#\n\nthe observer wallet set locally on your gateway does not match the observer wallet for your gateway in the ar.io network.\n\ncheck to make sure that you have observer_wallet set in your .env file, and that the keyfile for your observer wallet is properly provided in the wallets directory in your gateway.\n\nyou will need to restart your gateway if you make any changes to the .env file or your observer wallet keyfile.\n\nthen check to make sure that the value for observerwallet on your gateway in the testnet contract matches that.\n\nthis video shows exactly what should be done to correct it if it does not.\n\n\n# uncertain - confirm your observer_wallet is set in the .env file and corresponding wallet is located in wallets/< address >.json...\n\n\n#\n\nthe cause for the error could not be reliably determined.\n\n"uncertain" is the default value returned when evaluating a failed observer. it means that none of the above error messages perfectly matched the problems with your gateway.\n\nyou should first ensure that your observer wallet is set correctly locally, and then check your observer logs for any additional error messages.\n\nsudo docker-compose logs -f --tail=50 observer',charsets:{}},{title:"Overview",frontmatter:{permalink:"/gateways/ar-io-node/overview",prev:"/gateways/ar-io-node/windows-setup.html",next:"/gateways/ar-io-node/linux-setup.html"},regularPath:"/gateways/ar-io-node/overview.html",relativePath:"gateways/ar-io-node/overview.md",key:"v-ad4931e0",path:"/gateways/ar-io-node/overview/",headersStr:null,content:"# Overview\n\nEasy setup guides have been designed to get your AR.IO Gateway up and running correctly and quickly. These guides only go through some basic configurations, while more advanced options can be found here",normalizedContent:"# overview\n\neasy setup guides have been designed to get your ar.io gateway up and running correctly and quickly. these guides only go through some basic configurations, while more advanced options can be found here",charsets:{}},{title:"ar.io Release Notes",frontmatter:{next:!1},regularPath:"/gateways/ar-io-node/release-notes.html",relativePath:"gateways/ar-io-node/release-notes.md",key:"v-79f5d88c",path:"/gateways/ar-io-node/release-notes.html",headers:[{level:2,title:"Overview",slug:"overview",normalizedTitle:"overview",charIndex:26},{level:2,title:"[Release 17] - 2024-09-09",slug:"release-17-2024-09-09",normalizedTitle:"[release 17] - 2024-09-09",charIndex:706},{level:3,title:"Fixed",slug:"fixed",normalizedTitle:"fixed",charIndex:736},{level:3,title:"Added",slug:"added",normalizedTitle:"added",charIndex:1014},{level:3,title:"Changed",slug:"changed",normalizedTitle:"changed",charIndex:2886},{level:2,title:"[Release 16] - 2024-08-09",slug:"release-16-2024-08-09",normalizedTitle:"[release 16] - 2024-08-09",charIndex:3758},{level:2,title:"[Release 15] - 2024-07-19",slug:"release-15-2024-07-19",normalizedTitle:"[release 15] - 2024-07-19",charIndex:5409},{level:2,title:"[Release 14] - 2024-06-26",slug:"release-14-2024-06-26",normalizedTitle:"[release 14] - 2024-06-26",charIndex:7597},{level:2,title:"[Release 13] - 2024-06-24",slug:"release-13-2024-06-24",normalizedTitle:"[release 13] - 2024-06-24",charIndex:7691},{level:2,title:"[Release 12] - 2024-06-05",slug:"release-12-2024-06-05",normalizedTitle:"[release 12] - 2024-06-05",charIndex:9222},{level:2,title:"[Release 11] - 2024-05-21",slug:"release-11-2024-05-21",normalizedTitle:"[release 11] - 2024-05-21",charIndex:10496},{level:2,title:"[Release 10] - 2024-05-20",slug:"release-10-2024-05-20",normalizedTitle:"[release 10] - 2024-05-20",charIndex:10794},{level:2,title:"[Release 9] - 2024-04-10",slug:"release-9-2024-04-10",normalizedTitle:"[release 9] - 2024-04-10",charIndex:12159},{level:2,title:"[Release 8] - 2024-03-14",slug:"release-8-2024-03-14",normalizedTitle:"[release 8] - 2024-03-14",charIndex:13294},{level:2,title:"[Release 7] - 2024 - 02 - 14",slug:"release-7-2024-02-14",normalizedTitle:"[release 7] - 2024 - 02 - 14",charIndex:14154},{level:2,title:"[Release 6] - 2024-01-29",slug:"release-6-2024-01-29",normalizedTitle:"[release 6] - 2024-01-29",charIndex:14867},{level:2,title:"[Release 5] - 2024-01-25",slug:"release-5-2024-01-25",normalizedTitle:"[release 5] - 2024-01-25",charIndex:15e3},{level:2,title:"[Release 4] - 2024-01-11",slug:"release-4-2024-01-11",normalizedTitle:"[release 4] - 2024-01-11",charIndex:15620},{level:2,title:"[Release 3] - 2023-12-05",slug:"release-3-2023-12-05",normalizedTitle:"[release 3] - 2023-12-05",charIndex:16585}],headersStr:"Overview [Release 17] - 2024-09-09 Fixed Added Changed [Release 16] - 2024-08-09 [Release 15] - 2024-07-19 [Release 14] - 2024-06-26 [Release 13] - 2024-06-24 [Release 12] - 2024-06-05 [Release 11] - 2024-05-21 [Release 10] - 2024-05-20 [Release 9] - 2024-04-10 [Release 8] - 2024-03-14 [Release 7] - 2024 - 02 - 14 [Release 6] - 2024-01-29 [Release 5] - 2024-01-25 [Release 4] - 2024-01-11 [Release 3] - 2023-12-05",content:"# ar.io Release Notes\n\n\n# Overview\n\nWelcome to the documentation page for the ar.io gateway release notes. Here, you will find detailed information about each version of the ar.io gateway, including the enhancements, bug fixes, and any other changes introduced in every release. This page serves as a comprehensive resource to keep you informed about the latest developments and updates in the ar.io gateway. For those interested in exploring the source code, each release's code is readily accessible at our GitHub repository: ar.io gateway change logs. Stay updated with the continuous improvements and advancements in the ar.io gateway by referring to this page for all release-related information.\n\n\n# [Release 17] - 2024-09-09\n\n\n# Fixed\n\n * Use the correct environment variable to populate WEBHOOK_BLOCK_FILTER in docker-compose.yaml.\n * Don't cache data regions retrieved to satisfy range requests to avoid unnecessary storage overhead and prevent inserting invalid ID to hash mappings into the data DB.\n\n\n# Added\n\n * Added a new ClickHouse based DB backend. It can be used in combination with the SQLite DB backend to enable batch loading of historical data from Parquet. It also opens up the possibility of higher DB performance and scalability. In its current state it should be considered a technology preview. It won't be useful to most users until we either provide Parquet files to load into it or automate flushing of the SQLite DB to it (both are planned in future release). It is not intended to be standalone solution. It supports bulk loading and efficient GraphQL querying of transactions and data items, but it relies on SQLite (or potentially another OLTP in the future) to index recent data. These limitations allow greatly simplified schema and query construction. Querying the new ClickHouse DB for transaction and data items via GraphQL is enabled by setting the 'CLICKHOUSE_URL' environment variable.\n * Added the ability to skip storing transaction signatures in the DB by setting WRITE_TRANSACTION_DB_SIGNATURES to false. Missing signatures are fetched from the trusted Arweave node when needed for GraphQL results.\n * Added a Redis backed signature cache to support retrieving optimistically indexed data item signatures in GraphQL queries when writing data items signatures to the DB has been disabled.\n * Added on-demand and composite ArNS resolvers. The on-demand resolver fetches results directly from an AO CU. The composite resolver attempts resolution in the order specified by the ARNS_RESOLVER_PRIORITY_ORDER environment variable (defaults to 'on-demand,gateway').\n * Added a queue_length Prometheus metric to facilitate monitoring queues and inform future optimizations\n * Added SQLite WAL cleanup worker to help manage the size of the data.db-wal file. Future improvements to data.db usage are also planned to further improve WAL management.\n\n\n# Changed\n\n * Handle data requests by ID on ArNS sites. This enables ArNS sites to use relative links to data by ID.\n * Replaced ARNS_RESOLVER_TYPE with ARNS_RESOLVER_PRIORITY_ORDER (defaults to 'on-demand,gateway').\n * Introduced unbundling back pressure. When either data item data or GraphQL indexing queue depths are more than the value specified by the MAX_DATA_ITEM_QUEUE_SIZE environment variable (defaults to 100000), unbundling is paused until the queues length falls bellow that threshold. This prevents the gateway from running out of memory when the unbundling rate exceeds the indexing rate while avoiding wasteful bundle reprocessing.\n * Prioritized optimistic data item indexing by inserting optimistic data items at the front of the indexing queues.\n * Prioritized nested bundle indexing by inserting nested bundles at the front of the unbundling queue.\n\n\n# [Release 16] - 2024-08-09\n\n * Fixed\n \n * Fixed promise leak caused by missing await when saving data items to the DB.\n * Modified ArNS middleware to not attempt resolution when receiving requests for a different hostname than the one specified by ARNS_ROOT_HOST.\n\n * Added\n \n * Added support for returning Content-Encoding HTTP headers based on user specified Content-Encoding tags.\n * Added isNestedBundle filter enables that matches any nested bundle when indexing. This enables composite unbundling filters that match a set of L1 tags and bundles nested under them.\n * Added ability to skip writing ANS-104 signatures to the DB and load them based on offsets from the data instead. This significantly reduces the size of the bundles DB. It can be enabled by setting the WRITE_ANS104_DATA_ITEM_DB_SIGNATURES environment variable to false.\n * Added data_item_data_indexed_total Prometheus counter to count data items with data attributes indexed.\n\n * Changed\n \n * Queue data attributes writes when serving data rather than writing them syncronously.\n * Reduced the default data indexer count to 1 to lessen the load on the data DB.\n * Switched a number of overly verbose info logs to debug level.\n * Removed docker-compose on-failure restart limits to ensure that services restart no matter how many times they fail.\n * Modified the data_items_indexed_total Prometheus counter to count data items indexed for GraphQL querying instead of data attributes.\n * Increased aggressiveness of contiguous data cleanup. It now pauses 5 seconds instead of 10 seconds per batch and runs every 4 hours instead of every 24 hours.\n\n\n# [Release 15] - 2024-07-19\n\n * Fixed\n \n * Fixed query error that was preventing bundles from being marked as fully imported in the database.\n\n * Added\n \n * Adjusted data item indexing to record data item signature types in the DB. This helps distinguish between signatures using different key formats, and will enable querying by signature type in the future.\n * Adjusted data item indexing to record offsets for data items within bundles and signatures and owners within data items. In the future this will allow us to avoid saving owners and signatures in the DB and thus considerably reduce the size of the bundles DB.\n * Added ARNS_CACHE_TTL_MS environment variable to control the TTL of ARNS cache entries (defaults to 1 hour).\n * Added support for multiple ranges in a single HTTP range request.\n * Added experimental chunk POST endpoint that broadcasts chunks to the comma-separate list of URLS in the CHUNK_BROADCAST_URLS environment variable. It is available at /chunk on the internal gateway service port (4000 by default) but is not yet exposed through Envoy.\n * Added support for running an AO CU adjacent to the gateway (see README.md for details).\n * Added X-ArNS-Process-Id to ArNS resolved name headers.\n * Added a set of AO_... environment variables for specifying which AO URLs should be used (see docker-compose.yaml for the complete list). The AO_CU_URL is of particular use since the core and resolver services only perform AO reads and only the CU is needed for reads.\n\n * Changed\n \n * Split the monolithic docker-compose.yaml into docker-compose.yaml, docker-compose.bundler.yaml, and docker-compose.ao.yaml (see README for details).\n * Replaced references to 'docker-compose' with 'docker compose' in the docs since the former is mostly deprecated.\n * Reduce max fork depth from 50 to 18 inline to reflect Arweave 2.7.2 protocol changes.\n * Increased the aggressiveness of bundle reprocessing by reducing reprocessing interval from 10 minutes to 5 minutes and raising reprocessing batch size from 100 to 1000.\n * Use a patched version of Litestream to work around insufficient S3 multipart upload size in the upstream version.\n\n\n# [Release 14] - 2024-06-26\n\n * Fixed\n \n * Correctly handle manifest index after paths.\n\n\n# [Release 13] - 2024-06-24\n\n * Added\n \n * Added support for optimistically reading data items uploaded using the integrated Turbo bundler via the LocalStack S3 interface.\n * Added X-AR-IO-Origin-Node-Release header to outbound data requests.\n * Added hops, origin, and originNodeRelease query params to outbound data requests.\n * Added support for fallback in v0.2 manifests that is used if no path in the manifest is matched.\n\n * Changed\n \n * Updated Observer to read prescribed names from and write observations to the ar.io AO network process.\n * Updated Resolver to read from the ar.io AO network process.\n\n * Fixed\n \n * Modified optimistic indexing of data items to use a null parent_id when inserting into the DB instead of a placeholder value. This prevents unexpected non-null bundledIn values in GraphQL results for optimistically indexed data items.\n * Modified GraphQl query logic to require an ID for single block GraphQL queries. Previously queries missing an ID were returning an internal SQLite error. This represents a small departure from arweave.net's query logic which returns the latest block for these queries. We recommend querying blocks instead of block in cases where the latest block is desired.\n * Adjusted Observer health check to reflect port change to 5050.\n\n * Security\n \n * Modified docker-compose.yaml to only expose Redis, PostgreSQL, and LocalStack ports internally. This protects gateways that neglect to deploy behind a firewall, reverse proxy, or load balancer.\n\n\n# [Release 12] - 2024-06-05\n\n * Added\n \n * Added /ar-io/admin/queue-data-item endpoint for queuing data item headers for indexing before the bundles containing them are processed. This allows trusted bundlers to make their data items quickly available to be queried via GraphQL without having to wait for bundle data submission or unbundling.\n * Added experimental support for retrieving contiguous data from S3. See AWS_* environment variables documentation for configuration details. In conjuction with a local Turbo bundler this allows optimistic bundle (but not yet data item) retrieval.\n * Add experimental support for fetching data from gateway peers. It can be enabled by adding ario-peer to ON_DEMAND_RETRIEVAL_ORDER. Note: do not expect this work reliably yet! This functionality is in active development and will be improved in future releases.\n * Add import_attempt_count to bundle records to enable future bundle import retry optimizations.\n\n * Changed\n \n * Removed version from docker-compose.yaml to avoid warnings with recent versions of docker-compose.\n * Switched default observer port from 5000 to 5050 to avoid conflict on OS X. Since Envoy is used to provide external access to the observer API this should have no user visible effect.\n\n\n# [Release 11] - 2024-05-21\n\n * Added\n \n * Added arweave_tx_fetch_total Prometheus metric to track counts of transaction headers fetched from the trusted node and Arweave network peers.\n\n * Changed\n \n * Revert to using unnamed bind mounts due to cross platform issues with named volumes.\n\n\n# [Release 10] - 2024-05-20\n\n * Added\n \n * Added experimental support for streaming SQLite backups to S3 (and compatible services) using Litestream. Start the service using the docker-compose \"litestream\" profile to use it, and see the AR_IO_SQLITE_BACKUP_* environment variables documentation for further details.\n * Added /ar-io/admin/queue-bundle endpoint for queueing bundles for import for import before they're in the mempool. In the future this will enable optimistic indexing when combined with a local trusted bundler.\n * Added support for triggering webhooks when blocks are imported matching the filter specified by the WEBHOOK_BLOCK_FILTER environment variable.\n * Added experimental support for indexing transactions and related data items from the mempool. Enable it by setting ENABLE_MEMPOOL_WATCHER to 'true'.\n * Made on-demand data caching circuit breakers configurable via the GET_DATA_CIRCUIT_BREAKER_TIMEOUT_MS environment variable. This allows gateway operators to decide how much latency they will tolerate when serving data in exchange for more complete data indexing and caching.\n * Rename cache header from X-Cached to X-Cache to mimic typical CDN practices.\n * Add X-AR-IO-Hops and X-AR-IO-Origin headers in preparation for future peer-to-peer functionality.\n * Upgrade to Node.js v20 and switch to native test runner.\n\n\n# [Release 9] - 2024-04-10\n\n * Added\n * Added experimental Farcaster Frames support, enabling simple Arweave based Frames with button navigation. Transaction and data item data is now served under /local/farcaster/frame/. /local is used as a prefix to indicate this functionality is both experimental and local to a particular gateway rather than part of the global gateway API. Both GET and POST requests are supported.\n * Added an experimental local ArNS resolver. When enabled it removes dependence on arweave.net for ArNS resolution! Enable it by setting RUN_RESOLVER=TRUE, TRUSTED_ARNS_RESOLVER_TYPE=resolver, and TRUSTED_ARNS_RESOLVER_URL=http://resolver:6000 in your .env file.\n * Added an X-Cached header to data responses to indicate when data is served from the local cache rather than being retrieved from an external source. This is helpful for interfacing with external systems, debugging, and end-to-end testing.\n * Save hashes for unbundled data items during indexing. This enables reduction in data storage via hash based deduplication as well as more efficient peer-to-peer data retrieval in the future.\n\n\n# [Release 8] - 2024-03-14\n\n * Added\n \n * Added GraphQL SQL query debug logging to support trouble-shooting and performance optimization.\n * Added support for indexing data items (not GraphQL querying) based solely on tag name. (example use case: indexing all IPFS CID tagged data items).\n\n * Changes\n \n * Observer data sampling now uses randomized ranges to generate content hashes.\n * Reference gateway ArNS resolutions are now cached to improve report generation performance.\n * Contract interactions are now tested before posting using dryWrite to avoid submitting interactions that would fail.\n * /ar-io/observer/info now reports INVALID for wallets that fail to load.\n\n * Fixed\n \n * Fix data caching failure caused by incorrect method name in getData circuit breakers.\n * Fix healthcheck when ARNS_ROOT_HOST includes a subdomain.\n\n\n# [Release 7] - 2024 - 02 - 14\n\n * Added\n \n * Add support for notifying other services of transactions and data items using webhooks (see README for details).\n * Add support for filter negation (particularly useful for excluding large bundles from indexint).\n * Improve unbundling throughput by decoupling data fetching from unbundling.\n * Add Envoy and core service ARM builds.\n\n * Changed\n \n * Improve resouce cleanup and shutdown behavior.\n * Don't save Redis data to disk by default to help prevent memory issues on startup for small gateways.\n * Reduce the amount of data sampled from large files by the observer.\n * Ensure block poa2 field is not chached to reduce memory consumption.\n\n\n# [Release 6] - 2024-01-29\n\n * Fixed\n * Update observer to improve reliability of contract state synchronization and evaluation.\n\n\n# [Release 5] - 2024-01-25\n\n * Added\n \n * Added transaction offset indexing to support future data retrieval capabilities.\n * Enabled IPv6 support in Envoy config.\n * Added ability to configure observer report generation interval via the REPORT_GENERATION_INTERVAL_MS environmental variable. (Intended primarily for development and testing)\n\n * Changed\n \n * Updated observer to properly handle FQDN conflicts.\n * Renamed most created_at columns to index to indexed_at for consistency and clarity.\n\n * Fixed\n \n * Updated LMDB version to remove Buffer workaround and fix occasional block cache errors.\n\n\n# [Release 4] - 2024-01-11\n\n * Added\n \n * Added circuit breakers around data index access to reduce impact of DB access contention under heavy requests loads.\n * Added support for configuring data source priority via the ON_DEMAND_RETRIEVAL_ORDER environment variable.\n * Updated observer to a version that retrieves epoch start and duration from contract state.\n\n * Changed\n \n * Set the Redis max memory eviction policy to allkeys-lru.\n * Reduced default Redis max memory from 2GB to 256MB.\n * Improved predictability and performance of GraphQL queries.\n * Eliminated unbundling worker threads when filters are configured to skip indexing ANS-104 bundles.\n * Reduced the default number of ANS-104 worker threads from 2 to 1 when unbundling is enabled to conserve memory.\n * Increased nodejs max old space size to 8GB when ANS-104 workers > 1.\n\n * Fixed\n \n * Adjusted paths for chunks indexed by data root to include the full data root.\n\n\n# [Release 3] - 2023-12-05\n\n * Added\n \n * Support range requests (PR 61, PR 64)\n * Note: serving multiple ranges in a single request is not yet supported.\n * Release number in /ar-io/info response.\n * Redis header cache implementation (PR 62).\n * New default header cache (replaces old FS cache).\n * LMDB header cache implementation (PR 60).\n * Intended for use in development only.\n * Enable by setting CHAIN_CACHE_TYPE=lmdb.\n * Filesystem header cache cleanup worker (PR 68).\n * Enabled by default to cleanup old filesystem cache now that Redis is the new default.\n * Support for parallel ANS-104 unbundling (PR 65).\n\n * Changed\n \n * Used pinned container images tags for releases.\n * Default to Redis header cache when running via docker-compose.\n * Default to LMDB header cache when running via yarn start.\n\n * Fixed\n \n * Correct GraphQL pagination for transactions with duplicate tags.",normalizedContent:"# ar.io release notes\n\n\n# overview\n\nwelcome to the documentation page for the ar.io gateway release notes. here, you will find detailed information about each version of the ar.io gateway, including the enhancements, bug fixes, and any other changes introduced in every release. this page serves as a comprehensive resource to keep you informed about the latest developments and updates in the ar.io gateway. for those interested in exploring the source code, each release's code is readily accessible at our github repository: ar.io gateway change logs. stay updated with the continuous improvements and advancements in the ar.io gateway by referring to this page for all release-related information.\n\n\n# [release 17] - 2024-09-09\n\n\n# fixed\n\n * use the correct environment variable to populate webhook_block_filter in docker-compose.yaml.\n * don't cache data regions retrieved to satisfy range requests to avoid unnecessary storage overhead and prevent inserting invalid id to hash mappings into the data db.\n\n\n# added\n\n * added a new clickhouse based db backend. it can be used in combination with the sqlite db backend to enable batch loading of historical data from parquet. it also opens up the possibility of higher db performance and scalability. in its current state it should be considered a technology preview. it won't be useful to most users until we either provide parquet files to load into it or automate flushing of the sqlite db to it (both are planned in future release). it is not intended to be standalone solution. it supports bulk loading and efficient graphql querying of transactions and data items, but it relies on sqlite (or potentially another oltp in the future) to index recent data. these limitations allow greatly simplified schema and query construction. querying the new clickhouse db for transaction and data items via graphql is enabled by setting the 'clickhouse_url' environment variable.\n * added the ability to skip storing transaction signatures in the db by setting write_transaction_db_signatures to false. missing signatures are fetched from the trusted arweave node when needed for graphql results.\n * added a redis backed signature cache to support retrieving optimistically indexed data item signatures in graphql queries when writing data items signatures to the db has been disabled.\n * added on-demand and composite arns resolvers. the on-demand resolver fetches results directly from an ao cu. the composite resolver attempts resolution in the order specified by the arns_resolver_priority_order environment variable (defaults to 'on-demand,gateway').\n * added a queue_length prometheus metric to facilitate monitoring queues and inform future optimizations\n * added sqlite wal cleanup worker to help manage the size of the data.db-wal file. future improvements to data.db usage are also planned to further improve wal management.\n\n\n# changed\n\n * handle data requests by id on arns sites. this enables arns sites to use relative links to data by id.\n * replaced arns_resolver_type with arns_resolver_priority_order (defaults to 'on-demand,gateway').\n * introduced unbundling back pressure. when either data item data or graphql indexing queue depths are more than the value specified by the max_data_item_queue_size environment variable (defaults to 100000), unbundling is paused until the queues length falls bellow that threshold. this prevents the gateway from running out of memory when the unbundling rate exceeds the indexing rate while avoiding wasteful bundle reprocessing.\n * prioritized optimistic data item indexing by inserting optimistic data items at the front of the indexing queues.\n * prioritized nested bundle indexing by inserting nested bundles at the front of the unbundling queue.\n\n\n# [release 16] - 2024-08-09\n\n * fixed\n \n * fixed promise leak caused by missing await when saving data items to the db.\n * modified arns middleware to not attempt resolution when receiving requests for a different hostname than the one specified by arns_root_host.\n\n * added\n \n * added support for returning content-encoding http headers based on user specified content-encoding tags.\n * added isnestedbundle filter enables that matches any nested bundle when indexing. this enables composite unbundling filters that match a set of l1 tags and bundles nested under them.\n * added ability to skip writing ans-104 signatures to the db and load them based on offsets from the data instead. this significantly reduces the size of the bundles db. it can be enabled by setting the write_ans104_data_item_db_signatures environment variable to false.\n * added data_item_data_indexed_total prometheus counter to count data items with data attributes indexed.\n\n * changed\n \n * queue data attributes writes when serving data rather than writing them syncronously.\n * reduced the default data indexer count to 1 to lessen the load on the data db.\n * switched a number of overly verbose info logs to debug level.\n * removed docker-compose on-failure restart limits to ensure that services restart no matter how many times they fail.\n * modified the data_items_indexed_total prometheus counter to count data items indexed for graphql querying instead of data attributes.\n * increased aggressiveness of contiguous data cleanup. it now pauses 5 seconds instead of 10 seconds per batch and runs every 4 hours instead of every 24 hours.\n\n\n# [release 15] - 2024-07-19\n\n * fixed\n \n * fixed query error that was preventing bundles from being marked as fully imported in the database.\n\n * added\n \n * adjusted data item indexing to record data item signature types in the db. this helps distinguish between signatures using different key formats, and will enable querying by signature type in the future.\n * adjusted data item indexing to record offsets for data items within bundles and signatures and owners within data items. in the future this will allow us to avoid saving owners and signatures in the db and thus considerably reduce the size of the bundles db.\n * added arns_cache_ttl_ms environment variable to control the ttl of arns cache entries (defaults to 1 hour).\n * added support for multiple ranges in a single http range request.\n * added experimental chunk post endpoint that broadcasts chunks to the comma-separate list of urls in the chunk_broadcast_urls environment variable. it is available at /chunk on the internal gateway service port (4000 by default) but is not yet exposed through envoy.\n * added support for running an ao cu adjacent to the gateway (see readme.md for details).\n * added x-arns-process-id to arns resolved name headers.\n * added a set of ao_... environment variables for specifying which ao urls should be used (see docker-compose.yaml for the complete list). the ao_cu_url is of particular use since the core and resolver services only perform ao reads and only the cu is needed for reads.\n\n * changed\n \n * split the monolithic docker-compose.yaml into docker-compose.yaml, docker-compose.bundler.yaml, and docker-compose.ao.yaml (see readme for details).\n * replaced references to 'docker-compose' with 'docker compose' in the docs since the former is mostly deprecated.\n * reduce max fork depth from 50 to 18 inline to reflect arweave 2.7.2 protocol changes.\n * increased the aggressiveness of bundle reprocessing by reducing reprocessing interval from 10 minutes to 5 minutes and raising reprocessing batch size from 100 to 1000.\n * use a patched version of litestream to work around insufficient s3 multipart upload size in the upstream version.\n\n\n# [release 14] - 2024-06-26\n\n * fixed\n \n * correctly handle manifest index after paths.\n\n\n# [release 13] - 2024-06-24\n\n * added\n \n * added support for optimistically reading data items uploaded using the integrated turbo bundler via the localstack s3 interface.\n * added x-ar-io-origin-node-release header to outbound data requests.\n * added hops, origin, and originnoderelease query params to outbound data requests.\n * added support for fallback in v0.2 manifests that is used if no path in the manifest is matched.\n\n * changed\n \n * updated observer to read prescribed names from and write observations to the ar.io ao network process.\n * updated resolver to read from the ar.io ao network process.\n\n * fixed\n \n * modified optimistic indexing of data items to use a null parent_id when inserting into the db instead of a placeholder value. this prevents unexpected non-null bundledin values in graphql results for optimistically indexed data items.\n * modified graphql query logic to require an id for single block graphql queries. previously queries missing an id were returning an internal sqlite error. this represents a small departure from arweave.net's query logic which returns the latest block for these queries. we recommend querying blocks instead of block in cases where the latest block is desired.\n * adjusted observer health check to reflect port change to 5050.\n\n * security\n \n * modified docker-compose.yaml to only expose redis, postgresql, and localstack ports internally. this protects gateways that neglect to deploy behind a firewall, reverse proxy, or load balancer.\n\n\n# [release 12] - 2024-06-05\n\n * added\n \n * added /ar-io/admin/queue-data-item endpoint for queuing data item headers for indexing before the bundles containing them are processed. this allows trusted bundlers to make their data items quickly available to be queried via graphql without having to wait for bundle data submission or unbundling.\n * added experimental support for retrieving contiguous data from s3. see aws_* environment variables documentation for configuration details. in conjuction with a local turbo bundler this allows optimistic bundle (but not yet data item) retrieval.\n * add experimental support for fetching data from gateway peers. it can be enabled by adding ario-peer to on_demand_retrieval_order. note: do not expect this work reliably yet! this functionality is in active development and will be improved in future releases.\n * add import_attempt_count to bundle records to enable future bundle import retry optimizations.\n\n * changed\n \n * removed version from docker-compose.yaml to avoid warnings with recent versions of docker-compose.\n * switched default observer port from 5000 to 5050 to avoid conflict on os x. since envoy is used to provide external access to the observer api this should have no user visible effect.\n\n\n# [release 11] - 2024-05-21\n\n * added\n \n * added arweave_tx_fetch_total prometheus metric to track counts of transaction headers fetched from the trusted node and arweave network peers.\n\n * changed\n \n * revert to using unnamed bind mounts due to cross platform issues with named volumes.\n\n\n# [release 10] - 2024-05-20\n\n * added\n \n * added experimental support for streaming sqlite backups to s3 (and compatible services) using litestream. start the service using the docker-compose \"litestream\" profile to use it, and see the ar_io_sqlite_backup_* environment variables documentation for further details.\n * added /ar-io/admin/queue-bundle endpoint for queueing bundles for import for import before they're in the mempool. in the future this will enable optimistic indexing when combined with a local trusted bundler.\n * added support for triggering webhooks when blocks are imported matching the filter specified by the webhook_block_filter environment variable.\n * added experimental support for indexing transactions and related data items from the mempool. enable it by setting enable_mempool_watcher to 'true'.\n * made on-demand data caching circuit breakers configurable via the get_data_circuit_breaker_timeout_ms environment variable. this allows gateway operators to decide how much latency they will tolerate when serving data in exchange for more complete data indexing and caching.\n * rename cache header from x-cached to x-cache to mimic typical cdn practices.\n * add x-ar-io-hops and x-ar-io-origin headers in preparation for future peer-to-peer functionality.\n * upgrade to node.js v20 and switch to native test runner.\n\n\n# [release 9] - 2024-04-10\n\n * added\n * added experimental farcaster frames support, enabling simple arweave based frames with button navigation. transaction and data item data is now served under /local/farcaster/frame/. /local is used as a prefix to indicate this functionality is both experimental and local to a particular gateway rather than part of the global gateway api. both get and post requests are supported.\n * added an experimental local arns resolver. when enabled it removes dependence on arweave.net for arns resolution! enable it by setting run_resolver=true, trusted_arns_resolver_type=resolver, and trusted_arns_resolver_url=http://resolver:6000 in your .env file.\n * added an x-cached header to data responses to indicate when data is served from the local cache rather than being retrieved from an external source. this is helpful for interfacing with external systems, debugging, and end-to-end testing.\n * save hashes for unbundled data items during indexing. this enables reduction in data storage via hash based deduplication as well as more efficient peer-to-peer data retrieval in the future.\n\n\n# [release 8] - 2024-03-14\n\n * added\n \n * added graphql sql query debug logging to support trouble-shooting and performance optimization.\n * added support for indexing data items (not graphql querying) based solely on tag name. (example use case: indexing all ipfs cid tagged data items).\n\n * changes\n \n * observer data sampling now uses randomized ranges to generate content hashes.\n * reference gateway arns resolutions are now cached to improve report generation performance.\n * contract interactions are now tested before posting using drywrite to avoid submitting interactions that would fail.\n * /ar-io/observer/info now reports invalid for wallets that fail to load.\n\n * fixed\n \n * fix data caching failure caused by incorrect method name in getdata circuit breakers.\n * fix healthcheck when arns_root_host includes a subdomain.\n\n\n# [release 7] - 2024 - 02 - 14\n\n * added\n \n * add support for notifying other services of transactions and data items using webhooks (see readme for details).\n * add support for filter negation (particularly useful for excluding large bundles from indexint).\n * improve unbundling throughput by decoupling data fetching from unbundling.\n * add envoy and core service arm builds.\n\n * changed\n \n * improve resouce cleanup and shutdown behavior.\n * don't save redis data to disk by default to help prevent memory issues on startup for small gateways.\n * reduce the amount of data sampled from large files by the observer.\n * ensure block poa2 field is not chached to reduce memory consumption.\n\n\n# [release 6] - 2024-01-29\n\n * fixed\n * update observer to improve reliability of contract state synchronization and evaluation.\n\n\n# [release 5] - 2024-01-25\n\n * added\n \n * added transaction offset indexing to support future data retrieval capabilities.\n * enabled ipv6 support in envoy config.\n * added ability to configure observer report generation interval via the report_generation_interval_ms environmental variable. (intended primarily for development and testing)\n\n * changed\n \n * updated observer to properly handle fqdn conflicts.\n * renamed most created_at columns to index to indexed_at for consistency and clarity.\n\n * fixed\n \n * updated lmdb version to remove buffer workaround and fix occasional block cache errors.\n\n\n# [release 4] - 2024-01-11\n\n * added\n \n * added circuit breakers around data index access to reduce impact of db access contention under heavy requests loads.\n * added support for configuring data source priority via the on_demand_retrieval_order environment variable.\n * updated observer to a version that retrieves epoch start and duration from contract state.\n\n * changed\n \n * set the redis max memory eviction policy to allkeys-lru.\n * reduced default redis max memory from 2gb to 256mb.\n * improved predictability and performance of graphql queries.\n * eliminated unbundling worker threads when filters are configured to skip indexing ans-104 bundles.\n * reduced the default number of ans-104 worker threads from 2 to 1 when unbundling is enabled to conserve memory.\n * increased nodejs max old space size to 8gb when ans-104 workers > 1.\n\n * fixed\n \n * adjusted paths for chunks indexed by data root to include the full data root.\n\n\n# [release 3] - 2023-12-05\n\n * added\n \n * support range requests (pr 61, pr 64)\n * note: serving multiple ranges in a single request is not yet supported.\n * release number in /ar-io/info response.\n * redis header cache implementation (pr 62).\n * new default header cache (replaces old fs cache).\n * lmdb header cache implementation (pr 60).\n * intended for use in development only.\n * enable by setting chain_cache_type=lmdb.\n * filesystem header cache cleanup worker (pr 68).\n * enabled by default to cleanup old filesystem cache now that redis is the new default.\n * support for parallel ans-104 unbundling (pr 65).\n\n * changed\n \n * used pinned container images tags for releases.\n * default to redis header cache when running via docker-compose.\n * default to lmdb header cache when running via yarn start.\n\n * fixed\n \n * correct graphql pagination for transactions with duplicate tags.",charsets:{}},{title:"Join the AR.IO Testnet",frontmatter:{prev:!1,permalink:"/gateways/testnet/",tags:["testnet","join","application","jwk","qty","fqdn","label","note","properties"]},regularPath:"/gateways/ar-io-node/testnet.html",relativePath:"gateways/ar-io-node/testnet.md",key:"v-4222367a",path:"/gateways/testnet/",headers:[{level:2,title:"Prerequisites",slug:"prerequisites",normalizedTitle:"prerequisites",charIndex:29},{level:2,title:"Submit an Application",slug:"submit-an-application",normalizedTitle:"submit an application",charIndex:454}],headersStr:"Prerequisites Submit an Application",content:"# Join the AR.IO Testnet\n\n\n# Prerequisites\n\n 1. Must have a fully functional AR.IO gateway.\n \n * This includes the ability to resolve ArNS subdomains.\n * Follow installation instructions for windows or linux and get help from the ar.io community.\n\n 2. Gateway must be associated with an Arweave Wallet.\n \n * Learn about creating Arweave wallets here\n\n 3. Arweave wallet must be funded with enough AR tokens to pay for transaction gas.\n\n\n# Submit an Application\n\nJoining the ar.io Testnet requires staking a minimum of 50,000 Test IO Tokens. You must have Test IO Tokens before you are able to join. Test IO Tokens are currently not being distributed.\n\nNew applications for joining the Testnet are not currently being accepted. Be sure to join the ar.io Discord to stay up to date on Testnet status and possible future availability prior to the launch of the Mainnet. --\x3e",normalizedContent:"# join the ar.io testnet\n\n\n# prerequisites\n\n 1. must have a fully functional ar.io gateway.\n \n * this includes the ability to resolve arns subdomains.\n * follow installation instructions for windows or linux and get help from the ar.io community.\n\n 2. gateway must be associated with an arweave wallet.\n \n * learn about creating arweave wallets here\n\n 3. arweave wallet must be funded with enough ar tokens to pay for transaction gas.\n\n\n# submit an application\n\njoining the ar.io testnet requires staking a minimum of 50,000 test io tokens. you must have test io tokens before you are able to join. test io tokens are currently not being distributed.\n\nnew applications for joining the testnet are not currently being accepted. be sure to join the ar.io discord to stay up to date on testnet status and possible future availability prior to the launch of the mainnet. --\x3e",charsets:{}},{title:"Troubleshooting",frontmatter:{permalink:"/troubleshooting"},regularPath:"/gateways/ar-io-node/troubleshooting.html",relativePath:"gateways/ar-io-node/troubleshooting.md",key:"v-0cbb8c5a",path:"/troubleshooting/",headers:[{level:2,title:"My Gateway Seems to be Running but...",slug:"my-gateway-seems-to-be-running-but",normalizedTitle:"my gateway seems to be running but...",charIndex:22},{level:3,title:"",slug:"",normalizedTitle:"",charIndex:0},{level:3,title:"",slug:"-2",normalizedTitle:"",charIndex:0},{level:3,title:"",slug:"-3",normalizedTitle:"",charIndex:0},{level:3,title:"",slug:"-4",normalizedTitle:"",charIndex:0},{level:3,title:"",slug:"-5",normalizedTitle:"",charIndex:0},{level:3,title:"",slug:"-6",normalizedTitle:"",charIndex:0},{level:3,title:"",slug:"-7",normalizedTitle:"",charIndex:0},{level:3,title:"",slug:"-8",normalizedTitle:"",charIndex:0},{level:2,title:"My Gateway was Running, but now it isn't",slug:"my-gateway-was-running-but-now-it-isn-t",normalizedTitle:"my gateway was running, but now it isn't",charIndex:4449},{level:3,title:"",slug:"-9",normalizedTitle:"",charIndex:0},{level:2,title:"I am having Trouble Getting my Gateway Set up",slug:"i-am-having-trouble-getting-my-gateway-set-up",normalizedTitle:"i am having trouble getting my gateway set up",charIndex:5127},{level:3,title:"",slug:"-10",normalizedTitle:"",charIndex:0},{level:3,title:"",slug:"-11",normalizedTitle:"",charIndex:0},{level:3,title:"",slug:"-12",normalizedTitle:"",charIndex:0},{level:2,title:"Quick Lookup",slug:"quick-lookup",normalizedTitle:"quick lookup",charIndex:6682}],headersStr:"My Gateway Seems to be Running but... My Gateway was Running, but now it isn't I am having Trouble Getting my Gateway Set up Quick Lookup",content:'# Troubleshooting\n\n\n# My Gateway Seems to be Running but...\n\n\n#\n\nMy release number doesn\'t match the latest version, or includes "-pre"\n\nIf your release number when you go to /ar-io/info is lower than the current release, you simply need to upgrade your gateway in order to reach the latest release.\n\nIf your release number includes the suffix "-pre" it means you are running your gateway from the development branch of the github repository, instead of the main branch. The development branch is used for staging work that the engineering team is in the middle of. Because of this, it can be much less stable than the main branch used for production and can cause significant issues.\n\nEnsure that you are running the latest release, from the main branch, by running the below commands in your terminal:\n\nsudo docker-compose down --rmi all\n\ngit checkout main\n\ngit pull\n\nsudo docker-compose up -d\n\n\nIf this doesn\'t resolve the issue, you can also try a more extreme method of clearing out the incorrect docker images:\n\nsudo docker-compose down\n\nsudo docker system prune -a\n\nsudo docker-compose up -d\n\n\n\n#\n\nIt appears offline on Viewblock or ar://gateways\n\nViewblock and ar://gateways use a very simple ping method for determining if a gateway is "up". There are plenty of reasons why this ping may fail while the gateway is running perfectly, so showing as down is not cause for concern. Just verify that your gateway is still running, and wait. Your gateway will show as up again soon.\n\n\n#\n\n< gateway >/ar-io/observer/reports/current just says "report pending"\n\nThis is normal. Your Observer is working to generate a report and that report will be displayed once it is complete.\n\n\n#\n\nMy Observer is showing me the error "error: Error reading interaction: Cannot read properties of undefined"\n\nThis is not an issue with your observer. The short explanation is that your Observer is looking for tasks assigned to it by the ar.io network contract, but there isnt anything there. You can safely ignore this error message.\n\n\n#\n\nObserving my gateway shows failures\n\nWhen observing a gateway, there are two main pass/fail tests. "Ownership" and "ArNS Assessment"\n\n * Ownership: This tests to see if the value set in your gateway AR_IO_WALLET value (in .env) matches the wallet used to join the AR.IO Network. If they don\'t match, update the value in your .env file and restart your gateway.\n\n * ArNS Assessment: This tests to see if a gateway is able to resolve ArNS names correctly. The first thing you should check is if you have the ARNS_ROOT_HOST value set in your .env file. If not, set the value and restart your gateway. If this value is set, check to make sure you have current DNS records and SSL certificates for wildcard subdomains on your gateway.\n\n\n#\n\nI updated my .env settings, but nothing changed on my gateway\n\nOnce you edit your .env file, you need to "rebuild" your gateway for the changes to take effect. As of release 3, every time you start your gateway with docker-compose it is automatically rebuilt. So all you need to do is shut your gateway down and restart it.\n\n\n#\n\nI am getting an out of disk space error, but I still have open storage space on my computer\n\nThe most likely cause of this is inode exhaustion. Test this by running the command:\n\ndf -i\n\n\nIf one of the lines in the output says 100%, you have run out of inodes and so your filesystem is not capable of creating new files, even if you have available space. The solution is to delete files from your data folder in order to free up inodes.\n\nThis was a common issue prior to release #3, when Redis caching was introduced to reduce the number of small files created. If you are using an older version of the gateway, consider upgrading to mitigate the risk of inode exhaustion.\n\n\n#\n\nI can\'t load ArNS names\n\nThe first thing you should check if your gateway is not resolving ArNS names is that you have ARNS_ROOT_HOST set in your .env file. If not, set it to your domain name used for the gateway. For example, ARNS_ROOT_HOST=arweave.dev.\n\nOnce this value is set, restart your gateway for the changes to take effect.\n\nIf that doesn\'t resolve the issue, check your dns records. You need to have a wildcard subdomain ( *.< your-domain > ) set with your domain registrar so that ArNS names will actually point at your gateway. You can set this record, and generate an SSL certificate for it, in the same way you set the records for your primary domain.\n\n\n\n# My Gateway was Running, but now it isn\'t\n\n\n#\n\nWhen I try to access my gateway in a browser I get a "Your connection is not private" error\n\nThis error message means that your SSL certificates have expired. You need to renew your certificates by running the same certbot command you used when you initially started your gateway:\n\nsudo certbot certonly --manual --preferred-challenges dns --email -d .com -d \'*..com\'\n\n\nCertbot SSL certificates expire after 90 days, and you will need to rerun this command to renew every time. If you provide an email address, you will receive an email letting you know when it is time to renew.\n\n\n\n# I am having Trouble Getting my Gateway Set up\n\n\n\n#\n\nI set my gateway up, but when I go to my domain I get a 404/Nginx error\n\nIf you navigate to your domain and see a 404 error from Nginx (the reverse proxy server used in the setup guide) it means that your domain is correctly pointed at the machine running your gateway, but you have not properly configured your Nginx settings (or your gateway is not running).\n\nThe Set up Networking section of the setup guide has detailed instructions on configuring your Nginx server. If all else fails, try restarting Nginx, that usually clears any issues with the server clinging to old configurations.\n\nsudo service nginx restart\n\n\n\n#\n\nWhen I visit my domain I see a 502 error from Nginx\n\nA 502 error from Nginx means that Nginx is working correctly, but it is receiving an error from your gateway when it tries to forward traffic.\n\n\n#\n\nI am having trouble generating my SSL certificates\n\nWhen using the manual certbot command provided in the setup guide:\n\nsudo certbot certonly --manual --preferred-challenges dns --email -d .com -d \'*..com\'\n\n\nYou need to be sure that you are waiting after creating your TXT records for them to completely propagate. You can check propagation using a tool like dnschecker.org.\n\nIf you continue to have issues, you can check the official certbot instructions guide.\n\n\nIf you do not see your issue listed here, or if you were not able to solve your problem with the above information, feel free to reach out in the ar.io discord.\n\n\n# Quick Lookup\n\nBelow is a quick summary of what you should check when troubleshooting your gateway. Find more detailed information in the sections above.\n\nISSUE WHAT TO CHECK\nMy release number is wrong Pull the latest github updates and make sure you are on the\n main branch\nGateway appears offline on Viewblock or ar://gateways Probably fine, but verify that your gateway is still\n running.\n\'/ar-io/observer/reports/current\' just says "report pending" Normal behavior, wait for the report to complete.\nObserver error "Cannot read properties of undefined" Normal behavior, Observer is checking for data not\n implemented yet.\nObserving my gateway shows failures Check AR_IO_WALLET and ARNS_ROOT_HOST settings.\nUpdated .env settings not reflected on gateway Rebuild your gateway after editing .env file.\nOut of disk space error Check for inode exhaustion and delete files if necessary.\nCan\'t load ArNS names Check ARNS_ROOT_HOST setting in .env file, and DNS records.\n"Your connection is not private" error Generate or renew SSL certificates.\n404/Nginx error when accessing domain Check Nginx settings and restart Nginx if necessary.\n502 error from Nginx Check for errors in your gateway.\nTrouble generating SSL certificates Ensure TXT records have propagated and follow certbot\n instructions.',normalizedContent:'# troubleshooting\n\n\n# my gateway seems to be running but...\n\n\n#\n\nmy release number doesn\'t match the latest version, or includes "-pre"\n\nif your release number when you go to /ar-io/info is lower than the current release, you simply need to upgrade your gateway in order to reach the latest release.\n\nif your release number includes the suffix "-pre" it means you are running your gateway from the development branch of the github repository, instead of the main branch. the development branch is used for staging work that the engineering team is in the middle of. because of this, it can be much less stable than the main branch used for production and can cause significant issues.\n\nensure that you are running the latest release, from the main branch, by running the below commands in your terminal:\n\nsudo docker-compose down --rmi all\n\ngit checkout main\n\ngit pull\n\nsudo docker-compose up -d\n\n\nif this doesn\'t resolve the issue, you can also try a more extreme method of clearing out the incorrect docker images:\n\nsudo docker-compose down\n\nsudo docker system prune -a\n\nsudo docker-compose up -d\n\n\n\n#\n\nit appears offline on viewblock or ar://gateways\n\nviewblock and ar://gateways use a very simple ping method for determining if a gateway is "up". there are plenty of reasons why this ping may fail while the gateway is running perfectly, so showing as down is not cause for concern. just verify that your gateway is still running, and wait. your gateway will show as up again soon.\n\n\n#\n\n< gateway >/ar-io/observer/reports/current just says "report pending"\n\nthis is normal. your observer is working to generate a report and that report will be displayed once it is complete.\n\n\n#\n\nmy observer is showing me the error "error: error reading interaction: cannot read properties of undefined"\n\nthis is not an issue with your observer. the short explanation is that your observer is looking for tasks assigned to it by the ar.io network contract, but there isnt anything there. you can safely ignore this error message.\n\n\n#\n\nobserving my gateway shows failures\n\nwhen observing a gateway, there are two main pass/fail tests. "ownership" and "arns assessment"\n\n * ownership: this tests to see if the value set in your gateway ar_io_wallet value (in .env) matches the wallet used to join the ar.io network. if they don\'t match, update the value in your .env file and restart your gateway.\n\n * arns assessment: this tests to see if a gateway is able to resolve arns names correctly. the first thing you should check is if you have the arns_root_host value set in your .env file. if not, set the value and restart your gateway. if this value is set, check to make sure you have current dns records and ssl certificates for wildcard subdomains on your gateway.\n\n\n#\n\ni updated my .env settings, but nothing changed on my gateway\n\nonce you edit your .env file, you need to "rebuild" your gateway for the changes to take effect. as of release 3, every time you start your gateway with docker-compose it is automatically rebuilt. so all you need to do is shut your gateway down and restart it.\n\n\n#\n\ni am getting an out of disk space error, but i still have open storage space on my computer\n\nthe most likely cause of this is inode exhaustion. test this by running the command:\n\ndf -i\n\n\nif one of the lines in the output says 100%, you have run out of inodes and so your filesystem is not capable of creating new files, even if you have available space. the solution is to delete files from your data folder in order to free up inodes.\n\nthis was a common issue prior to release #3, when redis caching was introduced to reduce the number of small files created. if you are using an older version of the gateway, consider upgrading to mitigate the risk of inode exhaustion.\n\n\n#\n\ni can\'t load arns names\n\nthe first thing you should check if your gateway is not resolving arns names is that you have arns_root_host set in your .env file. if not, set it to your domain name used for the gateway. for example, arns_root_host=arweave.dev.\n\nonce this value is set, restart your gateway for the changes to take effect.\n\nif that doesn\'t resolve the issue, check your dns records. you need to have a wildcard subdomain ( *.< your-domain > ) set with your domain registrar so that arns names will actually point at your gateway. you can set this record, and generate an ssl certificate for it, in the same way you set the records for your primary domain.\n\n\n\n# my gateway was running, but now it isn\'t\n\n\n#\n\nwhen i try to access my gateway in a browser i get a "your connection is not private" error\n\nthis error message means that your ssl certificates have expired. you need to renew your certificates by running the same certbot command you used when you initially started your gateway:\n\nsudo certbot certonly --manual --preferred-challenges dns --email -d .com -d \'*..com\'\n\n\ncertbot ssl certificates expire after 90 days, and you will need to rerun this command to renew every time. if you provide an email address, you will receive an email letting you know when it is time to renew.\n\n\n\n# i am having trouble getting my gateway set up\n\n\n\n#\n\ni set my gateway up, but when i go to my domain i get a 404/nginx error\n\nif you navigate to your domain and see a 404 error from nginx (the reverse proxy server used in the setup guide) it means that your domain is correctly pointed at the machine running your gateway, but you have not properly configured your nginx settings (or your gateway is not running).\n\nthe set up networking section of the setup guide has detailed instructions on configuring your nginx server. if all else fails, try restarting nginx, that usually clears any issues with the server clinging to old configurations.\n\nsudo service nginx restart\n\n\n\n#\n\nwhen i visit my domain i see a 502 error from nginx\n\na 502 error from nginx means that nginx is working correctly, but it is receiving an error from your gateway when it tries to forward traffic.\n\n\n#\n\ni am having trouble generating my ssl certificates\n\nwhen using the manual certbot command provided in the setup guide:\n\nsudo certbot certonly --manual --preferred-challenges dns --email -d .com -d \'*..com\'\n\n\nyou need to be sure that you are waiting after creating your txt records for them to completely propagate. you can check propagation using a tool like dnschecker.org.\n\nif you continue to have issues, you can check the official certbot instructions guide.\n\n\nif you do not see your issue listed here, or if you were not able to solve your problem with the above information, feel free to reach out in the ar.io discord.\n\n\n# quick lookup\n\nbelow is a quick summary of what you should check when troubleshooting your gateway. find more detailed information in the sections above.\n\nissue what to check\nmy release number is wrong pull the latest github updates and make sure you are on the\n main branch\ngateway appears offline on viewblock or ar://gateways probably fine, but verify that your gateway is still\n running.\n\'/ar-io/observer/reports/current\' just says "report pending" normal behavior, wait for the report to complete.\nobserver error "cannot read properties of undefined" normal behavior, observer is checking for data not\n implemented yet.\nobserving my gateway shows failures check ar_io_wallet and arns_root_host settings.\nupdated .env settings not reflected on gateway rebuild your gateway after editing .env file.\nout of disk space error check for inode exhaustion and delete files if necessary.\ncan\'t load arns names check arns_root_host setting in .env file, and dns records.\n"your connection is not private" error generate or renew ssl certificates.\n404/nginx error when accessing domain check nginx settings and restart nginx if necessary.\n502 error from nginx check for errors in your gateway.\ntrouble generating ssl certificates ensure txt records have propagated and follow certbot\n instructions.',charsets:{}},{title:"Upgrading your Gateway",frontmatter:{permalink:"/gateways/upgrade/"},regularPath:"/gateways/ar-io-node/upgrading.html",relativePath:"gateways/ar-io-node/upgrading.md",key:"v-68d9087a",path:"/gateways/upgrade/",headers:[{level:2,title:"Prerequisites",slug:"prerequisites",normalizedTitle:"prerequisites",charIndex:347},{level:2,title:"Checking your Release Number",slug:"checking-your-release-number",normalizedTitle:"checking your release number",charIndex:492},{level:2,title:"Upgrade Steps",slug:"upgrade-steps",normalizedTitle:"upgrade steps",charIndex:1055}],headersStr:"Prerequisites Checking your Release Number Upgrade Steps",content:"# Upgrading your Gateway\n\nTo ensure the optimal performance and security of your AR.IO Gateway, it's essential to regularly upgrade to the latest version. Notably, indexed data resides separate from Docker. As a result, neither upgrading the Gateway nor pruning Docker will erase your data or progress. Here's how you can perform the upgrade:\n\n\n# Prerequisites\n\n * Your Gateway should have been cloned using git. If you haven't, follow the installation instructions for windows or linux.\n\n\n# Checking your Release Number\n\nEffective with release 3, you can view the currently implemented release on any gateway by visiting https:///ar-io/info in a browser. Be sure to replace with the domain of the gateway you are checking.\n\nIf the release number displayed includes -pre it means that your gateway is using the develop branch of the github repo for the gateway code. Follow steps in our troubleshooting guide to switch over to the more stable main branch.\n\nAnnouncements will be made in our discord server showing each new release.\n\n\n# Upgrade Steps\n\n 1. Pull the latest changes from the repository\n \n Navigate to your cloned repository directory and execute the following command:\n \n git pull\n \n\n 2. Shut down Docker\n \n Depending on your operating system, use the respective commands:\n \n Linux\n \n sudo docker-compose down -v\n \n \n Windows\n \n \n docker-compose down -v\n \n \n\n 3. Prune Docker (Optional)\n \n It's a good practice to clean up unused Docker resources. Again, use the command based on your OS:\n \n NOTE: This will erase all inactive docker containers on your machine. If you use docker for anything beyond running a gateway be extremely careful using this command.\n \n Linux\n \n \n sudo docker system prune\n \n \n \n Windows\n \n \n docker system prune\n \n \n\n 4. Check for New Environmental Variables\n \n Read the update release change logs and community announcements to see if the new version includes any new environmental variables that you should set before restarting your gateway.\n\n 5. Restart the Docker container\n \n Finally, start the Docker container again to implement the changes:\n \n Linux\n \n sudo docker-compose up -d\n \n \n Windows\n \n docker-compose up -d\n \n \n NOTE: Effective with Release #3, it is no longer required to include the --build flag when starting your gateway. Docker will automatically build using the image specified in the docker-commpose.yaml file.\n\nThat's it! Your AR.IO Gateway is now upgraded to the latest version. Ensure to test and verify that everything is functioning as expected. If you encounter any issues, reach out to the AR.IO community for assistance.",normalizedContent:"# upgrading your gateway\n\nto ensure the optimal performance and security of your ar.io gateway, it's essential to regularly upgrade to the latest version. notably, indexed data resides separate from docker. as a result, neither upgrading the gateway nor pruning docker will erase your data or progress. here's how you can perform the upgrade:\n\n\n# prerequisites\n\n * your gateway should have been cloned using git. if you haven't, follow the installation instructions for windows or linux.\n\n\n# checking your release number\n\neffective with release 3, you can view the currently implemented release on any gateway by visiting https:///ar-io/info in a browser. be sure to replace with the domain of the gateway you are checking.\n\nif the release number displayed includes -pre it means that your gateway is using the develop branch of the github repo for the gateway code. follow steps in our troubleshooting guide to switch over to the more stable main branch.\n\nannouncements will be made in our discord server showing each new release.\n\n\n# upgrade steps\n\n 1. pull the latest changes from the repository\n \n navigate to your cloned repository directory and execute the following command:\n \n git pull\n \n\n 2. shut down docker\n \n depending on your operating system, use the respective commands:\n \n linux\n \n sudo docker-compose down -v\n \n \n windows\n \n \n docker-compose down -v\n \n \n\n 3. prune docker (optional)\n \n it's a good practice to clean up unused docker resources. again, use the command based on your os:\n \n note: this will erase all inactive docker containers on your machine. if you use docker for anything beyond running a gateway be extremely careful using this command.\n \n linux\n \n \n sudo docker system prune\n \n \n \n windows\n \n \n docker system prune\n \n \n\n 4. check for new environmental variables\n \n read the update release change logs and community announcements to see if the new version includes any new environmental variables that you should set before restarting your gateway.\n\n 5. restart the docker container\n \n finally, start the docker container again to implement the changes:\n \n linux\n \n sudo docker-compose up -d\n \n \n windows\n \n docker-compose up -d\n \n \n note: effective with release #3, it is no longer required to include the --build flag when starting your gateway. docker will automatically build using the image specified in the docker-commpose.yaml file.\n\nthat's it! your ar.io gateway is now upgraded to the latest version. ensure to test and verify that everything is functioning as expected. if you encounter any issues, reach out to the ar.io community for assistance.",charsets:{}},{title:"Windows Installation Instructions",frontmatter:{prev:!1,next:"/gateways/ar-io-node/testnet.html",permalink:"/gateways/ar-io-node/windows-setup/"},regularPath:"/gateways/ar-io-node/windows-setup.html",relativePath:"gateways/ar-io-node/windows-setup.md",key:"v-2aed10ba",path:"/gateways/ar-io-node/windows-setup/",headers:[{level:2,title:"Overview",slug:"overview",normalizedTitle:"overview",charIndex:40},{level:2,title:"Prerequisites",slug:"prerequisites",normalizedTitle:"prerequisites",charIndex:387},{level:2,title:"Install Required Packages",slug:"install-required-packages",normalizedTitle:"install required packages",charIndex:547},{level:2,title:"Clone the Repository",slug:"clone-the-repository",normalizedTitle:"clone the repository",charIndex:1413},{level:2,title:"Create the Environment File",slug:"create-the-environment-file",normalizedTitle:"create the environment file",charIndex:2230},{level:2,title:"Supply Your Observer Wallet Keyfile:",slug:"supply-your-observer-wallet-keyfile",normalizedTitle:"supply your observer wallet keyfile:",charIndex:4801},{level:2,title:"Start the Docker Containers",slug:"start-the-docker-containers",normalizedTitle:"start the docker containers",charIndex:5293},{level:2,title:"Set Up Router Port Forwarding",slug:"set-up-router-port-forwarding",normalizedTitle:"set up router port forwarding",charIndex:6796},{level:2,title:"Install and Configure NGINX Docker",slug:"install-and-configure-nginx-docker",normalizedTitle:"install and configure nginx docker",charIndex:9054}],headersStr:"Overview Prerequisites Install Required Packages Clone the Repository Create the Environment File Supply Your Observer Wallet Keyfile: Start the Docker Containers Set Up Router Port Forwarding Install and Configure NGINX Docker",content:'# Windows Installation Instructions\n\n\n# Overview\n\nThis guide provides step-by-step instructions for setting up the AR.IO node on a Windows computer. It covers installing necessary software, cloning the repository, creating an environment file, starting the Docker container, setting up networking, and installing and configuring NGINX Docker. No prior coding experience is required.\n\n\n# Prerequisites\n\nBefore starting the installation process, ensure you have the following:\n\n * A Windows computer\n * Administrative privileges on the computer\n\n\n# Install Required Packages\n\n 1. Install Docker:\n \n * Download Docker Desktop for Windows from here.\n * Run the installer and follow the prompts.\n * During installation, make sure to select the option to use WSL (Windows Subsystem for Linux) rather than Hyper-V.\n * Restart your PC.\n * Update Windows Subsystem for Linux (WSL):\n * Open the command prompt as an administrator:\n * Press Windows Key + R.\n * Type cmd and press Enter.\n * Right-click on the "Command Prompt" application in the search results.\n * Select "Run as administrator" from the context menu.\n * Run the following commands:\n \n wsl --update\n wsl --shutdown\n \n \n * Restart Docker Desktop.\n\n 2. Install Git:\n \n * Download Git for Windows from here.\n * Run the installer and use the default settings.\n\n\n# Clone the Repository\n\n 1. Clone the main repository:\n * Open the command prompt:\n * Press Windows Key + R.\n * Type cmd and press Enter.\n * Navigate to the directory where you want to clone the repository:\n * Use the cd command to change directories. For example, to navigate to the Documents directory:\n \n cd Documents\n \n \n * More detailed instructions on navigating with the cd command can be found here\n * NOTE: Your database of Arweave Transaction Headers will be created in the project directory, not Docker. So, if you are using an external hard drive to turn an old machine into a node, install the node directly to that external drive.\n * Run the following command:\n \n git clone -b main https://github.com/ar-io/ar-io-node\n \n\n\n# Create the Environment File\n\n 1. Create an environmental variables file:\n \n * Open a text editor (e.g., Notepad):\n \n * Press Windows Key and search for "Notepad".\n * Click on "Notepad" to open the text editor.\n \n * Paste the following content into the new file, replacing with the domain address you are using to access the node, and with the public address of your Arweave wallet:\n \n GRAPHQL_HOST=arweave.net\n GRAPHQL_PORT=443\n START_HEIGHT=0\n RUN_OBSERVER=true\n ARNS_ROOT_HOST=\n AR_IO_WALLET=\n OBSERVER_WALLET=\n \n \n * The GRAPHQL values set the proxy for GQL queries to arweave.net, You may use any available gateway that supports GQL queries. If omitted, your node can support GQL queries on locally indexed transactions, but only L1 transactions are indexed by default.\n * START_HEIGHT is an optional line. It sets the block number where your node will start downloading and indexing transactions headers. Omitting this line will begin indexing at block 0.\n * RUN_OBSERVER turns on the Observer to generate Network Compliance Reports. This is required for full participation in the AR.IO Network. Set to false to run your gateway without Observer.\n * ARNS_ROOT_HOST sets the starting point for resolving ARNS names, which are accessed as a subdomain of a gateway. It should be set to the url you are pointing to your node, excluding any protocol prefix. For example, use node-ar.io and not https://node-ar.io. If you are using a subdomain to access your node and do not set this value, the node will not understand incoming requests.\n * AR_IO_WALLET is optional, and sets the wallet you want associated with your Gateway. An associated wallet is required to join the AR.IO network.\n * OBSERVER_WALLET is the public address of the wallet used to sign Observer transactions. This is required for Observer to run, but may be omitted if you are running a gateway outside of the AR.IO network and do not plan to run Observer. You will need to supply the keyfile to this wallet in the next step.\n \n Advanced configuration options can be found at docs.ar.io\n \n * Save the file with the name ".env" and make sure to select "All Files" as the file type. This helps to ensure the file saves as ".env" and not ".env.txt"\n \n Note: The .env file should be saved inside the same directory where you cloned the repository (e.g., ar-io-node).\n\n\n# Supply Your Observer Wallet Keyfile:\n\nIf you are running Observer, you need to provide a wallet keyfile in order to sign report upload transactions. The keyfile must be saved in the wallets directory in the root of the repository. Name the file .json, replacing "" with the public address of the wallet. This should match your OBSERVER_WALLET environmental variable.\n\nLearn more about creating Arweave wallets and obtaining keyfiles here\n\n\n# Start the Docker Containers\n\n 1. Start the Docker container:\n \n * Open the command prompt:\n \n * Press Windows Key + R.\n * Type cmd and press Enter.\n \n * Navigate to the directory where you cloned the repository (e.g., ar-io-node):\n \n * Use the cd command to change directories. For example, if the repository is located in the Documents directory, you would enter:\n \n cd Documents\\ar-io-node\n \n \n * If the directory path contains spaces, enclose it in double quotation marks. For example:\n \n cd "C:\\My Documents\\ar-io-node"\n \n \n * Use the dir command to list the contents of the current directory and verify that you\'re in the correct location:\n \n dir\n \n \n * Once you are in the correct directory, run the following command to start the Docker container:\n \n docker compose up -d\n \n \n * Explanation of flags:\n \n * up: Start the Docker containers.\n * -d: Run the containers as background processes (detached mode).\n \n NOTE: Effective with Release #3, it is no longer required to include the --build flag when starting your gateway. Docker will automatically build using the image specified in the docker-commpose.yaml file.\n \n The gateway can be shut down using the command:\n \n docker compose down\n \n \n * If prompted by the firewall, allow access for Docker when requested.\n\n\n# Set Up Router Port Forwarding\n\nTo expose your node to the internet and use a custom domain, follow these steps:\n\n 1. Obtain a Domain Name:\n \n * Choose a domain registrar (e.g., Namecheap) and purchase a domain name.\n\n 2. Point the Domain at Your Home Network:\n \n * In your browser, go to https://www.whatsmyip.org/ to display your public ip address. It can be found at the top of the screen. Note this number down.\n * Access your domain registrar\'s settings (e.g., Namecheap\'s cPanel).\n * Navigate to the DNS settings for your domain. In cPanel this is under the "Zone Editor" tab.\n * Create an A record with your registrar for your domain and wildcard subdomains, using your public IP address. For example, if your domain is "ar.io," create a record for "ar.io" and "*.ar.io."\n * Instructions may vary depending on the domain registrar and cPanel. Consult your registrar\'s documentation or support for detailed steps.\n\n 3. Obtain the Local IP Address of Your Machine:\n \n * Open the command prompt:\n * Press Windows Key + R.\n * Type cmd and press Enter.\n * Run the following command:\n \n ipconfig\n \n \n * Look for the network adapter that is currently connected to your network (e.g., Ethernet or Wi-Fi).\n * Note down the IPv4 Address associated with the network adapter. It should be in the format of 192.168.X.X or 10.X.X.X.\n * This IP address will be used for port forwarding.\n\n 4. Set Up Router Port Forwarding:\n \n * Access your home router settings:\n * Open a web browser.\n * Enter your router\'s IP address in the address bar (e.g., 192.168.0.1).\n * If you\'re unsure of your router\'s IP address, consult your router\'s documentation or contact your Internet Service Provider (ISP).\n * Navigate to the port forwarding settings in your router configuration.\n * The exact steps may vary depending on your router model. Consult your router\'s documentation or support for detailed steps.\n * Set up port forwarding rules to forward incoming traffic on ports 80 and 443 to the local IP address of your machine where the node is installed.\n * Configure the ports to point to the local IP address noted in the previous step.\n * Save the settings.\n\n\n# Install and Configure NGINX Docker\n\n 1. Clone the NGINX Docker repository:\n \n * Open the command prompt:\n * Press Windows Key + R.\n * Type cmd and press Enter.\n * Navigate to the directory where you want to clone the repository (This should not be done inside the directory for the node):\n * Use the cd command to change directories. For example, to navigate to the Documents directory:\n \n cd Documents\n \n \n * Run the following command:\n \n git clone -b main https://github.com/bobinstein/dockerized-nginx\n \n \n Note: This NGINX container was designed to easily automate many of the more technical aspects of setting up NGNIX and obtaining an ssl certificate so your node can be accessed with https. However, wildcard domain certifications cannot be universally automated due to significant security concerns. Be sure to follow the instructions in this project for obtaining wildcard domain certificates in order for your node to function properly.\n\n 2. Follow the instructions provided in the repository for setting up NGINX Docker.\n\nCongratulations! Your AR.IO node is now running and connected to the internet. Test it by entering https:///3lyxgbgEvqNSvJrTX2J7CfRychUD5KClFhhVLyTPNCQ in your browser.\n\nNote: If you encounter any issues during the installation process, please seek assistance from the AR.IO community.',normalizedContent:'# windows installation instructions\n\n\n# overview\n\nthis guide provides step-by-step instructions for setting up the ar.io node on a windows computer. it covers installing necessary software, cloning the repository, creating an environment file, starting the docker container, setting up networking, and installing and configuring nginx docker. no prior coding experience is required.\n\n\n# prerequisites\n\nbefore starting the installation process, ensure you have the following:\n\n * a windows computer\n * administrative privileges on the computer\n\n\n# install required packages\n\n 1. install docker:\n \n * download docker desktop for windows from here.\n * run the installer and follow the prompts.\n * during installation, make sure to select the option to use wsl (windows subsystem for linux) rather than hyper-v.\n * restart your pc.\n * update windows subsystem for linux (wsl):\n * open the command prompt as an administrator:\n * press windows key + r.\n * type cmd and press enter.\n * right-click on the "command prompt" application in the search results.\n * select "run as administrator" from the context menu.\n * run the following commands:\n \n wsl --update\n wsl --shutdown\n \n \n * restart docker desktop.\n\n 2. install git:\n \n * download git for windows from here.\n * run the installer and use the default settings.\n\n\n# clone the repository\n\n 1. clone the main repository:\n * open the command prompt:\n * press windows key + r.\n * type cmd and press enter.\n * navigate to the directory where you want to clone the repository:\n * use the cd command to change directories. for example, to navigate to the documents directory:\n \n cd documents\n \n \n * more detailed instructions on navigating with the cd command can be found here\n * note: your database of arweave transaction headers will be created in the project directory, not docker. so, if you are using an external hard drive to turn an old machine into a node, install the node directly to that external drive.\n * run the following command:\n \n git clone -b main https://github.com/ar-io/ar-io-node\n \n\n\n# create the environment file\n\n 1. create an environmental variables file:\n \n * open a text editor (e.g., notepad):\n \n * press windows key and search for "notepad".\n * click on "notepad" to open the text editor.\n \n * paste the following content into the new file, replacing with the domain address you are using to access the node, and with the public address of your arweave wallet:\n \n graphql_host=arweave.net\n graphql_port=443\n start_height=0\n run_observer=true\n arns_root_host=\n ar_io_wallet=\n observer_wallet=\n \n \n * the graphql values set the proxy for gql queries to arweave.net, you may use any available gateway that supports gql queries. if omitted, your node can support gql queries on locally indexed transactions, but only l1 transactions are indexed by default.\n * start_height is an optional line. it sets the block number where your node will start downloading and indexing transactions headers. omitting this line will begin indexing at block 0.\n * run_observer turns on the observer to generate network compliance reports. this is required for full participation in the ar.io network. set to false to run your gateway without observer.\n * arns_root_host sets the starting point for resolving arns names, which are accessed as a subdomain of a gateway. it should be set to the url you are pointing to your node, excluding any protocol prefix. for example, use node-ar.io and not https://node-ar.io. if you are using a subdomain to access your node and do not set this value, the node will not understand incoming requests.\n * ar_io_wallet is optional, and sets the wallet you want associated with your gateway. an associated wallet is required to join the ar.io network.\n * observer_wallet is the public address of the wallet used to sign observer transactions. this is required for observer to run, but may be omitted if you are running a gateway outside of the ar.io network and do not plan to run observer. you will need to supply the keyfile to this wallet in the next step.\n \n advanced configuration options can be found at docs.ar.io\n \n * save the file with the name ".env" and make sure to select "all files" as the file type. this helps to ensure the file saves as ".env" and not ".env.txt"\n \n note: the .env file should be saved inside the same directory where you cloned the repository (e.g., ar-io-node).\n\n\n# supply your observer wallet keyfile:\n\nif you are running observer, you need to provide a wallet keyfile in order to sign report upload transactions. the keyfile must be saved in the wallets directory in the root of the repository. name the file .json, replacing "" with the public address of the wallet. this should match your observer_wallet environmental variable.\n\nlearn more about creating arweave wallets and obtaining keyfiles here\n\n\n# start the docker containers\n\n 1. start the docker container:\n \n * open the command prompt:\n \n * press windows key + r.\n * type cmd and press enter.\n \n * navigate to the directory where you cloned the repository (e.g., ar-io-node):\n \n * use the cd command to change directories. for example, if the repository is located in the documents directory, you would enter:\n \n cd documents\\ar-io-node\n \n \n * if the directory path contains spaces, enclose it in double quotation marks. for example:\n \n cd "c:\\my documents\\ar-io-node"\n \n \n * use the dir command to list the contents of the current directory and verify that you\'re in the correct location:\n \n dir\n \n \n * once you are in the correct directory, run the following command to start the docker container:\n \n docker compose up -d\n \n \n * explanation of flags:\n \n * up: start the docker containers.\n * -d: run the containers as background processes (detached mode).\n \n note: effective with release #3, it is no longer required to include the --build flag when starting your gateway. docker will automatically build using the image specified in the docker-commpose.yaml file.\n \n the gateway can be shut down using the command:\n \n docker compose down\n \n \n * if prompted by the firewall, allow access for docker when requested.\n\n\n# set up router port forwarding\n\nto expose your node to the internet and use a custom domain, follow these steps:\n\n 1. obtain a domain name:\n \n * choose a domain registrar (e.g., namecheap) and purchase a domain name.\n\n 2. point the domain at your home network:\n \n * in your browser, go to https://www.whatsmyip.org/ to display your public ip address. it can be found at the top of the screen. note this number down.\n * access your domain registrar\'s settings (e.g., namecheap\'s cpanel).\n * navigate to the dns settings for your domain. in cpanel this is under the "zone editor" tab.\n * create an a record with your registrar for your domain and wildcard subdomains, using your public ip address. for example, if your domain is "ar.io," create a record for "ar.io" and "*.ar.io."\n * instructions may vary depending on the domain registrar and cpanel. consult your registrar\'s documentation or support for detailed steps.\n\n 3. obtain the local ip address of your machine:\n \n * open the command prompt:\n * press windows key + r.\n * type cmd and press enter.\n * run the following command:\n \n ipconfig\n \n \n * look for the network adapter that is currently connected to your network (e.g., ethernet or wi-fi).\n * note down the ipv4 address associated with the network adapter. it should be in the format of 192.168.x.x or 10.x.x.x.\n * this ip address will be used for port forwarding.\n\n 4. set up router port forwarding:\n \n * access your home router settings:\n * open a web browser.\n * enter your router\'s ip address in the address bar (e.g., 192.168.0.1).\n * if you\'re unsure of your router\'s ip address, consult your router\'s documentation or contact your internet service provider (isp).\n * navigate to the port forwarding settings in your router configuration.\n * the exact steps may vary depending on your router model. consult your router\'s documentation or support for detailed steps.\n * set up port forwarding rules to forward incoming traffic on ports 80 and 443 to the local ip address of your machine where the node is installed.\n * configure the ports to point to the local ip address noted in the previous step.\n * save the settings.\n\n\n# install and configure nginx docker\n\n 1. clone the nginx docker repository:\n \n * open the command prompt:\n * press windows key + r.\n * type cmd and press enter.\n * navigate to the directory where you want to clone the repository (this should not be done inside the directory for the node):\n * use the cd command to change directories. for example, to navigate to the documents directory:\n \n cd documents\n \n \n * run the following command:\n \n git clone -b main https://github.com/bobinstein/dockerized-nginx\n \n \n note: this nginx container was designed to easily automate many of the more technical aspects of setting up ngnix and obtaining an ssl certificate so your node can be accessed with https. however, wildcard domain certifications cannot be universally automated due to significant security concerns. be sure to follow the instructions in this project for obtaining wildcard domain certificates in order for your node to function properly.\n\n 2. follow the instructions provided in the repository for setting up nginx docker.\n\ncongratulations! your ar.io node is now running and connected to the internet. test it by entering https:///3lyxgbgevqnsvjrtx2j7cfrychud5kclfhhvlytpncq in your browser.\n\nnote: if you encounter any issues during the installation process, please seek assistance from the ar.io community.',charsets:{}},{title:"Managing ArNS Assets",frontmatter:{next:!1},regularPath:"/guides/arns/managing.html",relativePath:"guides/arns/managing.md",key:"v-657f8880",path:"/guides/arns/managing.html",headers:[{level:2,title:"Overview",slug:"overview",normalizedTitle:"overview",charIndex:27},{level:2,title:"Names",slug:"names",normalizedTitle:"names",charIndex:552},{level:2,title:"ANTs",slug:"ants",normalizedTitle:"ants",charIndex:839}],headersStr:"Overview Names ANTs",content:'# Managing ArNS Assets\n\n\n# Overview\n\nFrom the Manage Assets page of arns.app, you can view details about your registered names, assign new Target IDs for your names to resolve to, or register new undernames for your ArNS names.\n\nAccess the Manage Assets page by connecting your Arweave wallet, and clicking on the account button displaying your wallet address (the connect button if you are not connected), then selecting "Manage Assets" from the menu.\n\nYour browser does not support the video tag.\n\nThe Manage Assets page features two important tabs. Names and ANTS.\n\n\n# Names\n\nThe Names tab displays all of the ArNS names registered to the currently connected wallet. Each name has its own "details" button which allows you to view details about the name, extend the lease period, or increase the available undernames for that name.\n\n\n# ANTs\n\nThe ANTs tab displays each ANT owned by the connected wallet (except for advanced use cases, each ArNS name will have its own ANT). You can view and create new undernames using the "Undernames" button, or access advanced management options by clicking on the "manage" icon (shaped like a gear).\n\nThe Advanced manage page allows you to transfer ownership, add or remove controllers (other wallets who are able to manage an ANT) or set/modify a Target ID for a name to resolve to.',normalizedContent:'# managing arns assets\n\n\n# overview\n\nfrom the manage assets page of arns.app, you can view details about your registered names, assign new target ids for your names to resolve to, or register new undernames for your arns names.\n\naccess the manage assets page by connecting your arweave wallet, and clicking on the account button displaying your wallet address (the connect button if you are not connected), then selecting "manage assets" from the menu.\n\nyour browser does not support the video tag.\n\nthe manage assets page features two important tabs. names and ants.\n\n\n# names\n\nthe names tab displays all of the arns names registered to the currently connected wallet. each name has its own "details" button which allows you to view details about the name, extend the lease period, or increase the available undernames for that name.\n\n\n# ants\n\nthe ants tab displays each ant owned by the connected wallet (except for advanced use cases, each arns name will have its own ant). you can view and create new undernames using the "undernames" button, or access advanced management options by clicking on the "manage" icon (shaped like a gear).\n\nthe advanced manage page allows you to transfer ownership, add or remove controllers (other wallets who are able to manage an ant) or set/modify a target id for a name to resolve to.',charsets:{}},{title:"Gateway Architecture",frontmatter:{permalink:"/gateways/"},regularPath:"/gateways/gateways.html",relativePath:"gateways/gateways.md",key:"v-d8e9780c",path:"/gateways/",headers:[{level:2,title:"Overview",slug:"overview",normalizedTitle:"overview",charIndex:27},{level:2,title:"AR.IO Gateway Benefits",slug:"ar-io-gateway-benefits",normalizedTitle:"ar.io gateway benefits",charIndex:1793},{level:2,title:"Gateway Modularity",slug:"gateway-modularity",normalizedTitle:"gateway modularity",charIndex:2572},{level:2,title:"ARNS Indexing and Routing",slug:"arns-indexing-and-routing",normalizedTitle:"arns indexing and routing",charIndex:3764},{level:2,title:"Content Moderation",slug:"content-moderation",normalizedTitle:"content moderation",charIndex:4462}],headersStr:"Overview AR.IO Gateway Benefits Gateway Modularity ARNS Indexing and Routing Content Moderation",content:"# Gateway Architecture\n\n\n# Overview\n\nA gateway’s primary role in the Arweave ecosystem is to act as a bridge between the Arweave network and the outside world. This means that a gateway's main task is to make it easier for users to interact with the Arweave network by simplifying the technical processes of writing, reading, and discovering data on the blockweave in a trust-minimized fashion.\n\nThe core functions of a general Arweave gateway are broken down into the following areas.\n\nWriting data involves:\n\n * Proxying Layer 1 transaction headers to one or more healthy and active Arweave nodes (miners) to facilitate inclusion in the mempools of as many nodes as possible.\n\n * Proxying chunks for Layer 1 Arweave transactions to Arweave nodes to help facilitate storage and replication of the chunks on the blockweave.\n\n * Receiving and bundling so-called Layer 2 data items (e.g., ANS-104 spec) as Layer 1 transactions.\n\nReading involves retrieving:\n\n * Transaction headers for a Layer 1 Arweave transaction.\n\n * Individual data chunks for a Layer 1 Arweave transaction.\n\n * Blocks from the blockweave.\n\n * Storage pricing rates for data from the Arweave node network.\n\n * Contiguous streams of chunks representing an entire Layer 1 transaction.\n\n * Layer 2 bundled data items (e.g., ANS-104).\n\n * Wallet information (e.g., token balance).\n\nDiscovering data involves:\n\n * Facilitating efficient, structured queries for Layer 1 and Layer 2 transaction and wallet data by:\n \n * examining incoming streams of data (i.e., directly ingested transactions and data items, blocks emitted by the chain, etc.).\n \n * managing index data in a database or analogous data store.\n\n * Parsing and executing user queries.\n\n * Facilitating friendly-path routing via Arweave manifest indexing.\n\n\n# AR.IO Gateway Benefits\n\nAR.IO gateways provide many new benefits and capabilities beyond general Arweave gateways:\n\n * Providing the modularity and configurability necessary for operating extensible gateways that can be deployed at small or large scales to meet the needs of specific applications, use cases, communities, or business models.\n\n * Providing pluggable means for consuming telemetry data for internal and external monitoring and alerting.\n\n * Facilitating friendly-subdomain-name routing to Arweave transactions via a direct integration with the Arweave Name System (ArNS).\n\n * Facilitating configurable content moderation policies.\n\n * Providing connectivity to a decentralized network of other AR.IO gateways, enabling data sharing and other shared workloads.\n\n\n# Gateway Modularity\n\nA design principle of AR.IO gateways is that their core components should be interchangeable with compatible implementations.\n\nThe core services in the gateway are written in Typescript, with flexible interfaces to the various subsystems and databases. This allows operators to customize their gateway to meet their specific requirements. Gateway services can be turned on or off depending on the operator's needs. For example, an operator might choose to have their gateway serve data, but not actively index Layer 2 bundled data.\n\nThis flexibility also allows operators to utilize the technologies that are appropriate for the scale and environments in which they operate.\n\nFor example, small scale operators might want to use low-overhead relational databases to power their indexing while larger scale operators might opt to use cloud-native, horizontally scalable databases. Analogous examples for storage and caching exist as well.\n\nGATEWAY TECH STACK OPTIONS\nTOPOLOGY CHAIN INDEX BUNDLE INDEX DATA INDEX DATA STORE\nSmall SQLite SQLite SQLite Local File System\nLarge PostgreSQL Cassandra Cassandra S3 Compatible\n\n\n# ARNS Indexing and Routing\n\nThe Arweave Name System’s (ArNS) state is managed by the IO token’s smart contract. AR.IO gateways shall perform the following minimum functions relative to ArNS:\n\n * Actively track state changes in the contract.\n\n * Maintain up-to-date indexes for routing configurations based on the state of the IO contract as well as the states of the Arweave Name Token (ANT) contracts to which each name is affiliated.\n\n * Manage the expiration of stale records.\n\n * Facilitate ArNS routing based on the subdomains specified on incoming requests where appropriate.\n\n * Provide a custom HTTP response header for ArNS requests indicating the corresponding Arweave transaction ID.\n\n\n# Content Moderation\n\nThe AR.IO Network will adopt Arweave’s voluntary content moderation model whereby every participant of the network has the autonomy to decide which content they want to (or can legally) store, serve, and see. Each gateway operating on the network has the right and ability to blocklist any content (or address) that is deemed in violation of its content policies or non-compliant with local regulations.",normalizedContent:"# gateway architecture\n\n\n# overview\n\na gateway’s primary role in the arweave ecosystem is to act as a bridge between the arweave network and the outside world. this means that a gateway's main task is to make it easier for users to interact with the arweave network by simplifying the technical processes of writing, reading, and discovering data on the blockweave in a trust-minimized fashion.\n\nthe core functions of a general arweave gateway are broken down into the following areas.\n\nwriting data involves:\n\n * proxying layer 1 transaction headers to one or more healthy and active arweave nodes (miners) to facilitate inclusion in the mempools of as many nodes as possible.\n\n * proxying chunks for layer 1 arweave transactions to arweave nodes to help facilitate storage and replication of the chunks on the blockweave.\n\n * receiving and bundling so-called layer 2 data items (e.g., ans-104 spec) as layer 1 transactions.\n\nreading involves retrieving:\n\n * transaction headers for a layer 1 arweave transaction.\n\n * individual data chunks for a layer 1 arweave transaction.\n\n * blocks from the blockweave.\n\n * storage pricing rates for data from the arweave node network.\n\n * contiguous streams of chunks representing an entire layer 1 transaction.\n\n * layer 2 bundled data items (e.g., ans-104).\n\n * wallet information (e.g., token balance).\n\ndiscovering data involves:\n\n * facilitating efficient, structured queries for layer 1 and layer 2 transaction and wallet data by:\n \n * examining incoming streams of data (i.e., directly ingested transactions and data items, blocks emitted by the chain, etc.).\n \n * managing index data in a database or analogous data store.\n\n * parsing and executing user queries.\n\n * facilitating friendly-path routing via arweave manifest indexing.\n\n\n# ar.io gateway benefits\n\nar.io gateways provide many new benefits and capabilities beyond general arweave gateways:\n\n * providing the modularity and configurability necessary for operating extensible gateways that can be deployed at small or large scales to meet the needs of specific applications, use cases, communities, or business models.\n\n * providing pluggable means for consuming telemetry data for internal and external monitoring and alerting.\n\n * facilitating friendly-subdomain-name routing to arweave transactions via a direct integration with the arweave name system (arns).\n\n * facilitating configurable content moderation policies.\n\n * providing connectivity to a decentralized network of other ar.io gateways, enabling data sharing and other shared workloads.\n\n\n# gateway modularity\n\na design principle of ar.io gateways is that their core components should be interchangeable with compatible implementations.\n\nthe core services in the gateway are written in typescript, with flexible interfaces to the various subsystems and databases. this allows operators to customize their gateway to meet their specific requirements. gateway services can be turned on or off depending on the operator's needs. for example, an operator might choose to have their gateway serve data, but not actively index layer 2 bundled data.\n\nthis flexibility also allows operators to utilize the technologies that are appropriate for the scale and environments in which they operate.\n\nfor example, small scale operators might want to use low-overhead relational databases to power their indexing while larger scale operators might opt to use cloud-native, horizontally scalable databases. analogous examples for storage and caching exist as well.\n\ngateway tech stack options\ntopology chain index bundle index data index data store\nsmall sqlite sqlite sqlite local file system\nlarge postgresql cassandra cassandra s3 compatible\n\n\n# arns indexing and routing\n\nthe arweave name system’s (arns) state is managed by the io token’s smart contract. ar.io gateways shall perform the following minimum functions relative to arns:\n\n * actively track state changes in the contract.\n\n * maintain up-to-date indexes for routing configurations based on the state of the io contract as well as the states of the arweave name token (ant) contracts to which each name is affiliated.\n\n * manage the expiration of stale records.\n\n * facilitate arns routing based on the subdomains specified on incoming requests where appropriate.\n\n * provide a custom http response header for arns requests indicating the corresponding arweave transaction id.\n\n\n# content moderation\n\nthe ar.io network will adopt arweave’s voluntary content moderation model whereby every participant of the network has the autonomy to decide which content they want to (or can legally) store, serve, and see. each gateway operating on the network has the right and ability to blocklist any content (or address) that is deemed in violation of its content policies or non-compliant with local regulations.",charsets:{}},{title:"Glossary",frontmatter:{prev:!1,next:!1},regularPath:"/glossary.html",relativePath:"glossary.md",key:"v-37cd1c0a",path:"/glossary.html",headers:[{level:2,title:"aoComputer (AO):",slug:"aocomputer-ao",normalizedTitle:"aocomputer (ao):",charIndex:208},{level:2,title:"Arweave Name System (ArNS):",slug:"arweave-name-system-arns",normalizedTitle:"arweave name system (arns):",charIndex:898},{level:2,title:"Arweave Name Token (ANT), “Name Token”:",slug:"arweave-name-token-ant-name-token",normalizedTitle:"arweave name token (ant), “name token”:",charIndex:1085},{level:2,title:"Arweave Network Standards (ANS):",slug:"arweave-network-standards-ans",normalizedTitle:"arweave network standards (ans):",charIndex:1374},{level:2,title:"Base Layer Transaction:",slug:"base-layer-transaction",normalizedTitle:"base layer transaction:",charIndex:1640},{level:2,title:"Bundle, bundling:",slug:"bundle-bundling",normalizedTitle:"bundle, bundling:",charIndex:1805},{level:2,title:"Bundled Data Item (BDI):",slug:"bundled-data-item-bdi",normalizedTitle:"bundled data item (bdi):",charIndex:2420},{level:2,title:"Bundler:",slug:"bundler",normalizedTitle:"bundler:",charIndex:2522},{level:2,title:"Chunk:",slug:"chunk",normalizedTitle:"chunk:",charIndex:2622},{level:2,title:"Decentralized, decentralization, etc:",slug:"decentralized-decentralization-etc",normalizedTitle:"decentralized, decentralization, etc:",charIndex:2829},{level:2,title:"Epoch:",slug:"epoch",normalizedTitle:"epoch:",charIndex:3151},{level:2,title:"Gateway:",slug:"gateway",normalizedTitle:"gateway:",charIndex:3423},{level:2,title:"Gateway Address Registry (GAR):",slug:"gateway-address-registry-gar",normalizedTitle:"gateway address registry (gar):",charIndex:3619},{level:2,title:"Indexing:",slug:"indexing",normalizedTitle:"indexing:",charIndex:4140},{level:2,title:"Layer 2 Infrastructure:",slug:"layer-2-infrastructure",normalizedTitle:"layer 2 infrastructure:",charIndex:4225},{level:2,title:"Manifest (aka Path Manifest, Arweave Manifest):",slug:"manifest-aka-path-manifest-arweave-manifest",normalizedTitle:"manifest (aka path manifest, arweave manifest):",charIndex:4442},{level:2,title:"Mempool:",slug:"mempool",normalizedTitle:"mempool:",charIndex:5060},{level:2,title:"Miner (aka Arweave Node):",slug:"miner-aka-arweave-node",normalizedTitle:"miner (aka arweave node):",charIndex:5263},{level:2,title:"Native Address:",slug:"native-address",normalizedTitle:"native address:",charIndex:5375},{level:2,title:"Normalized Address:",slug:"normalized-address",normalizedTitle:"normalized address:",charIndex:5639},{level:2,title:"Observer:",slug:"observer",normalizedTitle:"observer:",charIndex:5809},{level:2,title:"Optimistic Indexing:",slug:"optimistic-indexing",normalizedTitle:"optimistic indexing:",charIndex:5988},{level:2,title:"Owner:",slug:"owner",normalizedTitle:"owner:",charIndex:6143},{level:2,title:"Owner Address:",slug:"owner-address",normalizedTitle:"owner address:",charIndex:6196},{level:2,title:"Period:",slug:"period",normalizedTitle:"period:",charIndex:6252},{level:2,title:"Permaweb:",slug:"permaweb",normalizedTitle:"permaweb:",charIndex:6481},{level:2,title:"Protocol Balance:",slug:"protocol-balance",normalizedTitle:"protocol balance:",charIndex:6599},{level:2,title:"Protocol Rewards:",slug:"protocol-rewards",normalizedTitle:"protocol rewards:",charIndex:6889},{level:2,title:"Public Key:",slug:"public-key",normalizedTitle:"public key:",charIndex:7022},{level:2,title:"Seeding:",slug:"seeding",normalizedTitle:"seeding:",charIndex:7207},{level:2,title:"Staking (of tokens):",slug:"staking-of-tokens",normalizedTitle:"staking (of tokens):",charIndex:7517},{level:2,title:"Transaction ID (txID):",slug:"transaction-id-txid",normalizedTitle:"transaction id (txid):",charIndex:7824},{level:2,title:"Trust-minimization:",slug:"trust-minimization",normalizedTitle:"trust-minimization:",charIndex:8047},{level:2,title:"Vault:",slug:"vault",normalizedTitle:"vault:",charIndex:8424}],headersStr:"aoComputer (AO): Arweave Name System (ArNS): Arweave Name Token (ANT), “Name Token”: Arweave Network Standards (ANS): Base Layer Transaction: Bundle, bundling: Bundled Data Item (BDI): Bundler: Chunk: Decentralized, decentralization, etc: Epoch: Gateway: Gateway Address Registry (GAR): Indexing: Layer 2 Infrastructure: Manifest (aka Path Manifest, Arweave Manifest): Mempool: Miner (aka Arweave Node): Native Address: Normalized Address: Observer: Optimistic Indexing: Owner: Owner Address: Period: Permaweb: Protocol Balance: Protocol Rewards: Public Key: Seeding: Staking (of tokens): Transaction ID (txID): Trust-minimization: Vault:",content:"# Glossary\n\nMany novel terms and acronyms are used by the Arweave ecosystem as well as some new ones introduced by AR.IO. The list below is intended to serve as a non-exhaustive reference of those terms:\n\n\n# aoComputer (AO):\n\nThe aoComputer is the actor oriented machine that emerges from the network of nodes that adhere to its core data protocol, running on the Arweave network. It is a single, unified computing environment, hosted on a heterogenous set of nodes in a distributed network. AO is designed to offer an environment in which an arbitrary number of parallel processes can be resident, coordinating through an open message passing layer. This message passing standard connects the machine's independently operating processes together into a 'web' -- in the same way that websites operate on independent servers but are conjoined into a cohesive, unified experience via hyperlinks.\n\n\n# Arweave Name System (ArNS):\n\nA decentralized and censorship-resistant naming system enabled by AR.IO gateways which connects friendly names to permaweb applications, pages, and data.\n\n\n# Arweave Name Token (ANT), “Name Token”:\n\nAn aoComputer based token, that is connected to each registered ArNS Name. Each ANT gives the owner the ability to update the subdomains and Arweave transaction IDs used by the registered name as well as transfer ownership and other functions.\n\n\n# Arweave Network Standards (ANS):\n\nDrafts and finalized standards for data formats, tag formats, data protocols, custom gateway features and anything that is built on top the Arweave Network. Specific standards are denoted by an associated number, e.g., ANS-###.\n\n\n# Base Layer Transaction:\n\nRefers to one of up to 1,000 transactions that make up a single Arweave block. A base layer transaction may contain bundled data items.\n\n\n# Bundle, bundling:\n\nAn Arweave concept introduced in ANS-104 that allows for a way of writing multiple independent data transactions into one base layer transaction. Bundled transactions contain multiple independent transactions, called data items, wrapped into one larger transaction. This offers two major network benefits:\n\n * A scaling solution for increasing the throughput of uploads to the Arweave network,\n\n * Allows delegation of payment for an upload to a third party, while maintaining the identity and signature of the person who created the upload, without them needing to have a wallet with funds.\n\n\n# Bundled Data Item (BDI):\n\nA data item / transaction nested within an ANS-104 bundled transaction.\n\n\n# Bundler:\n\nA third-party service and gateway feature that bundles data files on a user’s behalf.\n\n\n# Chunk:\n\nA chunk is a unit of data that is stored on the Arweave network. It represents a piece of a larger file that has been split into smaller, manageable segments for efficient storage and retrieval.\n\n\n# Decentralized, decentralization, etc:\n\nA nonbinary, many axis scale enabling a system or platform to be: permissionless, trustless, verifiable, transparent, open-source, composable, resilient, and censorship resistant. Ultimately, something that is decentralized is not prone to single points of failure or influence.\n\n\n# Epoch:\n\nA specific duration (e.g., one block-week) during which network activities and evaluations are conducted. It serves as a key time frame for processes such as observation duties, performance assessments, and reward distributions within the network's protocols.\n\n\n# Gateway:\n\nA node operating on the Arweave network that provides services for reading from, writing to, and indexing the data stored on the permaweb. Sometimes referred to as “permaweb nodes”.\n\n\n# Gateway Address Registry (GAR):\n\nA decentralized directory maintained in the AR.IO smart contract. It serves as the authoritative list of all registered gateways on the AR.IO Network. The registry provides detailed metadata about each gateway to facilitate discovery, health monitoring, and data sharing among permaweb apps and users. The GAR is designed to be easily queryable, sortable, and filterable by end users and clients, allowing for tailored selections based on various criteria to meet specific use cases.\n\n\n# Indexing:\n\nThe act of organizing transaction data tags into queryable databases.\n\n\n# Layer 2 Infrastructure:\n\nLayer 2 refers to the technology / infrastructure stack built “above” a base layer. In this use, the AR.IO Network would be considered Layer 2 infrastructure to the base Arweave protocol.\n\n\n# Manifest (aka Path Manifest, Arweave Manifest):\n\nSpecial “aggregate” files uploaded to Arweave that map user-definable sub-paths with other Arweave transaction IDs. This allows users to create logical groups of content, for example a directory of related files, or the files and assets that make up a web page or application. Instead of having to manually collate these assets, manifests group them together so that an entire website or app can be launched from a single manifest file. Gateways can interpret this structure, so that users can then reference individual transactions by their file name and/or path.\n\n\n# Mempool:\n\nShort for \"memory pool,\" is a component of Arweave mining nodes that temporarily stores valid transactions that have been broadcasted to the network but have not yet been added to a block.\n\n\n# Miner (aka Arweave Node):\n\nA node operating on the Arweave network responsible for data storage and recall.\n\n\n# Native Address:\n\nThe way public addresses are commonly (or by spec) represented in their native blockchain. Arweave keys are 43 character base64url representations of the public key, while Ethereum keys use a different hashing algorithm and start with 0x etc.\n\n\n# Normalized Address:\n\n43 character base64url representation of the sha256 hash of a public key. Public keys for other chains can be normalized by this representation.\n\n\n# Observer:\n\nA gateway selected to evaluate the performance of peer gateways in resolving ArNS names. Observers assess and report on the operational efficacy of other gateways.\n\n\n# Optimistic Indexing:\n\nIndexing transaction or data item headers before the associated L1 transaction has been accepted and confirmed in a chain block.\n\n\n# Owner:\n\nGenerally, the public key of the signer.\n\n\n# Owner Address:\n\nThe normalized address of the owner\n\n\n# Period:\n\nRefers to a predefined time span (e.g., a block-day) that serves as a cycle for network activities such as dynamic pricing. It is a fundamental unit of time for operational and protocol processes within the network.\n\n\n# Permaweb:\n\nThe permaweb is the permanent and decentralized web of files and applications built on top of Arweave.\n\n\n# Protocol Balance:\n\nThe primary sink and source of IO tokens circulating through the AR.IO Network. This balance is akin to a central vault or wallet programmatically encoded into the network’s smart contract from which ArNS revenue is accumulated and incentive rewards are distributed.\n\n\n# Protocol Rewards:\n\nIO Token incentive rewards distributed by the protocol to the network’s eligible users and gateway operators.\n\n\n# Public Key:\n\nThe publicly known keys for a signer (wallet). Public keys are different byte lengths depending on the signer type (e.g. Arweave vs. Ethereum (ECDSA), vs Solana, etc.)\n\n\n# Seeding:\n\nRefers to the act of propagating new data throughout the network. Miner nodes seed Arweave base layer transaction data to other miners, while gateways ensure that the transactions they receive reach the Arweave nodes. Both gateways and Arweave nodes seed base layer transactions and data chunks.\n\n\n# Staking (of tokens):\n\nRefers to the process of locking IO tokens into a protocol-facilitated vault, temporarily removing them from circulation until unlocked. This action represents an opportunity cost for the gateway operator and serves as a motivator to prioritize the network's collective interests.\n\n\n# Transaction ID (txID):\n\nEvery transaction and data file uploaded to Arweave is assigned a unique identifier code known as the Transaction ID. These txID’s can be referenced by users to easily locate and retrieve files.\n\n\n# Trust-minimization:\n\nRelates to enacting network security by minimizing the number of entities and the degree to which they must be trusted to achieve reliable network interactions. A network with trust-minimizing mechanisms means that it has reduced exposure to undesirable third-party actions and built-in incentives to reward good behavior while punishing bad behavior.\n\n\n# Vault:\n\nToken vaults are protocol level mechanisms used to contain staked tokens over time. Each vault contains a starting block height, ending block height (if applicable), along with a balance of tokens.",normalizedContent:"# glossary\n\nmany novel terms and acronyms are used by the arweave ecosystem as well as some new ones introduced by ar.io. the list below is intended to serve as a non-exhaustive reference of those terms:\n\n\n# aocomputer (ao):\n\nthe aocomputer is the actor oriented machine that emerges from the network of nodes that adhere to its core data protocol, running on the arweave network. it is a single, unified computing environment, hosted on a heterogenous set of nodes in a distributed network. ao is designed to offer an environment in which an arbitrary number of parallel processes can be resident, coordinating through an open message passing layer. this message passing standard connects the machine's independently operating processes together into a 'web' -- in the same way that websites operate on independent servers but are conjoined into a cohesive, unified experience via hyperlinks.\n\n\n# arweave name system (arns):\n\na decentralized and censorship-resistant naming system enabled by ar.io gateways which connects friendly names to permaweb applications, pages, and data.\n\n\n# arweave name token (ant), “name token”:\n\nan aocomputer based token, that is connected to each registered arns name. each ant gives the owner the ability to update the subdomains and arweave transaction ids used by the registered name as well as transfer ownership and other functions.\n\n\n# arweave network standards (ans):\n\ndrafts and finalized standards for data formats, tag formats, data protocols, custom gateway features and anything that is built on top the arweave network. specific standards are denoted by an associated number, e.g., ans-###.\n\n\n# base layer transaction:\n\nrefers to one of up to 1,000 transactions that make up a single arweave block. a base layer transaction may contain bundled data items.\n\n\n# bundle, bundling:\n\nan arweave concept introduced in ans-104 that allows for a way of writing multiple independent data transactions into one base layer transaction. bundled transactions contain multiple independent transactions, called data items, wrapped into one larger transaction. this offers two major network benefits:\n\n * a scaling solution for increasing the throughput of uploads to the arweave network,\n\n * allows delegation of payment for an upload to a third party, while maintaining the identity and signature of the person who created the upload, without them needing to have a wallet with funds.\n\n\n# bundled data item (bdi):\n\na data item / transaction nested within an ans-104 bundled transaction.\n\n\n# bundler:\n\na third-party service and gateway feature that bundles data files on a user’s behalf.\n\n\n# chunk:\n\na chunk is a unit of data that is stored on the arweave network. it represents a piece of a larger file that has been split into smaller, manageable segments for efficient storage and retrieval.\n\n\n# decentralized, decentralization, etc:\n\na nonbinary, many axis scale enabling a system or platform to be: permissionless, trustless, verifiable, transparent, open-source, composable, resilient, and censorship resistant. ultimately, something that is decentralized is not prone to single points of failure or influence.\n\n\n# epoch:\n\na specific duration (e.g., one block-week) during which network activities and evaluations are conducted. it serves as a key time frame for processes such as observation duties, performance assessments, and reward distributions within the network's protocols.\n\n\n# gateway:\n\na node operating on the arweave network that provides services for reading from, writing to, and indexing the data stored on the permaweb. sometimes referred to as “permaweb nodes”.\n\n\n# gateway address registry (gar):\n\na decentralized directory maintained in the ar.io smart contract. it serves as the authoritative list of all registered gateways on the ar.io network. the registry provides detailed metadata about each gateway to facilitate discovery, health monitoring, and data sharing among permaweb apps and users. the gar is designed to be easily queryable, sortable, and filterable by end users and clients, allowing for tailored selections based on various criteria to meet specific use cases.\n\n\n# indexing:\n\nthe act of organizing transaction data tags into queryable databases.\n\n\n# layer 2 infrastructure:\n\nlayer 2 refers to the technology / infrastructure stack built “above” a base layer. in this use, the ar.io network would be considered layer 2 infrastructure to the base arweave protocol.\n\n\n# manifest (aka path manifest, arweave manifest):\n\nspecial “aggregate” files uploaded to arweave that map user-definable sub-paths with other arweave transaction ids. this allows users to create logical groups of content, for example a directory of related files, or the files and assets that make up a web page or application. instead of having to manually collate these assets, manifests group them together so that an entire website or app can be launched from a single manifest file. gateways can interpret this structure, so that users can then reference individual transactions by their file name and/or path.\n\n\n# mempool:\n\nshort for \"memory pool,\" is a component of arweave mining nodes that temporarily stores valid transactions that have been broadcasted to the network but have not yet been added to a block.\n\n\n# miner (aka arweave node):\n\na node operating on the arweave network responsible for data storage and recall.\n\n\n# native address:\n\nthe way public addresses are commonly (or by spec) represented in their native blockchain. arweave keys are 43 character base64url representations of the public key, while ethereum keys use a different hashing algorithm and start with 0x etc.\n\n\n# normalized address:\n\n43 character base64url representation of the sha256 hash of a public key. public keys for other chains can be normalized by this representation.\n\n\n# observer:\n\na gateway selected to evaluate the performance of peer gateways in resolving arns names. observers assess and report on the operational efficacy of other gateways.\n\n\n# optimistic indexing:\n\nindexing transaction or data item headers before the associated l1 transaction has been accepted and confirmed in a chain block.\n\n\n# owner:\n\ngenerally, the public key of the signer.\n\n\n# owner address:\n\nthe normalized address of the owner\n\n\n# period:\n\nrefers to a predefined time span (e.g., a block-day) that serves as a cycle for network activities such as dynamic pricing. it is a fundamental unit of time for operational and protocol processes within the network.\n\n\n# permaweb:\n\nthe permaweb is the permanent and decentralized web of files and applications built on top of arweave.\n\n\n# protocol balance:\n\nthe primary sink and source of io tokens circulating through the ar.io network. this balance is akin to a central vault or wallet programmatically encoded into the network’s smart contract from which arns revenue is accumulated and incentive rewards are distributed.\n\n\n# protocol rewards:\n\nio token incentive rewards distributed by the protocol to the network’s eligible users and gateway operators.\n\n\n# public key:\n\nthe publicly known keys for a signer (wallet). public keys are different byte lengths depending on the signer type (e.g. arweave vs. ethereum (ecdsa), vs solana, etc.)\n\n\n# seeding:\n\nrefers to the act of propagating new data throughout the network. miner nodes seed arweave base layer transaction data to other miners, while gateways ensure that the transactions they receive reach the arweave nodes. both gateways and arweave nodes seed base layer transactions and data chunks.\n\n\n# staking (of tokens):\n\nrefers to the process of locking io tokens into a protocol-facilitated vault, temporarily removing them from circulation until unlocked. this action represents an opportunity cost for the gateway operator and serves as a motivator to prioritize the network's collective interests.\n\n\n# transaction id (txid):\n\nevery transaction and data file uploaded to arweave is assigned a unique identifier code known as the transaction id. these txid’s can be referenced by users to easily locate and retrieve files.\n\n\n# trust-minimization:\n\nrelates to enacting network security by minimizing the number of entities and the degree to which they must be trusted to achieve reliable network interactions. a network with trust-minimizing mechanisms means that it has reduced exposure to undesirable third-party actions and built-in incentives to reward good behavior while punishing bad behavior.\n\n\n# vault:\n\ntoken vaults are protocol level mechanisms used to contain staked tokens over time. each vault contains a starting block height, ending block height (if applicable), along with a balance of tokens.",charsets:{}},{title:"Arweave Name System (ArNS)",frontmatter:{prev:!1},regularPath:"/guides/arns/overview.html",relativePath:"guides/arns/overview.md",key:"v-bf3acddc",path:"/guides/arns/overview.html",headers:[{level:2,title:"Overview",slug:"overview",normalizedTitle:"overview",charIndex:33}],headersStr:"Overview",content:"# Arweave Name System (ArNS)\n\n\n# Overview\n\nThe Arweave Name System (ArNS) is a decentralized, censorship-resistant naming system on Arweave. It allows data on Arweave to be assigned to friendly domain names. Learn more about ArNS here.\n\nThis guide will walk you through the process of purchasing and managing an ArNS name using arns.app, the official ArNS portal from AR.IO.",normalizedContent:"# arweave name system (arns)\n\n\n# overview\n\nthe arweave name system (arns) is a decentralized, censorship-resistant naming system on arweave. it allows data on arweave to be assigned to friendly domain names. learn more about arns here.\n\nthis guide will walk you through the process of purchasing and managing an arns name using arns.app, the official arns portal from ar.io.",charsets:{}},{title:"Registering an ArNS name",frontmatter:{},regularPath:"/guides/arns/registering.html",relativePath:"guides/arns/registering.md",key:"v-401d6fcc",path:"/guides/arns/registering.html",headers:[{level:2,title:"Overview",slug:"overview",normalizedTitle:"overview",charIndex:31},{level:2,title:"Connect Your Wallet",slug:"connect-your-wallet",normalizedTitle:"connect your wallet",charIndex:466},{level:2,title:"Checking Availability",slug:"checking-availability",normalizedTitle:"checking availability",charIndex:763},{level:2,title:"Configure Your Purchase",slug:"configure-your-purchase",normalizedTitle:"configure your purchase",charIndex:1525},{level:2,title:"Confirm Your Purchase",slug:"confirm-your-purchase",normalizedTitle:"confirm your purchase",charIndex:2415},{level:2,title:"Auctions",slug:"auctions",normalizedTitle:"auctions",charIndex:249}],headersStr:"Overview Connect Your Wallet Checking Availability Configure Your Purchase Confirm Your Purchase Auctions",content:'# Registering an ArNS name\n\n\n# Overview\n\nThere are two options when registering an ArNS name. You can purchase the name outright, or lease it for a period of 1 to 5 years. Registrations are further broken down into instant buys, and dutch auctions. Auctions are required for purchases of certain names in a specified character length range. Find more information about when an auction is required, as well as the rules an ArNS name must follow to be valid here.\n\n\n# Connect Your Wallet\n\nIn order to purchase ArNS names, you will need to have a connected Arweave wallet in order to sign and pay for the transaction. Connect your wallet by clicking the "Connect" button in the top right, and following the prompts.\n\nYour browser does not support the video tag.\n\n\n# Checking Availability\n\nThe home page of arns.app features a search box for checking if a specific ArNS name is available for registration. Indicators below the box can help to make sure you are complying with the technical requirements for name validity as you type.\n\nSimply type out the name you would like to register and click on the search icon next to the text box. A check will be performed to let you know if your chosen name is available or already in use.\n\nNOTE: 1 to 4 character names are not available during the testnet.\n\nor\n\nIf a name is unavailable, information about the name\'s registration period and current owner will be displayed. If it is available, a "Register" button will appear, allowing you to move to the next step in registration.\n\n\n# Configure Your Purchase\n\nAfter clicking "Register" on a valid and available name, you will be prompted to connect a wallet using ArConnect if you have not already done so. Support for other wallets will be added in the future.\n\nOnce you are connected, you will be shown a page to configure your purchase. You will be able to select if you want to lease or buy the name, and the length of the lease. A notice will appear if your purchase requires an auction.\n\nYou can also use this page to assign the name to an existing Arweave Name Token (ANT), or set an Arweave Transaction ID (Target ID) for the name to resolve to. You will be able to set or change the Target ID after your purchase from the asset management page.\n\nTowards the bottom of the page, you can also see the cost of your currently configured purchase in IO tokens, and the AR required to pay for gas for the transaction.\n\n\n# Confirm Your Purchase\n\nThe final page before submitting your purchase shows a summary of your purchase. If everything looks correct, click on the "confirm" button to finalize the transaction. Remain on the page while the transaction processes.\n\n\n\n# Auctions\n\nNo additional steps are necessary to initiate a purchase that requires an auction. However, the name will not immediately become yours. Instead, confirming your purchase will begin the auction.\n\nThe IO cost displayed on the confirmation page will be frozen by the aoComputer contract, and used to finalize the purchase once the the auction drops to the floor price. You, or anyone else, may purchase the name at any time for the current auction price. You can click on the "View Auction" button from your confirmation page, or find your auction in the "Live Auctions" tab at the top of the screen to view the current auction price, and how it will change over time. If someone else purchases the name prior to the auction reaching the floor price, your frozen tokens will be released to you.',normalizedContent:'# registering an arns name\n\n\n# overview\n\nthere are two options when registering an arns name. you can purchase the name outright, or lease it for a period of 1 to 5 years. registrations are further broken down into instant buys, and dutch auctions. auctions are required for purchases of certain names in a specified character length range. find more information about when an auction is required, as well as the rules an arns name must follow to be valid here.\n\n\n# connect your wallet\n\nin order to purchase arns names, you will need to have a connected arweave wallet in order to sign and pay for the transaction. connect your wallet by clicking the "connect" button in the top right, and following the prompts.\n\nyour browser does not support the video tag.\n\n\n# checking availability\n\nthe home page of arns.app features a search box for checking if a specific arns name is available for registration. indicators below the box can help to make sure you are complying with the technical requirements for name validity as you type.\n\nsimply type out the name you would like to register and click on the search icon next to the text box. a check will be performed to let you know if your chosen name is available or already in use.\n\nnote: 1 to 4 character names are not available during the testnet.\n\nor\n\nif a name is unavailable, information about the name\'s registration period and current owner will be displayed. if it is available, a "register" button will appear, allowing you to move to the next step in registration.\n\n\n# configure your purchase\n\nafter clicking "register" on a valid and available name, you will be prompted to connect a wallet using arconnect if you have not already done so. support for other wallets will be added in the future.\n\nonce you are connected, you will be shown a page to configure your purchase. you will be able to select if you want to lease or buy the name, and the length of the lease. a notice will appear if your purchase requires an auction.\n\nyou can also use this page to assign the name to an existing arweave name token (ant), or set an arweave transaction id (target id) for the name to resolve to. you will be able to set or change the target id after your purchase from the asset management page.\n\ntowards the bottom of the page, you can also see the cost of your currently configured purchase in io tokens, and the ar required to pay for gas for the transaction.\n\n\n# confirm your purchase\n\nthe final page before submitting your purchase shows a summary of your purchase. if everything looks correct, click on the "confirm" button to finalize the transaction. remain on the page while the transaction processes.\n\n\n\n# auctions\n\nno additional steps are necessary to initiate a purchase that requires an auction. however, the name will not immediately become yours. instead, confirming your purchase will begin the auction.\n\nthe io cost displayed on the confirmation page will be frozen by the aocomputer contract, and used to finalize the purchase once the the auction drops to the floor price. you, or anyone else, may purchase the name at any time for the current auction price. you can click on the "view auction" button from your confirmation page, or find your auction in the "live auctions" tab at the top of the screen to view the current auction price, and how it will change over time. if someone else purchases the name prior to the auction reaching the floor price, your frozen tokens will be released to you.',charsets:{}},{title:"Delegated Staking",frontmatter:{permalink:"/guides/delegated-staking"},regularPath:"/guides/delegated-staking.html",relativePath:"guides/delegated-staking.md",key:"v-0d0949e4",path:"/guides/delegated-staking/",headers:[{level:2,title:"Overview",slug:"overview",normalizedTitle:"overview",charIndex:24},{level:2,title:"Installing the Testnet Contract repo",slug:"installing-the-testnet-contract-repo",normalizedTitle:"installing the testnet contract repo",charIndex:600},{level:2,title:"Installing dependencies",slug:"installing-dependencies",normalizedTitle:"installing dependencies",charIndex:1310},{level:2,title:"Providing Wallet",slug:"providing-wallet",normalizedTitle:"providing wallet",charIndex:1580},{level:2,title:"Running the Script",slug:"running-the-script",normalizedTitle:"running the script",charIndex:1976},{level:2,title:"Withdrawing Stake",slug:"withdrawing-stake",normalizedTitle:"withdrawing stake",charIndex:2437}],headersStr:"Overview Installing the Testnet Contract repo Installing dependencies Providing Wallet Running the Script Withdrawing Stake",content:"# Delegated Staking\n\n\n# Overview\n\nDelegated staking is a process by which a person can stake their own IO tokens on someone elses ar.io gateway. The additional staked tokens increase that gateway's chance to be selected as an observer, and so they have the potential to earn more rewards. In exchange, the person who delegates the tokens will receive a share of the gateway's rewards. Gateway operators can set the percentage of rewards are available for delegating wallets.\n\nYou can find more specific information about delegated staking and how rewards are distributed in the ar.io whitepaper.\n\n\n# Installing the Testnet Contract repo\n\nDelegating tokens can be accomplished very easily by running a script found in the testnet-contract repo on Github.\n\nIf you already have the repo installed, make sure that it is updated to the latest version by opening it in a terminal and running git pull.\n\nIf you receive an error, try git stash to remove any changes you may have made locally and then git pull again.\n\nIf you do not have the repo installed, make sure that you have git installed on your computer, navigate to the location where you would like to save it, and run\n\ngit clone https://github.com/ar-io/testnet-contract\n\n\nThis will copy all of the files from github into a new folder on your computer.\n\n\n# Installing dependencies\n\nOnce the repo is installed, you need to install the code that it relies on to work. We do this using Yarn.\n\nNavigate your terminal into the newly created repo folder.\n\ncd testnet-contract\n\n\nand then install dependencies with:\n\nyarn install\n\n\n\n# Providing Wallet\n\nIn order to send tokens to be staked, you will need to use a wallet that has IO tokens in it. The easiest way to provide your wallet is to put the path to your Keyfile in your .env as WALLET_FILE_PATH.\n\nYou will need a small amount of AR in this wallet, in addition to the IO tokens, in order to pay for the contract interaction.\n\n//.env\n\nWALLET_FILE_PATH=\n\n\n\n# Running the Script\n\nOnce the repo is installed and your wallet is provided, all that is left is to run the script. This can be done with a single command in your terminal.\n\nMake sure your terminal is in the root folder of the testnet-contract repo (the one named 'testnet-contract'), and run this command:\n\nyarn delegate-stake\n\n\nYou will be prompted in your terminal for the number of tokens you want to stake, and the wallet address of the target gateway.\n\n\n# Withdrawing Stake\n\nIf you want to take your staked tokens out of a gateway, the process is very similar. You will be running the decrease-delegate-stake script instead of the delegate-stake script.\n\nyarn decrease-delegate-stake\n\n\nYou will again be prompted for the number of tokens you want to withdraw and the wallet address of the gateway you want to withdraw from.\n\nOnly the wallet that owns the staked tokens can withdraw, so make sure you are using the same wallet to run the script as you used to stake the tokens initially.\n\nNOTE: Token withdrawals are not instant, and there is a period where the tokens will remain unavailable after you run the script. The length of this hold may vary a bit during testnet while optimal times are iterated upon.",normalizedContent:"# delegated staking\n\n\n# overview\n\ndelegated staking is a process by which a person can stake their own io tokens on someone elses ar.io gateway. the additional staked tokens increase that gateway's chance to be selected as an observer, and so they have the potential to earn more rewards. in exchange, the person who delegates the tokens will receive a share of the gateway's rewards. gateway operators can set the percentage of rewards are available for delegating wallets.\n\nyou can find more specific information about delegated staking and how rewards are distributed in the ar.io whitepaper.\n\n\n# installing the testnet contract repo\n\ndelegating tokens can be accomplished very easily by running a script found in the testnet-contract repo on github.\n\nif you already have the repo installed, make sure that it is updated to the latest version by opening it in a terminal and running git pull.\n\nif you receive an error, try git stash to remove any changes you may have made locally and then git pull again.\n\nif you do not have the repo installed, make sure that you have git installed on your computer, navigate to the location where you would like to save it, and run\n\ngit clone https://github.com/ar-io/testnet-contract\n\n\nthis will copy all of the files from github into a new folder on your computer.\n\n\n# installing dependencies\n\nonce the repo is installed, you need to install the code that it relies on to work. we do this using yarn.\n\nnavigate your terminal into the newly created repo folder.\n\ncd testnet-contract\n\n\nand then install dependencies with:\n\nyarn install\n\n\n\n# providing wallet\n\nin order to send tokens to be staked, you will need to use a wallet that has io tokens in it. the easiest way to provide your wallet is to put the path to your keyfile in your .env as wallet_file_path.\n\nyou will need a small amount of ar in this wallet, in addition to the io tokens, in order to pay for the contract interaction.\n\n//.env\n\nwallet_file_path=\n\n\n\n# running the script\n\nonce the repo is installed and your wallet is provided, all that is left is to run the script. this can be done with a single command in your terminal.\n\nmake sure your terminal is in the root folder of the testnet-contract repo (the one named 'testnet-contract'), and run this command:\n\nyarn delegate-stake\n\n\nyou will be prompted in your terminal for the number of tokens you want to stake, and the wallet address of the target gateway.\n\n\n# withdrawing stake\n\nif you want to take your staked tokens out of a gateway, the process is very similar. you will be running the decrease-delegate-stake script instead of the delegate-stake script.\n\nyarn decrease-delegate-stake\n\n\nyou will again be prompted for the number of tokens you want to withdraw and the wallet address of the gateway you want to withdraw from.\n\nonly the wallet that owns the staked tokens can withdraw, so make sure you are using the same wallet to run the script as you used to stake the tokens initially.\n\nnote: token withdrawals are not instant, and there is a period where the tokens will remain unavailable after you run the script. the length of this hold may vary a bit during testnet while optimal times are iterated upon.",charsets:{}},{title:"Deploy a Website or Application",frontmatter:{permalink:"/guides/perma-deploy"},regularPath:"/guides/github-flow.html",relativePath:"guides/github-flow.md",key:"v-598bd946",path:"/guides/perma-deploy/",headers:[{level:2,title:"Overview",slug:"overview",normalizedTitle:"overview",charIndex:38},{level:2,title:"Getting Started",slug:"getting-started",normalizedTitle:"getting started",charIndex:741},{level:3,title:"Installing package",slug:"installing-package",normalizedTitle:"installing package",charIndex:761},{level:3,title:"Adding a Deploy Script",slug:"adding-a-deploy-script",normalizedTitle:"adding a deploy script",charIndex:1738},{level:3,title:"Providing Arweave Wallet Keys",slug:"providing-arweave-wallet-keys",normalizedTitle:"providing arweave wallet keys",charIndex:3380},{level:3,title:"Create Github Secrets",slug:"create-github-secrets",normalizedTitle:"create github secrets",charIndex:4364},{level:3,title:"Create Action Workflow",slug:"create-action-workflow",normalizedTitle:"create action workflow",charIndex:5232},{level:2,title:"Deploying App",slug:"deploying-app",normalizedTitle:"deploying app",charIndex:6555}],headersStr:"Overview Getting Started Installing package Adding a Deploy Script Providing Arweave Wallet Keys Create Github Secrets Create Action Workflow Deploying App",content:'# Deploy a Website or Application\n\n\n# Overview\n\nWith the growing popularity of permanently deployed apps, hosted on Arweave, along with the growing list of tools offered by ar.io, several methods have been developed to automate the process of deploying a website and updating the ArNS name pointed at it. A particularly useful tool for this is permaweb-deploy from Forward Research.\n\npermaweb-deploy is a cli tool that handles uploading a build folder to Arweave using Turbo, creating a manifest, and then updating an ArNS name to point at the new manifest. It being a cli tool makes it very easy to incorporate into a github actions flow. Setting up an automated deployment with permaweb-deploy is simple, but does require a few steps.\n\n\n# Getting Started\n\n\n# Installing package\n\npermaweb-deploy is an npm package, and must be installed in any project before it can be used. If you are using npm, you can install the package with the below command:\n\nnpm install permaweb-deploy\n\n\nIf you prefer yarn for your package installations, the process is slightly more involved. permaweb-deploy is not designed for installation with yarn, so you must provide the additional argument ignore-engines in order to skip over the yarn version error you would normally get with installation. There are two methods for doing so:\n\n * Directly in the install command\n \n yarn add permaweb-deploy --ignore-engines\n \n\n * In a .yarnc file\n \n You can provide a file, named .yarnc in the same directory as your package.json in order to assign specific instructions to all of your yarn commands. Creating a .yarnc file with the line\n \n ignore-engines true\n \n \n will have the same effect as providing the flag directly in your yarn command\n\n\n# Adding a Deploy Script\n\nThe simplest way to utilize the permaweb-deploy tool is to build it into a script in your package.json. Here you will provide all of the variables that permaweb-deploy needs in order to function properly, as well as ensure that your app is statically built before being uploaded.\n\n"scripts": {\n "build": "vuepress build src",\n "deploy": "npm run build && permaweb-deploy --deploy-folder ./src/.vuepress/dist --ant-process $DEPLOY_ANT_PROCESS_ID"\n },\n\n\nThe above example shows a build script for a vuepress app, which will build the app into a static folder for deployment, and a deploy script which runs build and then permaweb-deploy. Your build script will look different depending on the framework you are using, but most will provide that for you when you create your app.\n\nThe permaweb-deploy command has two required arguments:\n\n * --deploy-folder This is the relative path (from your package.json) to the build folder you want to upload. In a vuepress app, that will be ./src/.vuepress/dist unless you manually specify otherwise in your vuepress configuration. It will be different depending on your chosen framework and if you have modified the default location.\n\n * --ant-process This is the process id of the Arweave Name Token for the ArNS name you want to deploy to. You can find this id by viewing the name on arns.app. Providing the process id is crucial for making sure the update is sent to the ao process that controls the ArNS name.\n\nThere is also the additional, optional flag --undername. If you want to deploy your app to an undername on an ArNS name, provide that name with this flag.\n\n\n# Providing Arweave Wallet Keys\n\nWhile using permaweb-deploy, you will be uploading data to Arweave using Turbo, as well as performing protected actions on an Arweave Name Token. Because of this, you will need to provide the keys to an Arweave wallet in order for the actions to be successful. The wallet must contain Turbo Credits to pay for the upload, and it must either be a controller or the owner of the ArNS name you are trying to update.\n\npermaweb-deploy requires your wallet keyfile be encoded in base64 format. You can convert a local keyfile to base64, and copy the new value to your clipboard by using one of the below commands, depending on your operating system:\n\n * Linux\n\nbase64 wallet.json | xclip -selection clipboard\n\n\n * Mac\n\nbase64 wallet.json | pbcopy\n\n\n * Windows (CMD)\n\nbase64 wallet.json | clip\n\n\nBe sure to replace wallet.json with the path to your chosen wallet keyfile. Once you have this value saved to your clipboard, you can move on to the next step.\n\n\n# Create Github Secrets\n\nAnyone who has your wallet keyfile (including the base64 formatted keyfile) has full control over your wallet and any of its assets. Because of this, you do not want to include it directly in your package.json script. Instead, keep the value safe by storing it in a github secret. You will create the secrets in the settings tab on your github repo, and the secrets will act as environmental variables in the github actions workflow.\n\nYou will need to create 2 secrets"\n\n * DEPLOY_KEY: This is the base64 encoded version of your Arweave wallet keyfile.\n\n * ANT_PROCESS: This is the process id of the Arweave Name Token for your ArNS name. This value is not as sensitive, and may be provided in your package.json without issue, but it is a very long hashed string, and it is much easier to work with the variable name than the string itself.\n\n\n# Create Action Workflow\n\nGithub Actions allow you to perform specific actions whenever you push code to github. They are handled by using .yaml files provided in /.github/workflows.\n\nTo get started, create a new file named deploy.yaml in the workflows directory, then paste the below inside of it:\n\nname: Arweave Deploy\n\non:\n push:\n branches:\n - main\n\njobs:\n Arweave-build-and-deploy:\n runs-on: ubuntu-latest\n\n steps:\n - uses: actions/checkout@v2\n\n - name: Setup Node.js environment\n uses: actions/setup-node@v2\n with:\n node-version: "20"\n\n - name: Run deployment script\n env:\n DEPLOY_KEY: ${{ secrets.DEPLOY_KEY }}\n DEPLOY_ANT_PROCESS: ${{ secrets.DEPLOY_ANT_PROCESS}}\n run: |\n npm install\n npm run deploy\n\n\nThe above tells github to perform these actions when you push new code to the branch main\n\nIt then sets up a vps with nodejs v 20. When that is complete, it installs dependencies for your project using npm (You will need to add a step to install yarn if that is your preferred package manager), and runs your deploy script, which builds your static folder and then runs permaweb-deploy. It also loads your github secrets into environmental variables that can be used by your deploy script.\n\n\n# Deploying App\n\nWith the above setup complete, the only thing you need to do to deploy a new version of a permasite app to Arweave is push the updated code to branch main on github. Everything else is fully automated.',normalizedContent:'# deploy a website or application\n\n\n# overview\n\nwith the growing popularity of permanently deployed apps, hosted on arweave, along with the growing list of tools offered by ar.io, several methods have been developed to automate the process of deploying a website and updating the arns name pointed at it. a particularly useful tool for this is permaweb-deploy from forward research.\n\npermaweb-deploy is a cli tool that handles uploading a build folder to arweave using turbo, creating a manifest, and then updating an arns name to point at the new manifest. it being a cli tool makes it very easy to incorporate into a github actions flow. setting up an automated deployment with permaweb-deploy is simple, but does require a few steps.\n\n\n# getting started\n\n\n# installing package\n\npermaweb-deploy is an npm package, and must be installed in any project before it can be used. if you are using npm, you can install the package with the below command:\n\nnpm install permaweb-deploy\n\n\nif you prefer yarn for your package installations, the process is slightly more involved. permaweb-deploy is not designed for installation with yarn, so you must provide the additional argument ignore-engines in order to skip over the yarn version error you would normally get with installation. there are two methods for doing so:\n\n * directly in the install command\n \n yarn add permaweb-deploy --ignore-engines\n \n\n * in a .yarnc file\n \n you can provide a file, named .yarnc in the same directory as your package.json in order to assign specific instructions to all of your yarn commands. creating a .yarnc file with the line\n \n ignore-engines true\n \n \n will have the same effect as providing the flag directly in your yarn command\n\n\n# adding a deploy script\n\nthe simplest way to utilize the permaweb-deploy tool is to build it into a script in your package.json. here you will provide all of the variables that permaweb-deploy needs in order to function properly, as well as ensure that your app is statically built before being uploaded.\n\n"scripts": {\n "build": "vuepress build src",\n "deploy": "npm run build && permaweb-deploy --deploy-folder ./src/.vuepress/dist --ant-process $deploy_ant_process_id"\n },\n\n\nthe above example shows a build script for a vuepress app, which will build the app into a static folder for deployment, and a deploy script which runs build and then permaweb-deploy. your build script will look different depending on the framework you are using, but most will provide that for you when you create your app.\n\nthe permaweb-deploy command has two required arguments:\n\n * --deploy-folder this is the relative path (from your package.json) to the build folder you want to upload. in a vuepress app, that will be ./src/.vuepress/dist unless you manually specify otherwise in your vuepress configuration. it will be different depending on your chosen framework and if you have modified the default location.\n\n * --ant-process this is the process id of the arweave name token for the arns name you want to deploy to. you can find this id by viewing the name on arns.app. providing the process id is crucial for making sure the update is sent to the ao process that controls the arns name.\n\nthere is also the additional, optional flag --undername. if you want to deploy your app to an undername on an arns name, provide that name with this flag.\n\n\n# providing arweave wallet keys\n\nwhile using permaweb-deploy, you will be uploading data to arweave using turbo, as well as performing protected actions on an arweave name token. because of this, you will need to provide the keys to an arweave wallet in order for the actions to be successful. the wallet must contain turbo credits to pay for the upload, and it must either be a controller or the owner of the arns name you are trying to update.\n\npermaweb-deploy requires your wallet keyfile be encoded in base64 format. you can convert a local keyfile to base64, and copy the new value to your clipboard by using one of the below commands, depending on your operating system:\n\n * linux\n\nbase64 wallet.json | xclip -selection clipboard\n\n\n * mac\n\nbase64 wallet.json | pbcopy\n\n\n * windows (cmd)\n\nbase64 wallet.json | clip\n\n\nbe sure to replace wallet.json with the path to your chosen wallet keyfile. once you have this value saved to your clipboard, you can move on to the next step.\n\n\n# create github secrets\n\nanyone who has your wallet keyfile (including the base64 formatted keyfile) has full control over your wallet and any of its assets. because of this, you do not want to include it directly in your package.json script. instead, keep the value safe by storing it in a github secret. you will create the secrets in the settings tab on your github repo, and the secrets will act as environmental variables in the github actions workflow.\n\nyou will need to create 2 secrets"\n\n * deploy_key: this is the base64 encoded version of your arweave wallet keyfile.\n\n * ant_process: this is the process id of the arweave name token for your arns name. this value is not as sensitive, and may be provided in your package.json without issue, but it is a very long hashed string, and it is much easier to work with the variable name than the string itself.\n\n\n# create action workflow\n\ngithub actions allow you to perform specific actions whenever you push code to github. they are handled by using .yaml files provided in /.github/workflows.\n\nto get started, create a new file named deploy.yaml in the workflows directory, then paste the below inside of it:\n\nname: arweave deploy\n\non:\n push:\n branches:\n - main\n\njobs:\n arweave-build-and-deploy:\n runs-on: ubuntu-latest\n\n steps:\n - uses: actions/checkout@v2\n\n - name: setup node.js environment\n uses: actions/setup-node@v2\n with:\n node-version: "20"\n\n - name: run deployment script\n env:\n deploy_key: ${{ secrets.deploy_key }}\n deploy_ant_process: ${{ secrets.deploy_ant_process}}\n run: |\n npm install\n npm run deploy\n\n\nthe above tells github to perform these actions when you push new code to the branch main\n\nit then sets up a vps with nodejs v 20. when that is complete, it installs dependencies for your project using npm (you will need to add a step to install yarn if that is your preferred package manager), and runs your deploy script, which builds your static folder and then runs permaweb-deploy. it also loads your github secrets into environmental variables that can be used by your deploy script.\n\n\n# deploying app\n\nwith the above setup complete, the only thing you need to do to deploy a new version of a permasite app to arweave is push the updated code to branch main on github. everything else is fully automated.',charsets:{cjk:!0}},{title:"GraphQL",frontmatter:{permalink:"/guides/graphql/"},regularPath:"/guides/gql.html",relativePath:"guides/gql.md",key:"v-c8f0091c",path:"/guides/graphql/",headers:[{level:2,title:"Overview",slug:"overview",normalizedTitle:"overview",charIndex:14},{level:2,title:"Constructing a Query",slug:"constructing-a-query",normalizedTitle:"constructing a query",charIndex:1628},{level:3,title:"Basic Syntax",slug:"basic-syntax",normalizedTitle:"basic syntax",charIndex:1653},{level:3,title:"Customizing Searches with Tags",slug:"customizing-searches-with-tags",normalizedTitle:"customizing searches with tags",charIndex:2087},{level:3,title:"Understanding Edges and Nodes",slug:"understanding-edges-and-nodes",normalizedTitle:"understanding edges and nodes",charIndex:2775},{level:3,title:"Pagination",slug:"pagination",normalizedTitle:"pagination",charIndex:4422},{level:3,title:"General Tips for Optimizing Queries",slug:"general-tips-for-optimizing-queries",normalizedTitle:"general tips for optimizing queries",charIndex:6158},{level:2,title:"Making a Query",slug:"making-a-query",normalizedTitle:"making a query",charIndex:7207},{level:3,title:"GraphQL Playground",slug:"graphql-playground",normalizedTitle:"graphql playground",charIndex:7603},{level:3,title:"Using an API",slug:"using-an-api",normalizedTitle:"using an api",charIndex:8542},{level:3,title:"Using an SDK",slug:"using-an-sdk",normalizedTitle:"using an sdk",charIndex:9763}],headersStr:"Overview Constructing a Query Basic Syntax Customizing Searches with Tags Understanding Edges and Nodes Pagination General Tips for Optimizing Queries Making a Query GraphQL Playground Using an API Using an SDK",content:"# GraphQL\n\n\n# Overview\n\nGraphQL is a powerful query language designed for modern web applications to efficiently fetch data. It enables precise queries, allowing users to specify exactly which data they need and in what format, significantly reducing the amount of unnecessary data transferred. This approach is ideal for dealing with complex systems and large datasets, as it minimizes bandwidth and improves performance. GraphQL operates through a single endpoint, streamlining the way applications communicate with databases.\n\nThe integration of GraphQL with Arweave introduces a refined method for interacting with decentralized data storage. Arweave allows for the tagging of uploaded data, facilitating enhanced searchability and retrievability within its blockchain network. Utilizing GraphQL, users can perform targeted queries that leverage these tags, ensuring the retrieval of specific data swiftly and efficiently. This capability is particularly beneficial for the development of decentralized applications (dApps), the archival of content in a permanent and unalterable form, and the establishment of data marketplaces where precision and efficiency in data access are paramount.\n\nTogether, GraphQL and Arweave form a compelling combination, offering developers and users a robust framework for managing and querying data in a decentralized environment. This integration not only promotes the efficient and scalable retrieval of data but also supports the creation of more sophisticated and data-intensive applications on the decentralized web, maintaining a balance between technical depth and accessibility.\n\n\n# Constructing a Query\n\n\n# Basic Syntax\n\nIn GraphQL, you start with a root field and use braces to outline the fields you want to retrieve, allowing for precise, hierarchical data requests. For instance:\n\n{\n transactions {\n edges {\n node {\n id\n tags {\n name\n value\n }\n }\n }\n }\n}\n\n\nThis query demonstrates fetching transactions and their tags, illustrating the hierarchical nature of GraphQL queries.\n\n\n# Customizing Searches with Tags\n\nArweave utilizes a tagging system for transactions, enabling intricate search capabilities. You can filter queries using these tags:\n\n{\n transactions(tags: [{name: \"App-Name\", values: \"YourAppName\"}]) {\n edges {\n node {\n id\n data {\n size\n type\n }\n }\n }\n }\n}\n\n\nThis example filters transactions by a specific application name, and returns the id, size, and type of the transaction, showcasing how to customize queries for targeted data retrieval.\n\nNOTE: Tags are not the only option for filtering results, but are extremely useful due to the ability to add custom tags during the upload process.\n\n\n# Understanding Edges and Nodes\n\nIn the realm of GraphQL queries, especially when interfacing with Arweave, grasping the concept of edges and nodes is pivotal for constructing efficient and effective queries. This structure is not unique to Arweave but is particularly relevant due to the decentralized and interconnected nature of the data stored on its blockchain.\n\n * Nodes: At the heart of GraphQL's query structure, nodes represent individual data points or entities. In the context of Arweave, a node could be a transaction, a block, or any piece of data stored within the network. Nodes are the primary targets of your query, containing the data you wish to retrieve, such as transaction IDs, tags, or the content of data transactions.\n\n * Edges: Serving as the glue between nodes, edges are constructs that outline the relationship between different nodes. They can contain metadata about the connection, such as the nature of the relationship or additional attributes that describe how nodes are linked. In many GraphQL implementations, including those that interact with Arweave, edges are used to navigate through collections of related data, making them crucial for understanding the data's structure and lineage.\n\nThis hierarchical model is especially useful for querying complex and relational data sets, allowing for detailed navigation and efficient data retrieval within Arweave's decentralized storage system. By effectively utilizing the edges and nodes structure, you can precisely target the data you need, whether it's filtering transactions by tags, fetching related transactions, or exploring the blockchain's structure.\n\n\n# Pagination\n\nTo add pagination to your GraphQL queries, you can use the first, last, before, and after parameters. These parameters control the slice of data you're querying, making data retrieval more efficient and manageable.\n\n * first: Specify the number of items to retrieve from the start of the list or dataset.\n * last: Specify the number of items to retrieve from the end of the list or dataset.\n\n{\n transactions(first: 10) {\n edges {\n node {\n id\n }\n }\n }\n}\n\n\nThis query fetches the first 10 transactions.\n\nTo navigate through your dataset, you can use after and before in conjunction with first or last. These parameters accept cursors, which are typically provided in the response of your initial query.\n\n * after: Fetch items after the specified cursor, used with first.\n * before: Fetch items before the specified cursor, used with last.\n\n{\n transactions(first: 10, after: \"cursorOfLastItem\") {\n edges {\n node {\n id\n }\n }\n }\n}\n\n\nThis query fetches the next 10 transactions following the transaction with the cursor \"cursorOfLastItem\".\n\nIf no pagination terms are set, GraphQL servers may apply default limits to prevent excessively large datasets from being returned in a single query, potentially impacting performance. The default behavior can vary based on the server's configuration but often involves returning a predefined maximum number of items.\n\nFor instance, without specifying first or last, a query to the transactions field might return the first 5-10 transactions by default, depending on the server settings.\n\nThis behavior ensures that server resources are not overwhelmed by large requests and that client applications receive data in manageable chunks.\n\n\n# General Tips for Optimizing Queries\n\nTo optimize your GraphQL queries in Arweave, follow these general guidelines:\n\n * Specificity: Query with the most precise tags possible to narrow the search scope and enhance performance.\n * Minimalism: Limit your query to the essential set of tags to reduce processing time and data transfer.\n * Schema Design: Design your app's schema to reflect query patterns, possibly introducing tags that encapsulate frequent combinations of criteria.\n * Include Non-tag Fields: Adding fields like owner can refine your search, making your queries more efficient.\n * Order Your Tags: Arrange tags from most specific to most general to leverage Arweave's indexing more effectively.\n\nBy incorporating these strategies, developers can achieve faster and more precise data access from Arweave, enhancing the performance and responsiveness of decentralized applications. This balanced approach to query construction and optimization is key to navigating the expansive and decentralized storage landscape Arweave provides.\n\n\n# Making a Query\n\nExecuting GraphQL queries within the Arweave ecosystem offers flexibility and multiple avenues for developers and users alike. Whether you prefer a hands-on, manual approach to constructing and testing queries, or you aim for automation and integration within your applications, Arweave provides the tools necessary to interact with its decentralized data storage seamlessly.\n\n\n# GraphQL Playground\n\nFor those new to GraphQL or seeking to fine-tune their queries before implementation, the GraphQL playground offers an invaluable resource. This interactive interface allows users to manually construct queries, explore the schema, and immediately see the results of their queries. Accessible via web browsers, the playground can be found at the /graphql endpoint of most Arweave indexing services, such as https://arweave.dev/graphql. Here, you can experiment with different queries, understand the structure of the data, and refine your approach without writing a single line of code in your application.\n\nSteps for Accessing the GraphQL Playground:\n\n 1. Navigate to https://arweave.dev/graphql, or the graphql endpoint of any ar.io gateway, in your web browser.\n 2. Enter your GraphQL query in the provided interface.\n 3. Press the \"play\" button to execute the query to see real-time results and debug as needed.\n\n\n# Using an API\n\nFor application development and automation, making GraphQL queries programmatically is essential. You can send POST requests directly to the GraphQL endpoint of any indexing service that supports it, such as arweave.net or any ar.io gateway. These requests should contain your query in the body, allowing for dynamic and automated data retrieval within your application.\n\nWhen selecting an indexing service, consider the data coverage and reliability of the gateway to ensure it meets your application's needs. Different gateways might have varying degrees of indexed data available, so choosing one that is consistently up-to-date and comprehensive is key.\n\nExample of making a programmatic query:\n\nconst axios = require('axios');\n\nconst query = {\n query: `\n {\n transactions(tags: [{name: \"App-Name\", values: \"YourAppName\"}]) {\n edges {\n node {\n id\n tags {\n name\n value\n }\n }\n }\n }\n }\n `\n};\n\naxios.post('https://arweave.net/graphql', query, {\n headers: { 'Content-Type': 'application/json' },\n})\n.then(response => console.log(response.data))\n.catch(error => console.error('Error:', error));\n\n\n\n# Using an SDK\n\nFor an even more integrated experience, some Software Development Kits (SDKs) offer direct methods for executing GraphQL queries. The Arweave SDK, for example, provides built-in functionalities to interact with the blockchain, simplifying the process of making queries. By leveraging these SDKs, developers can bypass the intricacies of manual HTTP request construction, focusing instead on the logic and design of their applications.\n\nExample of using the Arweave SDK for GraphQL queries:\n\n// Assuming the Arweave SDK is already set up and initialized\nconst query = {\n query: `\n {\n transactions(tags: [{name: \"App-Name\", values: \"YourAppName\"}]) {\n edges {\n node {\n id\n tags {\n name\n value\n }\n }\n }\n }\n }\n `\n};\n\narweave.api.post('/graphql', query)\n .then(response => {\n console.log(response.data);\n })\n .catch(error => {\n console.error('Error:', error);\n });\n",normalizedContent:"# graphql\n\n\n# overview\n\ngraphql is a powerful query language designed for modern web applications to efficiently fetch data. it enables precise queries, allowing users to specify exactly which data they need and in what format, significantly reducing the amount of unnecessary data transferred. this approach is ideal for dealing with complex systems and large datasets, as it minimizes bandwidth and improves performance. graphql operates through a single endpoint, streamlining the way applications communicate with databases.\n\nthe integration of graphql with arweave introduces a refined method for interacting with decentralized data storage. arweave allows for the tagging of uploaded data, facilitating enhanced searchability and retrievability within its blockchain network. utilizing graphql, users can perform targeted queries that leverage these tags, ensuring the retrieval of specific data swiftly and efficiently. this capability is particularly beneficial for the development of decentralized applications (dapps), the archival of content in a permanent and unalterable form, and the establishment of data marketplaces where precision and efficiency in data access are paramount.\n\ntogether, graphql and arweave form a compelling combination, offering developers and users a robust framework for managing and querying data in a decentralized environment. this integration not only promotes the efficient and scalable retrieval of data but also supports the creation of more sophisticated and data-intensive applications on the decentralized web, maintaining a balance between technical depth and accessibility.\n\n\n# constructing a query\n\n\n# basic syntax\n\nin graphql, you start with a root field and use braces to outline the fields you want to retrieve, allowing for precise, hierarchical data requests. for instance:\n\n{\n transactions {\n edges {\n node {\n id\n tags {\n name\n value\n }\n }\n }\n }\n}\n\n\nthis query demonstrates fetching transactions and their tags, illustrating the hierarchical nature of graphql queries.\n\n\n# customizing searches with tags\n\narweave utilizes a tagging system for transactions, enabling intricate search capabilities. you can filter queries using these tags:\n\n{\n transactions(tags: [{name: \"app-name\", values: \"yourappname\"}]) {\n edges {\n node {\n id\n data {\n size\n type\n }\n }\n }\n }\n}\n\n\nthis example filters transactions by a specific application name, and returns the id, size, and type of the transaction, showcasing how to customize queries for targeted data retrieval.\n\nnote: tags are not the only option for filtering results, but are extremely useful due to the ability to add custom tags during the upload process.\n\n\n# understanding edges and nodes\n\nin the realm of graphql queries, especially when interfacing with arweave, grasping the concept of edges and nodes is pivotal for constructing efficient and effective queries. this structure is not unique to arweave but is particularly relevant due to the decentralized and interconnected nature of the data stored on its blockchain.\n\n * nodes: at the heart of graphql's query structure, nodes represent individual data points or entities. in the context of arweave, a node could be a transaction, a block, or any piece of data stored within the network. nodes are the primary targets of your query, containing the data you wish to retrieve, such as transaction ids, tags, or the content of data transactions.\n\n * edges: serving as the glue between nodes, edges are constructs that outline the relationship between different nodes. they can contain metadata about the connection, such as the nature of the relationship or additional attributes that describe how nodes are linked. in many graphql implementations, including those that interact with arweave, edges are used to navigate through collections of related data, making them crucial for understanding the data's structure and lineage.\n\nthis hierarchical model is especially useful for querying complex and relational data sets, allowing for detailed navigation and efficient data retrieval within arweave's decentralized storage system. by effectively utilizing the edges and nodes structure, you can precisely target the data you need, whether it's filtering transactions by tags, fetching related transactions, or exploring the blockchain's structure.\n\n\n# pagination\n\nto add pagination to your graphql queries, you can use the first, last, before, and after parameters. these parameters control the slice of data you're querying, making data retrieval more efficient and manageable.\n\n * first: specify the number of items to retrieve from the start of the list or dataset.\n * last: specify the number of items to retrieve from the end of the list or dataset.\n\n{\n transactions(first: 10) {\n edges {\n node {\n id\n }\n }\n }\n}\n\n\nthis query fetches the first 10 transactions.\n\nto navigate through your dataset, you can use after and before in conjunction with first or last. these parameters accept cursors, which are typically provided in the response of your initial query.\n\n * after: fetch items after the specified cursor, used with first.\n * before: fetch items before the specified cursor, used with last.\n\n{\n transactions(first: 10, after: \"cursoroflastitem\") {\n edges {\n node {\n id\n }\n }\n }\n}\n\n\nthis query fetches the next 10 transactions following the transaction with the cursor \"cursoroflastitem\".\n\nif no pagination terms are set, graphql servers may apply default limits to prevent excessively large datasets from being returned in a single query, potentially impacting performance. the default behavior can vary based on the server's configuration but often involves returning a predefined maximum number of items.\n\nfor instance, without specifying first or last, a query to the transactions field might return the first 5-10 transactions by default, depending on the server settings.\n\nthis behavior ensures that server resources are not overwhelmed by large requests and that client applications receive data in manageable chunks.\n\n\n# general tips for optimizing queries\n\nto optimize your graphql queries in arweave, follow these general guidelines:\n\n * specificity: query with the most precise tags possible to narrow the search scope and enhance performance.\n * minimalism: limit your query to the essential set of tags to reduce processing time and data transfer.\n * schema design: design your app's schema to reflect query patterns, possibly introducing tags that encapsulate frequent combinations of criteria.\n * include non-tag fields: adding fields like owner can refine your search, making your queries more efficient.\n * order your tags: arrange tags from most specific to most general to leverage arweave's indexing more effectively.\n\nby incorporating these strategies, developers can achieve faster and more precise data access from arweave, enhancing the performance and responsiveness of decentralized applications. this balanced approach to query construction and optimization is key to navigating the expansive and decentralized storage landscape arweave provides.\n\n\n# making a query\n\nexecuting graphql queries within the arweave ecosystem offers flexibility and multiple avenues for developers and users alike. whether you prefer a hands-on, manual approach to constructing and testing queries, or you aim for automation and integration within your applications, arweave provides the tools necessary to interact with its decentralized data storage seamlessly.\n\n\n# graphql playground\n\nfor those new to graphql or seeking to fine-tune their queries before implementation, the graphql playground offers an invaluable resource. this interactive interface allows users to manually construct queries, explore the schema, and immediately see the results of their queries. accessible via web browsers, the playground can be found at the /graphql endpoint of most arweave indexing services, such as https://arweave.dev/graphql. here, you can experiment with different queries, understand the structure of the data, and refine your approach without writing a single line of code in your application.\n\nsteps for accessing the graphql playground:\n\n 1. navigate to https://arweave.dev/graphql, or the graphql endpoint of any ar.io gateway, in your web browser.\n 2. enter your graphql query in the provided interface.\n 3. press the \"play\" button to execute the query to see real-time results and debug as needed.\n\n\n# using an api\n\nfor application development and automation, making graphql queries programmatically is essential. you can send post requests directly to the graphql endpoint of any indexing service that supports it, such as arweave.net or any ar.io gateway. these requests should contain your query in the body, allowing for dynamic and automated data retrieval within your application.\n\nwhen selecting an indexing service, consider the data coverage and reliability of the gateway to ensure it meets your application's needs. different gateways might have varying degrees of indexed data available, so choosing one that is consistently up-to-date and comprehensive is key.\n\nexample of making a programmatic query:\n\nconst axios = require('axios');\n\nconst query = {\n query: `\n {\n transactions(tags: [{name: \"app-name\", values: \"yourappname\"}]) {\n edges {\n node {\n id\n tags {\n name\n value\n }\n }\n }\n }\n }\n `\n};\n\naxios.post('https://arweave.net/graphql', query, {\n headers: { 'content-type': 'application/json' },\n})\n.then(response => console.log(response.data))\n.catch(error => console.error('error:', error));\n\n\n\n# using an sdk\n\nfor an even more integrated experience, some software development kits (sdks) offer direct methods for executing graphql queries. the arweave sdk, for example, provides built-in functionalities to interact with the blockchain, simplifying the process of making queries. by leveraging these sdks, developers can bypass the intricacies of manual http request construction, focusing instead on the logic and design of their applications.\n\nexample of using the arweave sdk for graphql queries:\n\n// assuming the arweave sdk is already set up and initialized\nconst query = {\n query: `\n {\n transactions(tags: [{name: \"app-name\", values: \"yourappname\"}]) {\n edges {\n node {\n id\n tags {\n name\n value\n }\n }\n }\n }\n }\n `\n};\n\narweave.api.post('/graphql', query)\n .then(response => {\n console.log(response.data);\n })\n .catch(error => {\n console.error('error:', error);\n });\n",charsets:{}},{title:"ar.io SDK Changelog",frontmatter:{},regularPath:"/guides/sdk-release-notes.html",relativePath:"guides/sdk-release-notes.md",key:"v-6c1fe4b4",path:"/guides/sdk-release-notes.html",headers:[{level:2,title:"Overview",slug:"overview",normalizedTitle:"overview",charIndex:26},{level:2,title:"2.2.0 (2024-08-30)",slug:"_2-2-0-2024-08-30",normalizedTitle:"2.2.0 (2024-08-30)",charIndex:686},{level:3,title:"Bug Fixes",slug:"bug-fixes",normalizedTitle:"bug fixes",charIndex:709},{level:3,title:"Features",slug:"features",normalizedTitle:"features",charIndex:1399},{level:2,title:"2.1.0 (2024-08-07)",slug:"_2-1-0-2024-08-07",normalizedTitle:"2.1.0 (2024-08-07)",charIndex:1511},{level:3,title:"Bug Fixes",slug:"bug-fixes-2",normalizedTitle:"bug fixes",charIndex:709},{level:3,title:"Features",slug:"features-2",normalizedTitle:"features",charIndex:1399},{level:2,title:"2.0.2 (2024-07-12)",slug:"_2-0-2-2024-07-12",normalizedTitle:"2.0.2 (2024-07-12)",charIndex:4350},{level:3,title:"Bug Fixes",slug:"bug-fixes-3",normalizedTitle:"bug fixes",charIndex:709},{level:2,title:"2.0.1 (2024-07-11)",slug:"_2-0-1-2024-07-11",normalizedTitle:"2.0.1 (2024-07-11)",charIndex:4469},{level:3,title:"Bug Fixes",slug:"bug-fixes-4",normalizedTitle:"bug fixes",charIndex:709},{level:3,title:"Bug Fixes",slug:"bug-fixes-5",normalizedTitle:"bug fixes",charIndex:709},{level:3,title:"Features",slug:"features-3",normalizedTitle:"features",charIndex:1399},{level:3,title:"BREAKING CHANGES",slug:"breaking-changes",normalizedTitle:"breaking changes",charIndex:5126},{level:2,title:"1.2.2 (2024-07-11)",slug:"_1-2-2-2024-07-11",normalizedTitle:"1.2.2 (2024-07-11)",charIndex:5614},{level:3,title:"Bug Fixes",slug:"bug-fixes-6",normalizedTitle:"bug fixes",charIndex:709},{level:2,title:"1.2.1 (2024-07-04)",slug:"_1-2-1-2024-07-04",normalizedTitle:"1.2.1 (2024-07-04)",charIndex:5714},{level:3,title:"Bug Fixes",slug:"bug-fixes-7",normalizedTitle:"bug fixes",charIndex:709},{level:2,title:"1.2.0 (2024-07-03)",slug:"_1-2-0-2024-07-03",normalizedTitle:"1.2.0 (2024-07-03)",charIndex:5807},{level:3,title:"Bug Fixes",slug:"bug-fixes-8",normalizedTitle:"bug fixes",charIndex:709},{level:3,title:"Features",slug:"features-4",normalizedTitle:"features",charIndex:1399},{level:2,title:"1.1.1 (2024-06-06)",slug:"_1-1-1-2024-06-06",normalizedTitle:"1.1.1 (2024-06-06)",charIndex:8999},{level:3,title:"Bug Fixes",slug:"bug-fixes-9",normalizedTitle:"bug fixes",charIndex:709},{level:2,title:"1.1.0 (2024-06-03)",slug:"_1-1-0-2024-06-03",normalizedTitle:"1.1.0 (2024-06-03)",charIndex:9110},{level:3,title:"Bug Fixes",slug:"bug-fixes-10",normalizedTitle:"bug fixes",charIndex:709},{level:3,title:"Features",slug:"features-5",normalizedTitle:"features",charIndex:1399},{level:2,title:"1.0.8 (2024-05-29)",slug:"_1-0-8-2024-05-29",normalizedTitle:"1.0.8 (2024-05-29)",charIndex:10302},{level:3,title:"Bug Fixes",slug:"bug-fixes-11",normalizedTitle:"bug fixes",charIndex:709},{level:2,title:"1.0.7 (2024-05-23)",slug:"_1-0-7-2024-05-23",normalizedTitle:"1.0.7 (2024-05-23)",charIndex:10803},{level:3,title:"Bug Fixes",slug:"bug-fixes-12",normalizedTitle:"bug fixes",charIndex:709},{level:2,title:"1.0.6 (2024-05-07)",slug:"_1-0-6-2024-05-07",normalizedTitle:"1.0.6 (2024-05-07)",charIndex:11630},{level:3,title:"Bug Fixes",slug:"bug-fixes-13",normalizedTitle:"bug fixes",charIndex:709},{level:2,title:"1.0.5 (2024-05-02)",slug:"_1-0-5-2024-05-02",normalizedTitle:"1.0.5 (2024-05-02)",charIndex:11745},{level:3,title:"Bug Fixes",slug:"bug-fixes-14",normalizedTitle:"bug fixes",charIndex:709},{level:2,title:"1.0.4 (2024-04-30)",slug:"_1-0-4-2024-04-30",normalizedTitle:"1.0.4 (2024-04-30)",charIndex:12158},{level:3,title:"Bug Fixes",slug:"bug-fixes-15",normalizedTitle:"bug fixes",charIndex:709},{level:2,title:"1.0.3 (2024-04-26)",slug:"_1-0-3-2024-04-26",normalizedTitle:"1.0.3 (2024-04-26)",charIndex:12265},{level:3,title:"Bug Fixes",slug:"bug-fixes-16",normalizedTitle:"bug fixes",charIndex:709},{level:2,title:"1.0.2 (2024-04-25)",slug:"_1-0-2-2024-04-25",normalizedTitle:"1.0.2 (2024-04-25)",charIndex:12354},{level:3,title:"Bug Fixes",slug:"bug-fixes-17",normalizedTitle:"bug fixes",charIndex:709},{level:2,title:"1.0.1 (2024-04-23)",slug:"_1-0-1-2024-04-23",normalizedTitle:"1.0.1 (2024-04-23)",charIndex:12976},{level:3,title:"Bug Fixes",slug:"bug-fixes-18",normalizedTitle:"bug fixes",charIndex:709},{level:2,title:"1.0.0 (2024-04-23)",slug:"_1-0-0-2024-04-23",normalizedTitle:"1.0.0 (2024-04-23)",charIndex:13094},{level:3,title:"Bug Fixes",slug:"bug-fixes-19",normalizedTitle:"bug fixes",charIndex:709},{level:3,title:"Features",slug:"features-6",normalizedTitle:"features",charIndex:1399}],headersStr:"Overview 2.2.0 (2024-08-30) Bug Fixes Features 2.1.0 (2024-08-07) Bug Fixes Features 2.0.2 (2024-07-12) Bug Fixes 2.0.1 (2024-07-11) Bug Fixes Bug Fixes Features BREAKING CHANGES 1.2.2 (2024-07-11) Bug Fixes 1.2.1 (2024-07-04) Bug Fixes 1.2.0 (2024-07-03) Bug Fixes Features 1.1.1 (2024-06-06) Bug Fixes 1.1.0 (2024-06-03) Bug Fixes Features 1.0.8 (2024-05-29) Bug Fixes 1.0.7 (2024-05-23) Bug Fixes 1.0.6 (2024-05-07) Bug Fixes 1.0.5 (2024-05-02) Bug Fixes 1.0.4 (2024-04-30) Bug Fixes 1.0.3 (2024-04-26) Bug Fixes 1.0.2 (2024-04-25) Bug Fixes 1.0.1 (2024-04-23) Bug Fixes 1.0.0 (2024-04-23) Bug Fixes Features",content:"# ar.io SDK Changelog\n\n\n# Overview\n\nWelcome to the documentation page for the ar.io SDK release notes. Here, you will find detailed information about each version of the ar.io SDK, including the enhancements, bug fixes, and any other changes introduced in every release. This page serves as a comprehensive resource to keep you informed about the latest developments and updates in the ar.io SDK. For those interested in exploring the source code, each release's code is readily accessible at our GitHub repository: ar.io SDK change logs. Stay updated with the continuous improvements and advancements in the ar.io SDK by referring to this page for all release-related information.\n\n\n# 2.2.0 (2024-08-30)\n\n\n# Bug Fixes\n\n * logger: permit logger as argument for typeguard util and default it (45df626)\n * register: update spawn ant to register at end of spawn (4320c80)\n * signer: add typeguard util for aoSigner (0d7f210)\n * signing: add aosigner to contract signer (3b0495a)\n * tests: dont send messages to ao in e2e tests (e7108da)\n * tests: reconfigure test structure (1872a26)\n * tests: use test-wallet fixture in tests instead of generating anew each time (27a5dc2)\n * typeguard: return true or false in typeguard and log the error (4b851c5)\n * types: update types for epoch distributions (5aedf50)\n * util: use ANTRegistry class for registering ant on spawn instead of aoconnect (350112d)\n\n\n# Features\n\n * ant id: update lua ant id to latest (968c30e)\n * util: add AoAntState typeguard util (c6f457f)\n\n\n# 2.1.0 (2024-08-07)\n\n\n# Bug Fixes\n\n * actions: ignore engines in action (7f6f87d)\n * ant lua id: update to version Flwio4Lr08g6s6uim6lEJNnVGD9ylvz0_aafvpiL8FI (8cbd564)\n * ant: remove data from ant object, none of our ant methods require data attributes (0f267c1)\n * ao: update AoProcess to only support string | undefined (584aee1)\n * arns: update event emitter to provide more events and logs while loading arns records (8775896)\n * constants: do not set env var for ant registry (9e61cc7)\n * deps: move arconnect to dev deps (34f07d2)\n * emiter: use a set to filter out duplicate (7887af9)\n * emitter: add page size param for emitter to increase amount of records per page to 50k (b6f2157)\n * errors: use any type on error (f14ed5a)\n * events: use arns name space for events (1d67dfe)\n * evolve: call eval twice to ensure evolve txid is set (a6261e5)\n * evolve: dont double eval (a2a9121)\n * evolve: fixed evolve somehow (b06503b)\n * example: dont spawn in example (d1d5147)\n * example: remove unused arweave instance (d0035c0)\n * format: fix linting issues in format (b72dc1f)\n * gateway stats: update gateway stat types (a59b166)\n * io: add api that returns the total token supply (261c85c)\n * io: no longer add data to save observations (c017b52)\n * lint: fix lint errors and warnings (e532f4e)\n * lua id: set new lua id in constants (e4c3aaf)\n * naming: name AoSigner property aoSigner (4604524)\n * records: update arns emitter to use ant registry (e55a67b)\n * signer: describe signing function as signer vs aoSigner in case of signer type changes (3b23f80)\n * signer: move createAoSigner to be a util (7f7a0e6)\n * signer: pass in signing function instead of signer class (cba16e3)\n * signer: use AoSigner type as return type (8e95edd)\n * spawn: update spawn to use ant registry id in the tags (28dae7f)\n * tests: check the return of ACL on ant tests more granularly (350bab1)\n * tests: update e2e tests to only read from ant registry (a61e0bf)\n * tests: update web test to use ANT registry in app (38ca913)\n * tests: use const for unchanging test vars (9f965e1)\n * test: update browser test with data test id and render checks (93741cb)\n * test: use a known wallet adddress in tests (9dac280)\n * todo: remove completed todo comment (c868522)\n * types: add gateway weights to AoGateway (e725198)\n * types: check info on evolve util first (a44cca1)\n * types: remove deprecated types (c674876)\n * types: update AoGateway to include weights (5368668)\n * types: update type name to what contract returns (99edbad)\n * use custom event names to avoid overlap (5b919ac)\n * utils: revert new util (c959c81)\n * utils: update util to use ant registry (b2223d4)\n\n\n# Features\n\n * ant registry: add ant registry class (2056674)\n * evolve: add evolve util (47bfe20)\n * signing: add window arweave wallet to available signing options (7596aec)\n\n\n# 2.0.2 (2024-07-12)\n\n\n# Bug Fixes\n\n * types: update gateway settings type to only support observerAddress (13e073b)\n\n\n# 2.0.1 (2024-07-11)\n\n\n# Bug Fixes\n\n * logger: fixes the console logger to respect the log level provided by web clients (99d7993)\n\n\n# 2.0.0 (2024-07-11)\n\n\n# Bug Fixes\n\n * arweave: use default arweave in IO (21d25b9)\n * deps: replace bunyan or console depending on the client environment (9d940aa)\n * log: allow log level configuration for clients (9cb0981)\n * log: replace bunyan with winston to ensure browser compatibility (80b38e0)\n\n\n# Features\n\n * io: add paginated gateway support for larger state objects (e.g. balances, records, and gateways) (b23efa8)\n * util: add utility for fetching all records (8df2aac)\n * io: add leaveNetwork API (54222ce)\n\n\n# BREAKING CHANGES\n\n * deps: removes all smartweave implementations using warp-sdk. The result is an only AO compatible ANT and IO network contracts. Some utilities are preserved due to their usefulness.\n * imports: modifies web named exports to provide esm and cjs exports instead of minified bundle. The web bundle was causing issues in bundled projects, and polyfills are no longer provided by default. Refer to the README for specifications on how to use the SDK for a web project.\n\n\n# 1.2.2 (2024-07-11)\n\n\n# Bug Fixes\n\n * api: ensure timestamps are always in miliseconds (93b162f)\n\n\n# 1.2.1 (2024-07-04)\n\n\n# Bug Fixes\n\n * io: default the IO process to use testnet (61bca5c)\n\n\n# 1.2.0 (2024-07-03)\n\n\n# Bug Fixes\n\n * ant: add event emitter util for fetching ants (ee5287b)\n * ant: fix read api and update types (977e0e3)\n * ant: handle when no data is returned (1de6610)\n * ants: separate out interfaces (60fd593)\n * ant: update apis to implement interface (9c54db0)\n * ant: update interface to expect undername instead of name for ant records (416cb3d)\n * ao ant: add handler for get state (fd20aa7)\n * ao reads: safely parse json (1ff5410)\n * ao: add AR-IO-SDK tag to process interaction (e5b5603)\n * ao: add default timestamp to getTokenCost (36fed1b)\n * ao: add getPrescribedNames for epoch api (747fad2)\n * ao: add retries to read interactions (67d59e2)\n * ao: fix tag for join network, update observation response (556f5d5)\n * ao: prune tags on joinNetwork (31978f9)\n * ao read: fix interface to have ant getState api (4e95bbd)\n * aos: update aos module id and lua id (e19139e)\n * ao: support connection config params in AO (3e6a246)\n * ao: support tags for all write interactions (67f8da9)\n * ao: update APIs for ao interface to be more descriptive (f07ac36)\n * ao: update epoch interfaces to support various inputs (ddc4c10)\n * ao: update send on process to use proper signer and evalute result (4e2f65d)\n * ao: update stake interface (427e8ba)\n * ao: use types and connect config in ao process to wrap connect from ao (05b07cf)\n * buy: require processId on buyRecord (cc5859f)\n * deps: add eventemitter3 dep (1d50cd1)\n * deps: use p-limit-lit to avoid jest issues (05e0673)\n * emitter: add a end and some console logs in the example (bc4e6b8)\n * emmiter: rename and move throttle to be variable powered (f9cf40d)\n * epochs: fix epoch default timestamp (ffb9df7)\n * events: return process ids on end of fetching (15e3f44)\n * handlers: update handler names (720b178)\n * io: add buyRecord API (30d5e74)\n * io: add epoch-settings api and tests (56555ea)\n * io: add init to provide custom process (8811016)\n * io: separate out io/ao contract interfaces (d96fa59)\n * io: update arns interactions on registry contract (9befe2a)\n * pLimit: add pLimit for util to avoid ao throttling (5b13560)\n * readds incorrectly removed descriptions (c77217a)\n * revert purchasetype tag (2dc08df)\n * spawn: add option state contractTxID to track where init state is from (1745766)\n * tags: make remaining tags ans-116 compliant (d034c8c)\n * tags: use updated ans-116 tag format for actions (261b788)\n * timeout: increase timeout period on arns emitter (b5ddb5f)\n * type: default to unknown return type for json (0bddce0)\n * types: add ao ant state type (02dbacd)\n * types: update some types for arns names and contract state (2d23241)\n * updates to use IO class and process terminology (ec45d66)\n * util: initial implementation of get ant process for wallet (885fa31)\n\n\n# Features\n\n * ant: add balance APIs to ant interface (ec67440)\n * ant: add utility for fetchint ant modules owned by wallet (01f7ec9)\n * ants: support ANT apis in SDK (b187aeb)\n * ao utils: add spawn ant util (d02566e)\n * ao: experiment with initial implementation of ao contract (6118cea)\n * getInfo io: add getInfo method to io class (4ef25ec)\n * IO: implement io/ao classes that call process apis (aab8967)\n\n\n# 1.1.1 (2024-06-06)\n\n\n# Bug Fixes\n\n * api: default evaluation options on getArNSReservedNames api (0a1f22e)\n\n\n# 1.1.0 (2024-06-03)\n\n\n# Bug Fixes\n\n * api: make evaluation options optional on the interface (9e5a1c0)\n * api: remove unused variable for epochBlockHeight (98c5ebc)\n * arweave: default to arweave.net (84c9653)\n * axios: add back axios-retry (9aae4de)\n * errors: throw AbortError on signal aborted (63bd395)\n * getContracts: only implement util for now (6b29c2f)\n * gql query: don't abstract the data protocol query (f0b8f77)\n * imports: import type from base route warp-contracts (bf99a85)\n * init: allow signer to be undefined and if so return readable (b6a05e2)\n * init: fix type for init to allow undefined signer (0a64ea9)\n * init: remove unnecessary destructuring (81af1af)\n * interface: remove epochBlockHeight from interface (b646f08)\n * types:remove DataItem from WriteInteractionResult (eadb1a1)\n * types: use gql node interface for dataProtocolTransaction (79cebd9)\n * warp: ensure contract init on read interactions (bc3d1b8)\n\n\n# Features\n\n * getContracts: add get contracts on network specific providers like WarpContract (603d36e)\n * gql util: add smartweave gql utils (5ea3aab)\n * write: add tags support to write interactions on warp-contract and saveObservations (46eb4c9)\n\n\n# 1.0.8 (2024-05-29)\n\n\n# Bug Fixes\n\n * api: add getPriceForInteration api to ario contract (3b8083c)\n * bundle: minify web bundle (9266676)\n * api: use function map for method name (439ec1f)\n * reserved: add reserved arns name get methods (ad203ef)\n * signer: check if method is property of signer before using (c52783c)\n * signer: modify signer to assume the signer type based on public key being undefined (b775c96)\n * test: add dockerfile for running tests in certain node environments (86cf2ad)\n\n\n# 1.0.7 (2024-05-23)\n\n\n# Bug Fixes\n\n * contract: add extendLease and increaseUndernameSupport apis (1b13b5e)\n * types: fix the AtLeastOne type (ffd0869)\n * deps: force arweavve to 1.15.1 (2448598)\n * contract: make params required - properties and note (89db674)\n * types: update tests and use overwrite type to allow mIOtoken for certain paramaters (badcece)\n * api: change to increaseUndernameLimit (9b72c1e)\n * docs: update ario apis (4af0862)\n * tests: update extend test util to include a test domain (e959b7c)\n * token: add mIO and IO token classes to exports (f47f7d5)\n * types: add delegated gateway type (c877496)\n * types: export the token types (dfc83ae)\n * types: remove visible types (6ab1fc3)\n * types: update Gateway delegates type to use the new GatewayDelegate (ac7e924)\n * warp: bump warp version (db7344d)\n\n\n# 1.0.6 (2024-05-07)\n\n\n# Bug Fixes\n\n * warp: bump warp to fix AbortError issue on warp imports for web (c9a5613)\n\n\n# 1.0.5 (2024-05-02)\n\n\n# Bug Fixes\n\n * cjs: provide path alias for warp in cjs export (7f9bf9a)\n * logger: replace winston with bunyan (0488f75)\n * util: add FQDN regex that matches ArNS contract (e6d7396)\n * utils: manally conver from b64 to b64url to avoid web polyfill issues (766035c)\n * utils: use base64 for fromB64url util (42302ef)\n * warp-contract: correctly throw error in write interaction (c2368dd)\n\n\n# 1.0.4 (2024-04-30)\n\n\n# Bug Fixes\n\n * ario: update joinNetwork to accept observerWallet param (6a32dd1)\n\n\n# 1.0.3 (2024-04-26)\n\n\n# Bug Fixes\n\n * signer: set owner before signing data (0b558f5)\n\n\n# 1.0.2 (2024-04-25)\n\n\n# Bug Fixes\n\n * arweave: default to the arweave node import to avoid issues with browser environments (fc8c26e)\n * cacheurl: use default cache url in warpcontract (a676a3c)\n * init: cleanup init overload methods and tests (fa328d2)\n * lint: address lint issue in ArIOWriteable (4a3ee89)\n * tsconfig: modify some tsconfig settings to get isolated configs for web/cjs/esm (46b7acc)\n * typeguards: make type guards accept unknowns (7f285bb)\n * types: use generic types and modify the requirements for init functions (9350f78)\n * utils: add writeInteraction types and update base64url logic (4f5476b)\n\n\n# 1.0.1 (2024-04-23)\n\n\n# Bug Fixes\n\n * docs: improve README docs interface documentation for ArIO clients (b0da48c)\n\n\n# 1.0.0 (2024-04-23)\n\n\n# Bug Fixes\n\n * actions: bump node setup action (4eb49cd)\n * actions: freeze lockfile (dba7313)\n * contractadd cache config in ario constructor (1f3c0ba)\n * ant: add ant contract to exports (a2ff57b)\n * ant: add signer to ant test (4581b8d)\n * ant: default evaluation options for ant apis that do not take an… (#25) (0c8b55d)\n * ant: default evaluation options for ant apis that do not take another parameter (7c59033)\n * ant: default evaluation options for apis that do not require them (72b57d5)\n * ant: fix API for getRecords (c714aa3)\n * apis: remove epoch from distributions and observations (7b2d279)\n * arbundle version: pin version (35ffab6)\n * arbundles: update arbundles import (f02d83f)\n * ario: add cache config in ario constructor (#11) (ecb279d)\n * ario: formatting (c61570a)\n * ario: make state provider nullable and default to remote arns-service provider (fa1cb72)\n * ario: re-add contract default config (2296cc3)\n * ario: remove unused cache property (7f2d02e)\n * build: add setImmediate polyfill for web only (ad36776)\n * build: remove redundant exported type (134319b)\n * cache: remove cache folder (2ac9427)\n * cacheURL: update ario cache url setting pattern to use custom url appropriately (c76e67d)\n * cache: validate arweave id before setting it (5ba1175)\n * casing: revert to lower case casing (b5da0ab)\n * comments: make class logger private, remove comments (7483246)\n * connect: add init static function on ario class to create interaction classes (765f39c)\n * contract configuration: return cache url as well (b4a7bc3)\n * contract functions: correct contract function names (ad9bc56)\n * contracts: add configuration view method and update types (4fae4a2)\n * contracts: remove write method and type from remote contract (740d8b8)\n * contracttxid: make contractTxID require in remote state cache instance (dc82d21)\n * contracttxid: make contractTxID required in remote state cache instance (#10) (bf651bb)\n * ctrl flow: remove else from control flow (4b3c4c2)\n * deps: pin arweave (d39391c)\n * deps: remove axios-retry, will implement later (0218e95)\n * deps: remove extra crypto-browserify (9b42898)\n * deps: remove warp-contracts-deploy from deps (9d4f9fa)\n * docs: remove docs folder (47e8403)\n * drywrite: throw on bad drywrite and continue if successful (5052c0a)\n * eslintignore: remove old file names (415c163)\n * eslint: remove eslint comments and use this signer (32530eb)\n * esm: add polyfills for crypto (dd8fbfe)\n * esm: add polyfills for crypto (#27) (553822c)\n * example web: update ario instatiation (77c6842)\n * example: escape quotes in packagejson for example package json (fb47de0)\n * example: simplify example and remove unused method on remote cache (81637f8)\n * examples: update comments and fix package.json (db7140b)\n * examples: update examples to use devnet (cc037ac)\n * examples: update examples with records methods, and balance methods (a2d2a02)\n * exports: add arweavesigner and arconnectsigner to exports, clean up docs (c7860ed)\n * exports: update exports in indices (f794437)\n * exports: update package exports to have index in src folder (2cce9e3)\n * files: clean git cache of duplicate casing (e9eaa2d)\n * filters: punt filters (1c23cb3)\n * fixture: add type to arns state fixture (5bcac32)\n * formating: format (3f30f77)\n * gar write: fix types and flow on gar write (f5e7774)\n * gateway: update gateway settings to support autostake (82c6840)\n * generics: use named generic (4b647f0)\n * gitignore: remove cache from gitignore (2867abc)\n * git: test fix with file casing issue (c3611ee)\n * headers: use source-version for header (2b26d88)\n * http: add headers sdk headers to http config (94810ed)\n * husky: add commit hooks (885ce68)\n * imports: update to use indexed imports from warp (1242568)\n * indentation: fix indentation in examples (a266731)\n * interface: removed filters and added base records types (849834d)\n * interface: rename interface to ContractCache (2a0a765)\n * jest: remove extra config (014fbde)\n * lint: disable no-any warning certain types (de5f108)\n * lint: formatting (21224e2)\n * logger, errors, http: Updated to axios and axios-retry, added winston logger, more extensive custom error objects (b944f4d)\n * logger: remove unused logger property (9501d1d)\n * logs: removing debug logs (f025171)\n * mixin: filter private methods in mixin util (beb8610)\n * naming: change epoch to epochStartHeight (908971c)\n * naming: rename getRecord[s] to getArNSRecord[s] (bd3d4bc)\n * overloads: only accept warp contract as a contract config for ariowritable (e3c97e9)\n * polyfills: rollback polyfill on logger (0cdb2f0)\n * postinstall: remove husky postinstall script (c74a135)\n * readme: add grammar and example recs (ecc07f7)\n * readme: condense quick start (b35e5bd)\n * readme: refactor api list to header tags (817d99b)\n * readme: update ant header (77235ce)\n * readme: update ANT usage description (70c8520)\n * readme: update joinNetwork docs (9fcf440)\n * readme: update quick start (a60d96a)\n * readme: update readme with default provider example (68a5a16)\n * readme: update readme with examples (d9ee23e)\n * record records: update key to use result instead of record (90314db)\n * records: remove contractTxId filter remove lodash shrink readme (50669e1)\n * records: use state endpoint to fetch records (2f02c53)\n * recs: modify the interfaces for contracts and implement with warp and remote service (#13) (56ebb08)\n * release: remove release assets entirely (9d5a1b3)\n * release: update github release config to publish packages to github (5534d9d)\n * remote: getState not properly setting evalTo in http requests (55745c1)\n * safety: update type safety checks (32eebbc)\n * setimmediate: make set immediate a build dependency as it is required by the node winston (9292eaa)\n * signer: check that contract is connected before trying to write (d352e9c)\n * signer: check that contract is connected before trying to write (#29) (536a116)\n * signer: fix signer in WarpContracts - update tests (ea9448f)\n * signer: fix signer in WarpContracts - update tests (#32) (16d69d8)\n * signer: remove jwk use, ignore web example for now (bc7e577)\n * signer: remove signer, will do in other pr (d02276d)\n * signer: remove use of JWK, simplify constructor (#22) (d2ef573)\n * signer: update ANT to have signer (c7f8eee)\n * structure: update cache provider folder to be named caches (844c1aa)\n * structure: use snake case for file and folder names (37f27d3)\n * test warp-contract: use beforeAll to read env vars (95cc019)\n * tests: add test cases as a const (8458185)\n * tests: add test for custom arIO client config (0e6142b)\n * tests: change control flow pattern to .catch instead of trycatch (883de51)\n * tests: dont make blockHeight or sortKey undefined but rather evalTo (f76a201)\n * tests: instantiate new ant to connect in tests (9869415)\n * tests: remove dryWrite from writeInteraction, update tests (bc1becc)\n * tests: remove fixture and use live service for tests (30d3e8c)\n * tests: test 404 response (590dea6)\n * tests: update ario test (4208bd0)\n * tests: update client instantiation test to check read vs write clients (059653c)\n * tests: update docker compose params (a71befd)\n * tests: update gateways test (1fcb3e6)\n * tests: update stubs in tests (e4bbc6e)\n * tests: update test to match jest syntax (553bdbb)\n * tests: update tests for named prop expectation (4ea04a7)\n * tests: update tests to use younger contract, add evalParams config (ae890c8)\n * tests: update tests with constants and update types (1bdcfeb)\n * tests: update tests with new name (2cd1b5c)\n * tests: update with new names on methods (619c193)\n * tests: use angela for testing (10f30fe)\n * tests: use http not https in tests (fddba1e)\n * tests: use process vars as priority url (faab4f3)\n * test: update test to use ArweaveTransactionID class (f6c4f8b)\n * tsconfig, names: reverted tsconfig to nodenext resolution, changed naming convention on provider, removed extraeneous error classes, rolled back axios-retry to match our tsconfig settings (d412d44)\n * tyeps: set types to objects rather than top level params for easier readability (edfd77b)\n * type: rename all type implementations (5959045)\n * types and tests: update evalTo to allow undefined sortKey and block and test that (a59f05c)\n * types: add @ to records (53601c1)\n * types: make props nullable on certain read apis (f8ff552)\n * types: remove any type (5c80242)\n * types: remove any types (d8d910b)\n * types: remove ArweaveTransactionID type for now (3adf53b)\n * types: remove unnecesssary empty defaults (7d14edb)\n * types: rename signer to ContractSigner (87d6c90)\n * types: require atleast one param to update gateway settings (857ebdc)\n * types: update interaction type to only use read for now (2c02e90)\n * types: update tests, readme, and types (e9985dd)\n * types: use partial write type (fa6a638)\n * types: use string instead of any (014a262)\n * validate id: make validator a private method (dce4a94)\n * validity util: isBlockheight check more strict (2b28675)\n * warp contract: added test for getting state after connecting with warp (060ee2c)\n * warp-contract: provide logger - update isTransaction flow ctrl - use typed props (5f6e0a1)\n * warp-contracts: bump warp to 1.4.38 - fixed warp exports (af4a20b)\n * winston: move the winston polyfill - this will prevent any esm based web projects from getting polyfill issues (c8b7998)\n * write: add dry run - sync state - abortSignal - update interface (970bdef)\n * write: update utils - change error flow - update arweave constructor props (0a81c92)\n * write: update write methods on warp (9c0540b)\n * yarn: update lockfile (fd5e0ee)\n\n\n# Features\n\n * ant: add ANT read interface (c941c96)\n * ant: create ant contract class for interacting with ant contracts (6eb7ef5)\n * ants: add readable-writable framework to the ant client and implement write methods (3019f53)\n * ario contract: add distributions and observation apis (21e38d1)\n * arioContract: update ArIO interface and ArIOContract interface (5d87e2e)\n * auctions: add auctions apis (faf08c5)\n * contract: add distribution, observations apis, update readme and examples (0208317)\n * contract: create new contract classes that impelement both warp and remote cache for ant contract and ar-io contracts (855da2d)\n * first issue: setup examples, readme, and initial gateways provider (5a9e232)\n * gar methods: add gar write methods to the ario client (e01b08b)\n * inital providers: scaffold initial providers (4949514)\n * io transfer: add transfer api to ario writable client (0d37623)\n * observerations: add saveObservations write interaction (8dd977c)\n * observers: add API for fetching prescribed observers (a18e130)\n * observers: add API for fetching prescribed observers (#17) (17ce6de)\n * PE-5742: add records api to arns remote cache (#8) (c46cd39)\n * PE-5751: add blockheight and sortkey eval filters (#12) (832a1ad)\n * PE-5758: add signer to ario class (#20) (1b82077)\n * PE-5759: observations and distributions apis (#16) (dded361)\n * PE-5773: add auctions read apis (#18) (e0c6fca)\n * PE-5800: add epoch apis (48ee4ba)\n * PE-5800: epoch apis (#15) (70563b1)\n * PE-5825: ANT read interface (#19) (6a0c477)\n * records: add records api to arns remote cache (1b7f54f)\n * signer: add arweave signer to ario class (7e08097)\n * write: add write interface and base implementation on warp-contract (6dfc969)",normalizedContent:"# ar.io sdk changelog\n\n\n# overview\n\nwelcome to the documentation page for the ar.io sdk release notes. here, you will find detailed information about each version of the ar.io sdk, including the enhancements, bug fixes, and any other changes introduced in every release. this page serves as a comprehensive resource to keep you informed about the latest developments and updates in the ar.io sdk. for those interested in exploring the source code, each release's code is readily accessible at our github repository: ar.io sdk change logs. stay updated with the continuous improvements and advancements in the ar.io sdk by referring to this page for all release-related information.\n\n\n# 2.2.0 (2024-08-30)\n\n\n# bug fixes\n\n * logger: permit logger as argument for typeguard util and default it (45df626)\n * register: update spawn ant to register at end of spawn (4320c80)\n * signer: add typeguard util for aosigner (0d7f210)\n * signing: add aosigner to contract signer (3b0495a)\n * tests: dont send messages to ao in e2e tests (e7108da)\n * tests: reconfigure test structure (1872a26)\n * tests: use test-wallet fixture in tests instead of generating anew each time (27a5dc2)\n * typeguard: return true or false in typeguard and log the error (4b851c5)\n * types: update types for epoch distributions (5aedf50)\n * util: use antregistry class for registering ant on spawn instead of aoconnect (350112d)\n\n\n# features\n\n * ant id: update lua ant id to latest (968c30e)\n * util: add aoantstate typeguard util (c6f457f)\n\n\n# 2.1.0 (2024-08-07)\n\n\n# bug fixes\n\n * actions: ignore engines in action (7f6f87d)\n * ant lua id: update to version flwio4lr08g6s6uim6lejnnvgd9ylvz0_aafvpil8fi (8cbd564)\n * ant: remove data from ant object, none of our ant methods require data attributes (0f267c1)\n * ao: update aoprocess to only support string | undefined (584aee1)\n * arns: update event emitter to provide more events and logs while loading arns records (8775896)\n * constants: do not set env var for ant registry (9e61cc7)\n * deps: move arconnect to dev deps (34f07d2)\n * emiter: use a set to filter out duplicate (7887af9)\n * emitter: add page size param for emitter to increase amount of records per page to 50k (b6f2157)\n * errors: use any type on error (f14ed5a)\n * events: use arns name space for events (1d67dfe)\n * evolve: call eval twice to ensure evolve txid is set (a6261e5)\n * evolve: dont double eval (a2a9121)\n * evolve: fixed evolve somehow (b06503b)\n * example: dont spawn in example (d1d5147)\n * example: remove unused arweave instance (d0035c0)\n * format: fix linting issues in format (b72dc1f)\n * gateway stats: update gateway stat types (a59b166)\n * io: add api that returns the total token supply (261c85c)\n * io: no longer add data to save observations (c017b52)\n * lint: fix lint errors and warnings (e532f4e)\n * lua id: set new lua id in constants (e4c3aaf)\n * naming: name aosigner property aosigner (4604524)\n * records: update arns emitter to use ant registry (e55a67b)\n * signer: describe signing function as signer vs aosigner in case of signer type changes (3b23f80)\n * signer: move createaosigner to be a util (7f7a0e6)\n * signer: pass in signing function instead of signer class (cba16e3)\n * signer: use aosigner type as return type (8e95edd)\n * spawn: update spawn to use ant registry id in the tags (28dae7f)\n * tests: check the return of acl on ant tests more granularly (350bab1)\n * tests: update e2e tests to only read from ant registry (a61e0bf)\n * tests: update web test to use ant registry in app (38ca913)\n * tests: use const for unchanging test vars (9f965e1)\n * test: update browser test with data test id and render checks (93741cb)\n * test: use a known wallet adddress in tests (9dac280)\n * todo: remove completed todo comment (c868522)\n * types: add gateway weights to aogateway (e725198)\n * types: check info on evolve util first (a44cca1)\n * types: remove deprecated types (c674876)\n * types: update aogateway to include weights (5368668)\n * types: update type name to what contract returns (99edbad)\n * use custom event names to avoid overlap (5b919ac)\n * utils: revert new util (c959c81)\n * utils: update util to use ant registry (b2223d4)\n\n\n# features\n\n * ant registry: add ant registry class (2056674)\n * evolve: add evolve util (47bfe20)\n * signing: add window arweave wallet to available signing options (7596aec)\n\n\n# 2.0.2 (2024-07-12)\n\n\n# bug fixes\n\n * types: update gateway settings type to only support observeraddress (13e073b)\n\n\n# 2.0.1 (2024-07-11)\n\n\n# bug fixes\n\n * logger: fixes the console logger to respect the log level provided by web clients (99d7993)\n\n\n# 2.0.0 (2024-07-11)\n\n\n# bug fixes\n\n * arweave: use default arweave in io (21d25b9)\n * deps: replace bunyan or console depending on the client environment (9d940aa)\n * log: allow log level configuration for clients (9cb0981)\n * log: replace bunyan with winston to ensure browser compatibility (80b38e0)\n\n\n# features\n\n * io: add paginated gateway support for larger state objects (e.g. balances, records, and gateways) (b23efa8)\n * util: add utility for fetching all records (8df2aac)\n * io: add leavenetwork api (54222ce)\n\n\n# breaking changes\n\n * deps: removes all smartweave implementations using warp-sdk. the result is an only ao compatible ant and io network contracts. some utilities are preserved due to their usefulness.\n * imports: modifies web named exports to provide esm and cjs exports instead of minified bundle. the web bundle was causing issues in bundled projects, and polyfills are no longer provided by default. refer to the readme for specifications on how to use the sdk for a web project.\n\n\n# 1.2.2 (2024-07-11)\n\n\n# bug fixes\n\n * api: ensure timestamps are always in miliseconds (93b162f)\n\n\n# 1.2.1 (2024-07-04)\n\n\n# bug fixes\n\n * io: default the io process to use testnet (61bca5c)\n\n\n# 1.2.0 (2024-07-03)\n\n\n# bug fixes\n\n * ant: add event emitter util for fetching ants (ee5287b)\n * ant: fix read api and update types (977e0e3)\n * ant: handle when no data is returned (1de6610)\n * ants: separate out interfaces (60fd593)\n * ant: update apis to implement interface (9c54db0)\n * ant: update interface to expect undername instead of name for ant records (416cb3d)\n * ao ant: add handler for get state (fd20aa7)\n * ao reads: safely parse json (1ff5410)\n * ao: add ar-io-sdk tag to process interaction (e5b5603)\n * ao: add default timestamp to gettokencost (36fed1b)\n * ao: add getprescribednames for epoch api (747fad2)\n * ao: add retries to read interactions (67d59e2)\n * ao: fix tag for join network, update observation response (556f5d5)\n * ao: prune tags on joinnetwork (31978f9)\n * ao read: fix interface to have ant getstate api (4e95bbd)\n * aos: update aos module id and lua id (e19139e)\n * ao: support connection config params in ao (3e6a246)\n * ao: support tags for all write interactions (67f8da9)\n * ao: update apis for ao interface to be more descriptive (f07ac36)\n * ao: update epoch interfaces to support various inputs (ddc4c10)\n * ao: update send on process to use proper signer and evalute result (4e2f65d)\n * ao: update stake interface (427e8ba)\n * ao: use types and connect config in ao process to wrap connect from ao (05b07cf)\n * buy: require processid on buyrecord (cc5859f)\n * deps: add eventemitter3 dep (1d50cd1)\n * deps: use p-limit-lit to avoid jest issues (05e0673)\n * emitter: add a end and some console logs in the example (bc4e6b8)\n * emmiter: rename and move throttle to be variable powered (f9cf40d)\n * epochs: fix epoch default timestamp (ffb9df7)\n * events: return process ids on end of fetching (15e3f44)\n * handlers: update handler names (720b178)\n * io: add buyrecord api (30d5e74)\n * io: add epoch-settings api and tests (56555ea)\n * io: add init to provide custom process (8811016)\n * io: separate out io/ao contract interfaces (d96fa59)\n * io: update arns interactions on registry contract (9befe2a)\n * plimit: add plimit for util to avoid ao throttling (5b13560)\n * readds incorrectly removed descriptions (c77217a)\n * revert purchasetype tag (2dc08df)\n * spawn: add option state contracttxid to track where init state is from (1745766)\n * tags: make remaining tags ans-116 compliant (d034c8c)\n * tags: use updated ans-116 tag format for actions (261b788)\n * timeout: increase timeout period on arns emitter (b5ddb5f)\n * type: default to unknown return type for json (0bddce0)\n * types: add ao ant state type (02dbacd)\n * types: update some types for arns names and contract state (2d23241)\n * updates to use io class and process terminology (ec45d66)\n * util: initial implementation of get ant process for wallet (885fa31)\n\n\n# features\n\n * ant: add balance apis to ant interface (ec67440)\n * ant: add utility for fetchint ant modules owned by wallet (01f7ec9)\n * ants: support ant apis in sdk (b187aeb)\n * ao utils: add spawn ant util (d02566e)\n * ao: experiment with initial implementation of ao contract (6118cea)\n * getinfo io: add getinfo method to io class (4ef25ec)\n * io: implement io/ao classes that call process apis (aab8967)\n\n\n# 1.1.1 (2024-06-06)\n\n\n# bug fixes\n\n * api: default evaluation options on getarnsreservednames api (0a1f22e)\n\n\n# 1.1.0 (2024-06-03)\n\n\n# bug fixes\n\n * api: make evaluation options optional on the interface (9e5a1c0)\n * api: remove unused variable for epochblockheight (98c5ebc)\n * arweave: default to arweave.net (84c9653)\n * axios: add back axios-retry (9aae4de)\n * errors: throw aborterror on signal aborted (63bd395)\n * getcontracts: only implement util for now (6b29c2f)\n * gql query: don't abstract the data protocol query (f0b8f77)\n * imports: import type from base route warp-contracts (bf99a85)\n * init: allow signer to be undefined and if so return readable (b6a05e2)\n * init: fix type for init to allow undefined signer (0a64ea9)\n * init: remove unnecessary destructuring (81af1af)\n * interface: remove epochblockheight from interface (b646f08)\n * types:remove dataitem from writeinteractionresult (eadb1a1)\n * types: use gql node interface for dataprotocoltransaction (79cebd9)\n * warp: ensure contract init on read interactions (bc3d1b8)\n\n\n# features\n\n * getcontracts: add get contracts on network specific providers like warpcontract (603d36e)\n * gql util: add smartweave gql utils (5ea3aab)\n * write: add tags support to write interactions on warp-contract and saveobservations (46eb4c9)\n\n\n# 1.0.8 (2024-05-29)\n\n\n# bug fixes\n\n * api: add getpriceforinteration api to ario contract (3b8083c)\n * bundle: minify web bundle (9266676)\n * api: use function map for method name (439ec1f)\n * reserved: add reserved arns name get methods (ad203ef)\n * signer: check if method is property of signer before using (c52783c)\n * signer: modify signer to assume the signer type based on public key being undefined (b775c96)\n * test: add dockerfile for running tests in certain node environments (86cf2ad)\n\n\n# 1.0.7 (2024-05-23)\n\n\n# bug fixes\n\n * contract: add extendlease and increaseundernamesupport apis (1b13b5e)\n * types: fix the atleastone type (ffd0869)\n * deps: force arweavve to 1.15.1 (2448598)\n * contract: make params required - properties and note (89db674)\n * types: update tests and use overwrite type to allow miotoken for certain paramaters (badcece)\n * api: change to increaseundernamelimit (9b72c1e)\n * docs: update ario apis (4af0862)\n * tests: update extend test util to include a test domain (e959b7c)\n * token: add mio and io token classes to exports (f47f7d5)\n * types: add delegated gateway type (c877496)\n * types: export the token types (dfc83ae)\n * types: remove visible types (6ab1fc3)\n * types: update gateway delegates type to use the new gatewaydelegate (ac7e924)\n * warp: bump warp version (db7344d)\n\n\n# 1.0.6 (2024-05-07)\n\n\n# bug fixes\n\n * warp: bump warp to fix aborterror issue on warp imports for web (c9a5613)\n\n\n# 1.0.5 (2024-05-02)\n\n\n# bug fixes\n\n * cjs: provide path alias for warp in cjs export (7f9bf9a)\n * logger: replace winston with bunyan (0488f75)\n * util: add fqdn regex that matches arns contract (e6d7396)\n * utils: manally conver from b64 to b64url to avoid web polyfill issues (766035c)\n * utils: use base64 for fromb64url util (42302ef)\n * warp-contract: correctly throw error in write interaction (c2368dd)\n\n\n# 1.0.4 (2024-04-30)\n\n\n# bug fixes\n\n * ario: update joinnetwork to accept observerwallet param (6a32dd1)\n\n\n# 1.0.3 (2024-04-26)\n\n\n# bug fixes\n\n * signer: set owner before signing data (0b558f5)\n\n\n# 1.0.2 (2024-04-25)\n\n\n# bug fixes\n\n * arweave: default to the arweave node import to avoid issues with browser environments (fc8c26e)\n * cacheurl: use default cache url in warpcontract (a676a3c)\n * init: cleanup init overload methods and tests (fa328d2)\n * lint: address lint issue in ariowriteable (4a3ee89)\n * tsconfig: modify some tsconfig settings to get isolated configs for web/cjs/esm (46b7acc)\n * typeguards: make type guards accept unknowns (7f285bb)\n * types: use generic types and modify the requirements for init functions (9350f78)\n * utils: add writeinteraction types and update base64url logic (4f5476b)\n\n\n# 1.0.1 (2024-04-23)\n\n\n# bug fixes\n\n * docs: improve readme docs interface documentation for ario clients (b0da48c)\n\n\n# 1.0.0 (2024-04-23)\n\n\n# bug fixes\n\n * actions: bump node setup action (4eb49cd)\n * actions: freeze lockfile (dba7313)\n * contractadd cache config in ario constructor (1f3c0ba)\n * ant: add ant contract to exports (a2ff57b)\n * ant: add signer to ant test (4581b8d)\n * ant: default evaluation options for ant apis that do not take an… (#25) (0c8b55d)\n * ant: default evaluation options for ant apis that do not take another parameter (7c59033)\n * ant: default evaluation options for apis that do not require them (72b57d5)\n * ant: fix api for getrecords (c714aa3)\n * apis: remove epoch from distributions and observations (7b2d279)\n * arbundle version: pin version (35ffab6)\n * arbundles: update arbundles import (f02d83f)\n * ario: add cache config in ario constructor (#11) (ecb279d)\n * ario: formatting (c61570a)\n * ario: make state provider nullable and default to remote arns-service provider (fa1cb72)\n * ario: re-add contract default config (2296cc3)\n * ario: remove unused cache property (7f2d02e)\n * build: add setimmediate polyfill for web only (ad36776)\n * build: remove redundant exported type (134319b)\n * cache: remove cache folder (2ac9427)\n * cacheurl: update ario cache url setting pattern to use custom url appropriately (c76e67d)\n * cache: validate arweave id before setting it (5ba1175)\n * casing: revert to lower case casing (b5da0ab)\n * comments: make class logger private, remove comments (7483246)\n * connect: add init static function on ario class to create interaction classes (765f39c)\n * contract configuration: return cache url as well (b4a7bc3)\n * contract functions: correct contract function names (ad9bc56)\n * contracts: add configuration view method and update types (4fae4a2)\n * contracts: remove write method and type from remote contract (740d8b8)\n * contracttxid: make contracttxid require in remote state cache instance (dc82d21)\n * contracttxid: make contracttxid required in remote state cache instance (#10) (bf651bb)\n * ctrl flow: remove else from control flow (4b3c4c2)\n * deps: pin arweave (d39391c)\n * deps: remove axios-retry, will implement later (0218e95)\n * deps: remove extra crypto-browserify (9b42898)\n * deps: remove warp-contracts-deploy from deps (9d4f9fa)\n * docs: remove docs folder (47e8403)\n * drywrite: throw on bad drywrite and continue if successful (5052c0a)\n * eslintignore: remove old file names (415c163)\n * eslint: remove eslint comments and use this signer (32530eb)\n * esm: add polyfills for crypto (dd8fbfe)\n * esm: add polyfills for crypto (#27) (553822c)\n * example web: update ario instatiation (77c6842)\n * example: escape quotes in packagejson for example package json (fb47de0)\n * example: simplify example and remove unused method on remote cache (81637f8)\n * examples: update comments and fix package.json (db7140b)\n * examples: update examples to use devnet (cc037ac)\n * examples: update examples with records methods, and balance methods (a2d2a02)\n * exports: add arweavesigner and arconnectsigner to exports, clean up docs (c7860ed)\n * exports: update exports in indices (f794437)\n * exports: update package exports to have index in src folder (2cce9e3)\n * files: clean git cache of duplicate casing (e9eaa2d)\n * filters: punt filters (1c23cb3)\n * fixture: add type to arns state fixture (5bcac32)\n * formating: format (3f30f77)\n * gar write: fix types and flow on gar write (f5e7774)\n * gateway: update gateway settings to support autostake (82c6840)\n * generics: use named generic (4b647f0)\n * gitignore: remove cache from gitignore (2867abc)\n * git: test fix with file casing issue (c3611ee)\n * headers: use source-version for header (2b26d88)\n * http: add headers sdk headers to http config (94810ed)\n * husky: add commit hooks (885ce68)\n * imports: update to use indexed imports from warp (1242568)\n * indentation: fix indentation in examples (a266731)\n * interface: removed filters and added base records types (849834d)\n * interface: rename interface to contractcache (2a0a765)\n * jest: remove extra config (014fbde)\n * lint: disable no-any warning certain types (de5f108)\n * lint: formatting (21224e2)\n * logger, errors, http: updated to axios and axios-retry, added winston logger, more extensive custom error objects (b944f4d)\n * logger: remove unused logger property (9501d1d)\n * logs: removing debug logs (f025171)\n * mixin: filter private methods in mixin util (beb8610)\n * naming: change epoch to epochstartheight (908971c)\n * naming: rename getrecord[s] to getarnsrecord[s] (bd3d4bc)\n * overloads: only accept warp contract as a contract config for ariowritable (e3c97e9)\n * polyfills: rollback polyfill on logger (0cdb2f0)\n * postinstall: remove husky postinstall script (c74a135)\n * readme: add grammar and example recs (ecc07f7)\n * readme: condense quick start (b35e5bd)\n * readme: refactor api list to header tags (817d99b)\n * readme: update ant header (77235ce)\n * readme: update ant usage description (70c8520)\n * readme: update joinnetwork docs (9fcf440)\n * readme: update quick start (a60d96a)\n * readme: update readme with default provider example (68a5a16)\n * readme: update readme with examples (d9ee23e)\n * record records: update key to use result instead of record (90314db)\n * records: remove contracttxid filter remove lodash shrink readme (50669e1)\n * records: use state endpoint to fetch records (2f02c53)\n * recs: modify the interfaces for contracts and implement with warp and remote service (#13) (56ebb08)\n * release: remove release assets entirely (9d5a1b3)\n * release: update github release config to publish packages to github (5534d9d)\n * remote: getstate not properly setting evalto in http requests (55745c1)\n * safety: update type safety checks (32eebbc)\n * setimmediate: make set immediate a build dependency as it is required by the node winston (9292eaa)\n * signer: check that contract is connected before trying to write (d352e9c)\n * signer: check that contract is connected before trying to write (#29) (536a116)\n * signer: fix signer in warpcontracts - update tests (ea9448f)\n * signer: fix signer in warpcontracts - update tests (#32) (16d69d8)\n * signer: remove jwk use, ignore web example for now (bc7e577)\n * signer: remove signer, will do in other pr (d02276d)\n * signer: remove use of jwk, simplify constructor (#22) (d2ef573)\n * signer: update ant to have signer (c7f8eee)\n * structure: update cache provider folder to be named caches (844c1aa)\n * structure: use snake case for file and folder names (37f27d3)\n * test warp-contract: use beforeall to read env vars (95cc019)\n * tests: add test cases as a const (8458185)\n * tests: add test for custom ario client config (0e6142b)\n * tests: change control flow pattern to .catch instead of trycatch (883de51)\n * tests: dont make blockheight or sortkey undefined but rather evalto (f76a201)\n * tests: instantiate new ant to connect in tests (9869415)\n * tests: remove drywrite from writeinteraction, update tests (bc1becc)\n * tests: remove fixture and use live service for tests (30d3e8c)\n * tests: test 404 response (590dea6)\n * tests: update ario test (4208bd0)\n * tests: update client instantiation test to check read vs write clients (059653c)\n * tests: update docker compose params (a71befd)\n * tests: update gateways test (1fcb3e6)\n * tests: update stubs in tests (e4bbc6e)\n * tests: update test to match jest syntax (553bdbb)\n * tests: update tests for named prop expectation (4ea04a7)\n * tests: update tests to use younger contract, add evalparams config (ae890c8)\n * tests: update tests with constants and update types (1bdcfeb)\n * tests: update tests with new name (2cd1b5c)\n * tests: update with new names on methods (619c193)\n * tests: use angela for testing (10f30fe)\n * tests: use http not https in tests (fddba1e)\n * tests: use process vars as priority url (faab4f3)\n * test: update test to use arweavetransactionid class (f6c4f8b)\n * tsconfig, names: reverted tsconfig to nodenext resolution, changed naming convention on provider, removed extraeneous error classes, rolled back axios-retry to match our tsconfig settings (d412d44)\n * tyeps: set types to objects rather than top level params for easier readability (edfd77b)\n * type: rename all type implementations (5959045)\n * types and tests: update evalto to allow undefined sortkey and block and test that (a59f05c)\n * types: add @ to records (53601c1)\n * types: make props nullable on certain read apis (f8ff552)\n * types: remove any type (5c80242)\n * types: remove any types (d8d910b)\n * types: remove arweavetransactionid type for now (3adf53b)\n * types: remove unnecesssary empty defaults (7d14edb)\n * types: rename signer to contractsigner (87d6c90)\n * types: require atleast one param to update gateway settings (857ebdc)\n * types: update interaction type to only use read for now (2c02e90)\n * types: update tests, readme, and types (e9985dd)\n * types: use partial write type (fa6a638)\n * types: use string instead of any (014a262)\n * validate id: make validator a private method (dce4a94)\n * validity util: isblockheight check more strict (2b28675)\n * warp contract: added test for getting state after connecting with warp (060ee2c)\n * warp-contract: provide logger - update istransaction flow ctrl - use typed props (5f6e0a1)\n * warp-contracts: bump warp to 1.4.38 - fixed warp exports (af4a20b)\n * winston: move the winston polyfill - this will prevent any esm based web projects from getting polyfill issues (c8b7998)\n * write: add dry run - sync state - abortsignal - update interface (970bdef)\n * write: update utils - change error flow - update arweave constructor props (0a81c92)\n * write: update write methods on warp (9c0540b)\n * yarn: update lockfile (fd5e0ee)\n\n\n# features\n\n * ant: add ant read interface (c941c96)\n * ant: create ant contract class for interacting with ant contracts (6eb7ef5)\n * ants: add readable-writable framework to the ant client and implement write methods (3019f53)\n * ario contract: add distributions and observation apis (21e38d1)\n * ariocontract: update ario interface and ariocontract interface (5d87e2e)\n * auctions: add auctions apis (faf08c5)\n * contract: add distribution, observations apis, update readme and examples (0208317)\n * contract: create new contract classes that impelement both warp and remote cache for ant contract and ar-io contracts (855da2d)\n * first issue: setup examples, readme, and initial gateways provider (5a9e232)\n * gar methods: add gar write methods to the ario client (e01b08b)\n * inital providers: scaffold initial providers (4949514)\n * io transfer: add transfer api to ario writable client (0d37623)\n * observerations: add saveobservations write interaction (8dd977c)\n * observers: add api for fetching prescribed observers (a18e130)\n * observers: add api for fetching prescribed observers (#17) (17ce6de)\n * pe-5742: add records api to arns remote cache (#8) (c46cd39)\n * pe-5751: add blockheight and sortkey eval filters (#12) (832a1ad)\n * pe-5758: add signer to ario class (#20) (1b82077)\n * pe-5759: observations and distributions apis (#16) (dded361)\n * pe-5773: add auctions read apis (#18) (e0c6fca)\n * pe-5800: add epoch apis (48ee4ba)\n * pe-5800: epoch apis (#15) (70563b1)\n * pe-5825: ant read interface (#19) (6a0c477)\n * records: add records api to arns remote cache (1b7f54f)\n * signer: add arweave signer to ario class (7e08097)\n * write: add write interface and base implementation on warp-contract (6dfc969)",charsets:{cjk:!0}},{title:"ar-io sdk",frontmatter:{prev:!1,next:!1,permalink:"/sdk"},regularPath:"/guides/sdk.html",relativePath:"guides/sdk.md",key:"v-e8e2a6fc",path:"/sdk/",headers:[{level:2,title:"Prerequisites",slug:"prerequisites",normalizedTitle:"prerequisites",charIndex:218},{level:2,title:"Installation",slug:"installation",normalizedTitle:"installation",charIndex:269},{level:2,title:"Quick Start",slug:"quick-start",normalizedTitle:"quick start",charIndex:337},{level:2,title:"Usage",slug:"usage",normalizedTitle:"usage",charIndex:1523},{level:3,title:"Web",slug:"web",normalizedTitle:"web",charIndex:196},{level:2,title:"Typescript",slug:"typescript",normalizedTitle:"typescript",charIndex:2227},{level:2,title:"IOToken & mIOToken",slug:"iotoken-miotoken",normalizedTitle:"iotoken & miotoken",charIndex:null},{level:3,title:"Converting IO to mIO",slug:"converting-io-to-mio",normalizedTitle:"converting io to mio",charIndex:3829},{level:2,title:"IO Process",slug:"io-process",normalizedTitle:"io process",charIndex:4119},{level:3,title:"APIs",slug:"apis",normalizedTitle:"apis",charIndex:4134},{level:3,title:"Configuration",slug:"configuration",normalizedTitle:"configuration",charIndex:21911},{level:2,title:"Arweave Name Tokens (ANT's)",slug:"arweave-name-tokens-ant-s",normalizedTitle:"arweave name tokens (ant's)",charIndex:22584},{level:3,title:"APIs",slug:"apis-2",normalizedTitle:"apis",charIndex:4134},{level:3,title:"Configuration",slug:"configuration-2",normalizedTitle:"configuration",charIndex:21911},{level:2,title:"Logging",slug:"logging",normalizedTitle:"logging",charIndex:28284},{level:3,title:"Configuration",slug:"configuration-3",normalizedTitle:"configuration",charIndex:21911},{level:2,title:"Pagination",slug:"pagination",normalizedTitle:"pagination",charIndex:28840},{level:2,title:"Developers",slug:"developers",normalizedTitle:"developers",charIndex:30161},{level:3,title:"Requirements",slug:"requirements",normalizedTitle:"requirements",charIndex:30176},{level:3,title:"Setup & Build",slug:"setup-build",normalizedTitle:"setup & build",charIndex:null},{level:3,title:"Testing",slug:"testing",normalizedTitle:"testing",charIndex:30413},{level:3,title:"Linting & Formatting",slug:"linting-formatting",normalizedTitle:"linting & formatting",charIndex:null},{level:3,title:"Architecture",slug:"architecture",normalizedTitle:"architecture",charIndex:30869}],headersStr:"Prerequisites Installation Quick Start Usage Web Typescript IOToken & mIOToken Converting IO to mIO IO Process APIs Configuration Arweave Name Tokens (ANT's) APIs Configuration Logging Configuration Pagination Developers Requirements Setup & Build Testing Linting & Formatting Architecture",content:'# ar-io sdk\n\nThe ar.io SDK provides functionality for interacting with the ar.io ecosystem of services (e.g. gateways and observers) and protocols (e.g. ArNS). It is available for both NodeJS and Web environments.\n\n\n# Prerequisites\n\n * node>=v18.0.0\n * npm or yarn\n\n\n# Installation\n\nnpm install @ar.io/sdk\n\n\nor\n\nyarn add @ar.io/sdk\n\n\n\n# Quick Start\n\nLoading the gateway list in NodeJS.\n\nimport { IO } from \'@ar.io/sdk\';\n\nconst io = IO.init();\nconst gateways = await io.getGateways();\n\nconsole.log(gateways);\n\n\nOutput\n\n{\n "QGWqtJdLLgm2ehFWiiPzMaoFLD50CnGuzZIPEdoDRGQ": {\n "end": 0,\n "observerWallet": "IPdwa3Mb_9pDD8c2IaJx6aad51Ss-_TfStVwBuhtXMs",\n "operatorStake": 250000000000, // value in mIO\n "settings": {\n "fqdn": "ar-io.dev",\n "label": "AR.IO Test",\n "note": "Test Gateway operated by PDS for the AR.IO ecosystem.",\n "port": 443,\n "properties": "raJgvbFU-YAnku-WsupIdbTsqqGLQiYpGzoqk9SCVgY",\n "protocol": "https"\n },\n "start": 1256694,\n "stats": {\n "failedConsecutiveEpochs": 0,\n "passedEpochCount": 30,\n "submittedEpochCount": 30,\n "totalEpochParticipationCount": 31,\n "totalEpochsPrescribedCount": 31\n },\n "status": "joined",\n "vaults": {},\n "weights": {\n "stakeWeight": 25,\n "tenureWeight": 0.9031327160493827,\n "gatewayRewardRatioWeight": 0.96875,\n "observerRewardRatioWeight": 0.96875,\n "compositeWeight": 21.189222170982834,\n "normalizedCompositeWeight": 0.27485583057217183\n }\n }\n}\n\n\n\n# Usage\n\nThe SDK is provided in both CommonJS and ESM formats and is compatible with bundlers such as Webpack, Rollup, and ESbuild. Utilize the appropriately named exports provided by this SDK\'s package.json based on your project\'s configuration. Refer to the examples directory to see how to use the SDK in various environments.\n\n\n# Web\n\n# Bundlers (Webpack, Rollup, ESbuild, etc.)\n\nimport { IO } from \'@ar.io/sdk/web\';\n\n// set up client\nconst io = IO.init();\n// fetch gateways\nconst gateways = await io.getGateways();\n\n\nNote: polyfills are only provided when using the named @ar.io/sdk/web export (which requires moduleResolution: nodenext in tsconfig.json). If you are using the default export within a Typescript project (e.g. moduleResolution: node), you will need to provide your own polyfills - specifically crypto, fs and buffer. Refer to examples/webpack and examples/vite for references in how to properly provide those polyfills. For other project configurations, refer to your bundler\'s documentation for more information on how to provide the necessary polyfills.\n\n# Browser\n\n + diff --git a/concepts/sandboxing.html b/concepts/sandboxing.html index a384a4df..4f5c4953 100644 --- a/concepts/sandboxing.html +++ b/concepts/sandboxing.html @@ -20,7 +20,7 @@ - + @@ -34,6 +34,6 @@ console.log(expectedTxSandbox);

Example Output:

qj2yubvbk4yjv24syelk24wqivcbaqpbmg7yxfof5mdqlrh4rova

View the full code for generating browser sandbox values here (opens new window).

- + diff --git a/contribute.html b/contribute.html index d2146d45..2ad8ec93 100644 --- a/contribute.html +++ b/contribute.html @@ -20,7 +20,7 @@ - + @@ -159,6 +159,6 @@

# Development and Deployment

# Launching Development Server

From inside the docsGenerator/docs directory in your terminal, you can launch a development server in order to preview your edits. This will automatically update as you are making edits, but if some changes do not immediately appear you can shut the server down and restart it for a hard refresh:

yarn dev

The development server will, by default, launch at localhost:8080. The server can be shut down with ctrl+c or by killing the terminal used to start it.

The most common error when attempting to launch the development server comes from not having a compatible version of Nodejs. If you get an error, try switching to Node version 16.15.1

# Building Static Files

The Vuepress docs portal is nested inside a static html website. For ease of deployment, Vuepress can build the docs portal into static html files and place them in the docs/ folder in the root of the website. This is not necessary for submitting a pr, but it may be useful for local testing. You can do this by navigating your terminal inside the docs portal Vuepress app docsGenerator/docs and running the command:

yarn build

# Creating Your Pull Request

Once you have all of your local changes committed and synced to your github account, you can create a Pull Request and have the team review the changes for integration into the public site.

  1. Ensure that all of your changes are committed to your own repository. All commits should follow the Conventional Commits (opens new window) standards.

  2. Navigate to your forked repository's page on GitHub.

  3. Switch to the branch you created for your changes.

  4. You should see a banner indicating that you recently pushed a new branch. Click on the "Compare & pull request" button on that banner.

  5. Make sure the base repository is set to the original AR.IO repository and the base branch is set to "staging".

  6. Provide a brief description of your changes in the pull request form. Ensure your title adheres to the Conventional Commits (opens new window) standards.

  7. Review the changes and confirm they appear as expected.

  8. Once you're ready, click on the "Create pull request" button. The AR.IO team will review the request and, if approved, merge your changes into the staging branch of the repository. The changes will later be merged into the main branch for production deployment.

- + diff --git a/experimental/frames/index.html b/experimental/frames/index.html index 3c962412..4ecee64c 100644 --- a/experimental/frames/index.html +++ b/experimental/frames/index.html @@ -20,11 +20,11 @@ - +
ar.io Docs

# Farcaster Frames

# Overview

Frames by Farcaster (opens new window) is a standard for posts, or "casts", that allows them to be interactive and easily authenticated self contained apps. Because the standard relies on HTML Meta tags, they can easily be integrated into dApps hosted permanently on Arweave. Until recently, the full capabilities of Frames hosted on Arweave were not accessible through ar.io gateways. This is because a specific type of interaction between the frame and the hosting server, a POST, is needed to facilitate interactivity, and ar.io gateways did not support this interaction type.

# Experimental Gateway Support

With Release 9 of the ar.io gateways, a new experimental endpoint was added that supports the POST requests needed by frames. The /local endpoint on a gateway is used to facilitate experimental new features, as well as features which may be specific to an individual gateway. Operators and users should be fully aware that all endpoints stemming from /local are experimental, and may not always perform exactly as expected.

# Using Frames

The full path for accessing a frame hosted on Arweave is https://<gateway>/local/farcaster/frame/<ID> where <gateway> represents any ar.io gateway using release 9 or higher, and <ID> represents the txId of the frame on Arweave. Since frames require full, absolute url paths, you will need to choose specific, supported gateway when you are embedding the frame in your cast.

Beyond that, simply embed the url for a frame in a cast and farcaster will be able to render it.

# Example

Arweave community member K, who is a pioneer in permaweb frames, created the below frame to demonstrate how permaweb frames can be interactive when embedded from ar.io gateways.

The ID for the frame he uploaded to Arweave is JFfYkpW5--I5UOxnJTYHhY9-F8X6WrvDsXQv8jYr0WE. Using this, He made a Farcaster cast with the embedded url https://erl5reuvxh56eokq5rtsknqhqwhx4f6f7jnlxq5roqx7enrl2fqq.ar-io.dev/local/farcaster/frame/JFfYkpW5--I5UOxnJTYHhY9-F8X6WrvDsXQv8jYr0WE/. This full url includes the sandbox prefix generated by an ar.io gateway when serving content.

When embedding this full url in a cast, farcaster will render the content into a frame:

View the original post here (opens new window) to experience the interactivity first hand.

- + diff --git a/foundation/index.html b/foundation/index.html index d96870fc..49b3342e 100644 --- a/foundation/index.html +++ b/foundation/index.html @@ -20,11 +20,11 @@ - +
ar.io Docs

# AR.IO Foundation

# What is the AR.IO Foundation?

The AR.IO Foundation is dedicated to the stewardship and prosperity of The AR.IO Network and its associated token ecosystem. It holds a non-revocable, exclusive license to promote the development of the network, prioritizing the ecosystem's wellbeing, particularly the users.

Key strategies employed by the Foundation (with the assistance of third-party teams) in support of the network include:

  • Providing grants and incentive programs

  • Making strategic investments

  • Engaging in direct software development

  • Producing educational content

  • Conducting publicity and marketing initiatives

  • Forming partnerships

# Guiding Philosophy

The AR.IO Foundation serves as a unifying force within the ecosystem, facilitating communication, fostering innovation, and driving overall progress. Its primary aim is to function as a supportive entity rather than exerting excessive control over the network or disrupting its economic processes.

The key objectives of the AR.IO Foundation are as follows:

  • Sustaining and advancing the AR.IO Network: The Foundation takes responsibility for the continued development and enhancement of the AR.IO Network. It works collaboratively with developers, contributors, and stakeholders to ensure the network remains robust, secure, and adaptable to evolving technological landscapes.

  • Allocating resources to promote ecosystem and community growth: The Foundation is entrusted with managing and allocating resources to fuel the growth and expansion of the AR.IO ecosystem. This includes funding research initiatives, supporting innovative projects, and encouraging community-driven initiatives that contribute to the network's overall health and vitality.

  • Managing the core development of the AR.IO Network: The Foundation oversees and coordinates the core development efforts of the AR.IO Network. This involves coordinating with developers and technical teams to implement upgrades, address vulnerabilities, and introduce new features that align with the network's vision and community consensus.

  • Fostering collaboration and inclusivity: The Foundation actively fosters a culture of collaboration and inclusivity within the AR.IO ecosystem. It encourages diverse perspectives and welcomes contributions from individuals and organizations, fostering an environment where all participants can thrive and collectively shape the network's future.

By diligently pursuing these objectives, the AR.IO Foundation aims to create an environment where the AR.IO Network can flourish as a decentralized, secure, and resilient platform, contributing positively to the broader permaweb and decentralized storage landscape.

- + diff --git a/gateway-network/index.html b/gateway-network/index.html index d65af227..d8bc5596 100644 --- a/gateway-network/index.html +++ b/gateway-network/index.html @@ -20,11 +20,11 @@ - +
ar.io Docs

# Gateway network

# Overview

The AR.IO Network consists of AR.IO Gateway nodes, which are identified by their registered Arweave wallet addresses and either their IP addresses or hostnames, as stored in the network's smart contract Gateway Address Registry (GAR).

These nodes adhere to the AR.IO Network Protocols, creating a collaborative environment of Gateway nodes that vary in scale and specialization. The network ensures a fundamental level of service quality and trust minimization among its participants.

Being part of the network grants AR.IO Gateways an array of advantages, such as:

  • Simplified advertising of services and end user discovery via the Gateway Address Registry.

  • More rapid bootstrapping of key Gateway operational data due to prioritized data request fulfillment among Gateways joined to the network.

  • Sharing of data processing results.

  • Access to support channels tailored for operators.

  • Enhanced trust and transparency through the use of AGPL-3 licenses, which mandate public disclosure of any software changes, thereby reinforcing the network's integrity and reliability.

  • Improved network reliability and performance through an incentive protocol, which uses a system of rewards and evaluations to encourage high-quality service from Gateways.

# Gateway Address Registry (GAR)

Any Gateway operator that whishes to join the AR.IO Network must register their node in the AR.IO smart contract's "Gateway Address Registry", known as the GAR. Registration involves staking a minimum amount of IO tokens and providing additional metadata describing the Gateway service offered.

After joining the network, the operator's Gateway can be easily discovered by permaweb apps, its health can be observed, and it can participate in the AR.IO data sharing protocol.

The Gateway operator can modify their Gateway's GAR configuration as needed, which includes adding more tokens to their stake or removing them. Operators can completely remove their stake and leave the AR.IO Network following a minimum network exit wait time. This exit time ensures that Gateways cannot quickly escape from an anticipated penalty.

The GAR advertises the specific attributes of each Gateway including its stake and settings. This enables permaweb apps and users to discover which Gateways are currently available and meet their needs. Apps that read the GAR can sort and filter it using the Gateway metadata, for example, ranking Gateways with the highest stake at the top of the list. This would allow users to prefer the lower-trust, higher staked Gateways before settling on a higher-trust, lower staked Gateway.

# Staking

Staking tokens serves a dual purpose in the AR.IO Network:

  • It acts as a method of public commitment, and

  • It qualifies participants for reward distribution.

In the AR.IO Network, "staking" designates the act of locking a specified amount of IO tokens into a protocol-controlled vault. These tokens act as a form of collateral and public commitment, encouraging network participants to act in the network's best interests. Once tokens are deposited in the vault, they remain locked until either the participant triggers the "unstake" function or the vault's predetermined lock period expires.

It is important to note that unlike other protocols, the IO token is non-inflationary. Therefore, the staking mechanism in the AR.IO Network is not designed to function as a yield-generation tool. By staking their tokens, participants become eligible for potential rewards, fostering an atmosphere of mutual trust within the network. Specifically, Gateway operators stake tokens to facilitate their Gateway integration and establish public trust. Once connected, they become eligible for rewards driven by the protocol and gain access to the network's shared resources.

# Schema

# Gateway Schema

Gateway
Name Type Description
operatorStake number The total stake of the Gateway's operator.
start number Block number in which the Gateway joined the network.
end number Block number in which the Gateway can leave the network, setting to 0 means no end date.
status string Participation status of the Gateway, "joined" - participating in the network, "hidden" - not leaving, but not participating, "leaving" - in the process of withdrawing from the network.
vaults array of objects The locked tokens staked by the Gateway operator, view schema.
settings object Additional configuration settings for the Gateway, view schema.
delegates object Wallets that have delegated a stake of IO tokens to the Gateway.
totalDelegatedStake number The total number of IO tokens delegated to the Gateway
observerWallet string The public address for the wallet being used to sign and upload Observer reports
stats object Information about the Gateways Network performance

# Token Vault

Token Vault
Name Type Description
balance number Positive integer, the number of IO tokens locked.
start number Block number in which locking starts.
end number Block number in which locking ends. Setting to 0 means no end date.

# Gateway Settings

Gateway Settings
Name Type Required Description
label string yes The friendly name used to label the Gateway.
fqdn string yes The fully qualified domain name at which the Gateway can be reached. e.g. arweave.net
port number yes The port used by the Gateway. e.g. 443
protocol string yes Web protocol used by this Gateway "https", or "http"
properties string no An Arweave transaction ID containing additional properties of the Gateway.
note string no An Arweave transaction ID containing additional notes the Gateway operator can set to include things like announcements, maintenance, or other operational updates.
allowDelegatedStaking boolean no The Gateway Operator can allow or disallow other wallets to stake IO tokens on the Gateway.
delegatedRewardShareRatio number no The percentage of Gateway rewards given to delegated stakers
autoStake boolean no If true, Gateway rewards will automatically be added to the Gateway's Operator stake
- + diff --git a/gateways/ar-io-node/admin/admin-api.html b/gateways/ar-io-node/admin/admin-api.html index 682bc537..3d458c50 100644 --- a/gateways/ar-io-node/admin/admin-api.html +++ b/gateways/ar-io-node/admin/admin-api.html @@ -20,7 +20,7 @@ - + @@ -64,6 +64,6 @@ "source": "Example source" }
  • id: This should be the transaction id of the content you want to block.
  • notes: Notes regarding the reason this content was blocked. For documentation purposes only.
  • source: Identifier for the source of TX IDs you are blocking. For example, the name of a public block list. For documentation purposes only.

Your Gateway will either respond with an error, or { message: 'Content blocked' }

- + diff --git a/gateways/ar-io-node/advanced-config.html b/gateways/ar-io-node/advanced-config.html index 0e64d7d6..4f090493 100644 --- a/gateways/ar-io-node/advanced-config.html +++ b/gateways/ar-io-node/advanced-config.html @@ -20,7 +20,7 @@ - + @@ -46,6 +46,6 @@ TRUSTED_ARNS_RESOLVER_TYPE=resolver TRUSTED_ARNS_RESOLVER_URL=http://resolver:6000
  • RUN_RESOLVER is a boolean representing an on/off switch for the local resolver.
  • TRUSTED_ARNS_RESOLVER_TYPE sets the method the gateway uses for resolving ArNS names. Use resolver for the local resolver, or gateway for default functionality.
  • TRUSTED_ARNS_RESOLVER_URL is the url a gateway will use to request ArNS name resolution.
- + diff --git a/gateways/ar-io-node/api.html b/gateways/ar-io-node/api.html index 2e033f48..8fc4ff73 100644 --- a/gateways/ar-io-node/api.html +++ b/gateways/ar-io-node/api.html @@ -20,11 +20,11 @@ - +
ar.io Docs

# AR.IO HTTP API

Up to date documentation of endpoints for the AR.IO HTTP API used to access your Gateway can be found here (opens new window).

You can also view endpoint documentation and test the endpoints against your own Gateway by going to <your-Gateway>/api-docs

- + diff --git a/gateways/ar-io-node/arnsoip/observer/index.html b/gateways/ar-io-node/arnsoip/observer/index.html index 1ca004b0..cf98cb05 100644 --- a/gateways/ar-io-node/arnsoip/observer/index.html +++ b/gateways/ar-io-node/arnsoip/observer/index.html @@ -20,7 +20,7 @@ - + @@ -28,6 +28,6 @@
  • This payout rewards gateways and observers who have performed their duties.
  • Gateways that did not meet the performance threshold will not receive rewards.
  • Observers that did not perform their duties are not rewarded and in addition, are penalized on any gateway rewards received.
  • Community builders and application users can verify and leverage the report and distribution information to make more informed decisions on which gateway to use.

    • # Onchain Reports

    The to-be-evaluated ArNS names include a set of names randomly determined by the protocol, known as “prescribed names”, which are common across all observers within the epoch, as well as a set of “chosen names” picked at the discretion of each individual observer. “Prescribed names” are assigned to act as a common denominator / baseline while “chosen names” allow each observer to evaluate names that may be important to their operation.

    Each observer shall assess the performance of the selected ArNS names (across all gateways) and summarize those findings in a report which details the following:

    • General Information: Observer's Arweave address, starting and concluding block heights for the epoch.

    • Gateway Operator Assessment: The expected and actual Arweave addresses of observed gateways, along with a summary verdict (pass or fail), and accompanying reasons for failure.

    • Detailed ArNS Evaluations: For each gateway, it includes the domain name, evaluated ArNS names, the associated block height, transaction IDs, data hashes, a "pass or fail" score, reasons for failure (if any), and performance metrics like time to the first byte.

    A comprehensive list of report criteria can be found in the Appendix.

    Observers shall upload their completed reports (in JSON format) to the Arweave network as an onchain audit trail. In addition, observers shall submit an interaction to the AR.IO smart contact detailing each gateway that they observed to have “failed” their assessments. This is tallied and used to determine the reward distribution.

    # Selection of Observers

    The observer selection process employs a random-weighted selection method. By combining random selection with weighted criteria like stake, tenure, and past rewards, the process aims to ensure both fairness and acknowledgment of consistent performance. This method allows for a systematic yet randomized approach to selecting gateways for observation tasks.

    # Criteria for Selection

    Up to 50 gateways can be chosen as observers per epoch. If the GAR contains 50 or fewer gateways, then every gateway is designated as an observer for that epoch. If there are greater than 50, then randomized selection shall be utilized.

    The weighted selection criteria will consider the following for each gateway:

    • Stake Weight (SW): This factor considers how financially committed a gateway is to the network. It is the ratio of the amount of IO tokens staked by the gateway relative to the network minimum and is expressed as SW = Gateway Stake / Minimum Stake.

    • Tenure Weight (TW): This factor considers how long a gateway has been part of the network, with a maximum value capped at 4. It is calculated as TW = Gateway Network Tenure / 6 block-months. This means that the maximum value is achieved after 2 block-years of participation in the network.

    • Gateway Reward Ratio Weight (GRRW): This factor is a proxy for a gateway’s performance at resolving ArNS names. The weight represents the ratio of epochs in which a gateway received rewards for correctly resolving names relative to their total time on the network.

    • Observer Reward Ratio Weight (ORRW): This factor is a proxy for a gateway’s performance at fulfilling observation duties. The weight reflects the ratio of epochs in which a gateway, as an observer, successfully submitted observation reports relative to their total periods of service as an observer.

    # Weight Calculation and Normalization

    For each gateway, a composite weight (CW) is computed, combining the Stake Weight, Tenure Weight, Gateway Reward Ratio Weight, and Observer Reward Ratio Weight.

    The formula used is: CW = SW x TW x GRRW x ORRW.

    These weights are then normalized across the network to create a continuous range, allowing for proportional random selection based on the weighted scores. The normalized composite weight (N_CW) for each gateway indicates its likelihood of being chosen as an observer and is calculated by dividing the gateway's CW by the sum of all CWs.

    # Random Selection Process

    The selection of observers is randomized within the framework of these weights. A set of unique random numbers is generated within the total range of normalized weights. For each random number, the gateway whose normalized weight range encompasses this number is selected. This system ensures that while gateways with higher weights are more likely to be chosen, all gateways maintain a non-zero chance of selection, preserving both fairness and meritocracy in the observer assignment process.

    # Performance Evaluation

    Consider the following classifications:

    • Functional or Passed Gateways: are gateways that meet or surpass the network’s performance and quality standards.

    • Deficient or Failed Gateways: are gateways that fall short of the network's performance expectations.

    • Functional or Submitted Observers: are selected observers who diligently perform their duties and submit observation reports and contract interactions.

    • Deficient or Failed Observers: are selected observers who do not fulfill their duty of submitting observation reports and contract interactions.

    At the end of an epoch, the smart contract will assess the results from the observers during a “tallying period” and determine a pass / fail score for each gateway:

    • If greater than or equal to 50% of submitted observer contract interactions indicate a PASS score, then that gateway is considered Functional and eligible for gateway rewards.

    • Else, if greater than 50% of submitted observer contract interactions indicate a FAIL score, then that gateway is considered Deficient and ineligible for gateway rewards.

    These results will determine how reward distributions are made for that epoch. Rewards shall be distributed after the epoch’s tallying period is complete.

    # Reward Distribution

    Each epoch, a defined portion of the protocol balance (e.g., 0.05%) is earmarked for distribution as rewards. From this allocation, two distinct reward categories are derived:

    1. Base Gateway Reward: This is the portion of the reward allocated to each Functional Gateway within the network and is calculated as:

      [Epoch Reward Allocation x 90% / Total Gateways in the Network]

    2. Base Observer Reward: Observers, due to their additional responsibilities, have a separate reward calculated as:

      [Epoch Reward Allocation x 10% / Total Selected Observers for the Epoch]

    # Distribution Based on Performance

    The reward distribution is contingent on the performance classifications derived from the Performance Evaluation:

    • Functional Gateways: Gateways that meet the performance criteria receive the Base Gateway Reward.

    • Deficient Gateways: Gateways falling short in performance do not receive any gateway rewards.

    • Functional Observers: Observers that fulfilled their duty receive the Base Observer Reward.

    • Deficient Observers: Observers failing to meet their responsibilities do not receive observer rewards. Furthermore, if they are also Functional Gateways, their gateway reward is reduced by 25% for that epoch as a consequence for not performing their observation duty.

    # Undistributed Rewards

    In cases where rewards are not distributed, either due to the inactivity or deficiency of gateways or observers, the allocated tokens shall remain in the protocol balance and carry forward to the next epoch. This mechanism is in place to discourage observers from frivolously marking their peers as offline in hopes of attaining a higher portion of the reward pool.

    # Handling Inactive Gateways

    To maintain network efficiency and reduce contract state bloat, gateways that are consistently offline, specifically for thirty (30) consecutive epochs, and thus fail to receive rewards, will be automatically removed from the Gateway Active Registry (GAR) as well as have their staked IO tokens unlocked and returned to the gateway operator.

    # Observer Report Details

    Each observer shall assess the performance of the selected ArNS names (across all AR.IO gateways) and summarize those findings in a report which details the following:

    # General Information

    • The observer's Arweave address.
    • The starting block height of the epoch.
    • The block height at which the report was generated.

    # Overall Gateway Operator Assessment

    • Gateway FQDN.
    • The Arweave address that the observer expects to be the owner / operator of the gateway.
    • The Arweave address that the observed gateway actually reports.
    • A final “pass or fail” rollup determination for each observed gateway.
    • Failure reason (if applicable).

    # ArNS Assessments

    • Observed ArNS name (for all prescribed and chosen names).
    • The block height at which the name was assessed.
    • The expected status code.
    • The resolved status code.
    • The transaction ID that the observer expects the associated name to resolve to.
    • The transaction ID that the gateway actually resolves to.
    • The data hash that the observer expects the associated name to resolve to.
    • The data hash that the gateway actually resolves to.
    • The “pass or fail” score associated with the observed name, at the observer’s discretion.
    • Failure reason (if applicable).
    • Timing / performance information associated with the name resolution such as time to first byte and total duration.

    The above is repeated for the entire name pool and across each gateway in the GAR.

    # Example Observation Report

    https://arweave.net/GG1YCFc7wQxKvQ1qD1lTEp2OAMBs4VzrpfdmeeLyjDI (opens new window)

    # Viewing Observation Reports

    You can easily view an observation report in a human readable format through your terminal with the following command:

    curl -L https://arweave.net/<txId> | zcat | jq .

    Be sure to replace <txId> with the txId of the report you want to view.

    # example

    curl -L https://arweave.net/H3zDmoDkpOg0U95rejBEq6gUnww_CEVscTuQVqfSbxk | zcat | jq .
    - + diff --git a/gateways/ar-io-node/env.html b/gateways/ar-io-node/env.html index f6205b75..72837729 100644 --- a/gateways/ar-io-node/env.html +++ b/gateways/ar-io-node/env.html @@ -20,11 +20,11 @@ - +
    ar.io Docs

    # Environmental Variables

    # Overview

    The AR.IO Gateway allows configuration customization through environmental variables. These variables dictate the gateway's behavior, from block synchronization settings to log formatting. Detailed below is a table enumerating all available environmental variables, their respective types, default values, and a brief description. Note that certain variables, such as SANDBOX_PROTOCOL, rely on others (e.g., ARNS_ROOT_HOST) to function effectively. Ensure proper understanding of these dependencies when configuring.

    # Variables

    Sets the minimum Gateway release version to check while doing a gateway version assessment Sets the current ar.io node version to be set on X-AR-IO-Node-Release header on requests to the reference gateway Sets the location for chunked data to be saved. If omitted, chunked data will be stored in the `data` directory Sets the location for contiguous data to be saved. If omitted, contiguous data will be stored in the `data` directory Sets the location for header data to be saved. If omitted, header data will be stored in the `data` directory Sets the location for sqlite indexed data to be saved. If omitted, sqlite data will be stored in the `data` directory Sets the location for temporary data to be saved. If omitted, temporary data will be stored in the `data` directory Sets the location for LMDB data to be saved. If omitted, LMDB data will be stored in the `data` directory
    ENV Name Type Default Value Description
    START_HEIGHT Number or "Infinity" 0 Starting block height for node synchronization (0 = start from genesis block)
    STOP_HEIGHT Number or "Infinity" "Infinity" Stop block height for node synchronization (Infinity = keep syncing until stopped)
    TRUSTED_NODE_URL String "https://arweave.net" Arweave node to use for fetching data
    TRUSTED_GATEWAY_URL String "https://arweave.net" Arweave node to use for proxying reqeusts
    TRUSTED_ARNS_GATEWAY_URL String https://NAME.arweave.dev ArNS gateway
    INSTANCE_ID String "" Adds an "INSTANCE_ID" field to output logs
    LOG_FORMAT String "simple" Sets the format of output logs, accepts "simple" and "json"
    SKIP_CACHE Boolean false If true, skips the local cache and always fetches headers from the node
    PORT Number 4000 AR.IO node exposed port number
    SIMULATED_REQUEST_FAILURE_RATE Number 0 Number from 0 to 1, representing the probability of a request failing
    AR_IO_WALLET String "" Arweave wallet address used for staking and rewards
    ADMIN_API_KEY String Generated API key used for admin API requests (if not set, it is generated and logged into the console)
    BACKFILL_BUNDLE_RECORDS Boolean false If true, AR.IO node will start indexing missing bundles
    FILTER_CHANGE_REPROCESS Boolean false If true, all indexed bundles will be reprocessed with the new filters (you can use this when you change the filters)
    ANS104_UNBUNDLE_FILTER String {"never": true} Only bundles compliant with this filter will be unbundled
    ANS104_INDEX_FILTER String {"never": true} Only bundles compliant with this filter will be indexed
    ARNS_ROOT_HOST String undefined Domain name for ArNS host
    SANDBOX_PROTOCOL String undefined Protocol setting in process of creating sandbox domains in ArNS (ARNS_ROOT_HOST needs to be set for this env to have any effect) accepts "http" or "https"
    START_WRITERS Boolean true If true, start indexing blocks, tx, ANS104 bundles
    RUN_OBSERVER Boolean true If true, runs the Observer alongside the gateway to generate Network compliance reports
    MIN_RELEASE_NUMBER string "0"
    AR_IO_NODE_RELEASE string "0"
    OBSERVER_WALLET String undefined The public wallet address of the wallet being used to sign report upload transactions for Observer
    CHUNKS_DATA_PATH string "data/chunks"
    CONTIGUOUS_DATA_PATH string "data/contiguous"
    HEADERS_DATA_PATH string "data/headers"
    SQLITE_DATA_PATH string "data/sqlite"
    TEMP_DATA_PATH string "data/tmp"
    LMDB_DATA_PATH string "data/LMDB"
    CHAIN_CACHE_TYPE String "redis" Sets the method for caching chain data, defaults to redis if gateway is started with docker-compose, otherwise defaults to LMDB
    REDIS_CACHE_URL String (URL) "redis://localhost:6379" URL of Redis database to be used for caching
    REDIS_CACHE_TTL_SECONDS Number 28800 TTL value for Redis cache, defaults to 8 hours (28800 seconds)
    ENABLE_FS_HEADER_CACHE_CLEANUP Boolean false If true, periodically deletes cached header data
    NODE_JS_MAX_OLD_SPACE_SIZE Number system default Sets the memory limit, in Megabytes, for NodeJs. Default value depends on hardware
    SUBMIT_CONTRACT_INTERACTIONS Boolean true If true, Observer will submit its generated reports to the ar.io Network. If false, reports will be generated but not submitted
    REDIS_MAX_MEMORY String 256mb Sets the max memory allocated to Redis
    REDIS_EXTRA_FLAGS String --save "" --appendonly no Additional CLI flags passed to Redis
    WEBHOOK_TARGET_SERVERS String undefined Target servers for webhooks
    WEBHOOK_INDEX_FILTER String {"never": true} Only emit webhooks for transactions and data items compliant with this filter
    WEBHOOK_BLOCK_FILTER String {"never": true} Only emit webhooks for blocks compliant with this filter
    CONTIGUOUS_DATA_CACHE_CLEANUP_THRESHOLD Number undefined Sets the age threshold in seconds; files older than this are candidates for contiguous data cache cleanup
    RUN_RESOLVER Boolean false If true, enables the experimental local ArNS resolver service
    TRUSTED_ARNS_RESOLVER_TYPE String gateway Sets the type of ArNS resolver the gateway will use, either `gateway` or `resolver`. Set `resolver` to use experimental local ArNS resolver.
    TRUSTED_ARNS_RESOLVER_URL String https:__NAME__.arweave.dev Sets the url a gateway will use to request ArNS name resolution when type is set to `resolver`
    ENABLE_MEMPOOL_WATCHER Boolean false If true, the gateway will start indexing pending tx from the mempool
    MEMPOOL_POLLING_INTERVAL_MS Number 30000 Sets the mempool Polling interval, in milliseconds
    - + diff --git a/gateways/ar-io-node/linux-setup/index.html b/gateways/ar-io-node/linux-setup/index.html index bca4a0df..927f7cd7 100644 --- a/gateways/ar-io-node/linux-setup/index.html +++ b/gateways/ar-io-node/linux-setup/index.html @@ -20,7 +20,7 @@ - + @@ -110,6 +110,6 @@

  • Save and exit nano.

  • Test the configuration:

    sudo nginx -t

  • If there are no errors, restart nginx:

    sudo service nginx restart

    • Your node should now be running and connected to the internet. Test it by entering https://<your-domain>/3lyxgbgEvqNSvJrTX2J7CfRychUD5KClFhhVLyTPNCQ in your browser.

    Note: If you encounter any issues during the installation process, please seek assistance from the AR.IO community (opens new window).

    - + diff --git a/gateways/ar-io-node/observer-upgrade.html b/gateways/ar-io-node/observer-upgrade.html index 82b7e2d9..52180f0a 100644 --- a/gateways/ar-io-node/observer-upgrade.html +++ b/gateways/ar-io-node/observer-upgrade.html @@ -20,13 +20,13 @@ - +
    ar.io Docs

    # Upgrading to the Observer Module

    # Overview

    From time to time, significant updates to the AR.IO Gateway node software might necessitate additional configuration steps to harness the entirety of the new features. The recent addition of the "Observer" module, designed to monitor the health of the AR.IO network, is a case in point. To integrate this module successfully, users will need to undertake two supplementary steps beyond the conventional upgrade routine:

    1. Supply the keyfile for an active Arweave wallet.

    2. Configure specific environmental variables.

    Both of these steps can be completed during the normal upgrade process BEFORE you rebuild your gateway (step #5).

    # Supply a Keyfile

    A primary function of the Observer Module is to upload reports on the health of the AR.IO network to the Arweave blockweave. In order to do this, transactions must be signed and paid for. This requires the keyfile for an Arweave wallet be provided to your gateway.

    You may use the same wallet linked to your gateway in the AR.IO network (AR_IO_WALLET in your .env file) but in most situations it is safer to use a separate fresh wallet, or a "hot" wallet you use for safely interacting with Dapps, especially if you host your gateway on a remote server where other people may have access. Find more information about creating fresh wallets here (opens new window).

    Remember, your keyfile contains the public keys to your Arweave wallet, always be extremely careful not to expose it to unsafe conditions.

    Your keyfile must be saved in the new wallets directory in the root of the gateway repository, with the name <public address>.json

    For example: QGWqtJdLLgm2ehFWiiPzMaoFLD50CnGuzZIPEdoDRGQ.json

    # Environmental variables

    There are two new environmental variables that should be set when upgrading to Observer. Both of these should be added to the .env file prior to rebuilding your gateway:

    • RUN_OBSERVER (optional) - This is the on/off switch for Observer. The default value is true, so omitting this from your environmental variables will not prevent Observer from running. Set the value to false if you want your gateway to run without Observer.
      • RUN_OBSERVER=true
    • OBSERVER_WALLET - This should be set to the public address of the wallet you are using to sign Observer transactions.
      • OBSERVER_WALLET=QGWqtJdLLgm2ehFWiiPzMaoFLD50CnGuzZIPEdoDRGQ

    Note: If you encounter any issues during the upgrade process, please seek assistance from the AR.IO community (opens new window).

    - + diff --git a/gateways/ar-io-node/operation.html b/gateways/ar-io-node/operation.html index 9f1d56d2..c4d934dd 100644 --- a/gateways/ar-io-node/operation.html +++ b/gateways/ar-io-node/operation.html @@ -20,7 +20,7 @@ - + @@ -68,6 +68,6 @@

    # Chunks

    Get existing chunk offset information

    /chunk/{offset}

    Example

    Request

    https://arweave.net/chunk/146788128412032
    Response 
    {"tx_path":"hdWq1ZszBltk9XIkGv2yDLijyWbG7tnrRGT7VLc3hrKq2uqaqCHhijNLumytek1GK_EfsHS5zGYSyXP218ZrlAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAEEAL9xRcPRiJdHwKIwqVWFc03WLQPX_pdPK6eBkGDyoyglINUplsTV9ctXMDznPacmopzSYyxvbMbEql8jRW9z3uvdQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAB8AAAHWcAO5fnvS8i1dR0DMvq47fvjc6BCAKRYUyEQj1HeOkrQwuFz108Gvrl6UZteWygR75jjAmC3XxnY6hjnGMvTAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABtAAAAp86EvExjN5pmMbgA0epeTQQSmcu48Y2VDDcPA_lKJ6IQow56ogsMrzbS8S5IQG-7_L5dWzKCKDsAeaZ_az4CgAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABmAAA8r751YA8Kq2_AleQT_A_R7HU59WAPFZaAlzRwXB8aYTpsfD9gtQXIN87OK0DEkDrBif6D-0YYrDVEG-8JCZtfwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABFAAA5Kqqj2vVHEG_K4NunOiODeMSfXnXyT0eCaf_xJDDIAbfUzMg0K612E47CYUVQSbeR46GAPRm7bHMXjtmJii7YQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAADAAAME1z0BlQq8hEamYDmMnYo2ESNoQ33F466PT9IccTwKdxGcmv67CXThF9yIhkiiujvXaVK8lJ7jSJei_OTNLA1gAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABE7CKeu3Xce8mGabqh6VQhlht_SdtFe94-UuuKdYCWkfMQIEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAROwig","packing":"unpacked","end_offset":"146788128412032","data_path":"yGaK4gUHpKT592HBM52EPtYPTOlXQ0xEsYAtsTLDKZf5DH-Cgsm9ozNJz1GyUWfGl1821cKPzRYEXyS-2ElccAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAAA0tWhxbuyMy_85pTq-fKmzglh8tf7enrnc0CTObxp4B1h6Bbz_ro2lKtst64jbBFv2hmJULiXZFuS2FGiOTXxFQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABBAAAkLsCIhZqqii07Ogt1xLB9tcJCy6nXb-PLCX4uJffDUEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQewig","chunk":"aWNhdGlvbhhDeWJlckNvbm5lY3QOQ2hhaW5JZAQ1NhxDb250ZW50LVRhcmdldIABMzlmMDIxODgxZTczODZmOGQ3M2Q2ZWYyNTUzM2U2MDkxZjJhMDI1NmU0MjJiNGIzYzRlM2QzMzVjY2FlMTQ3ZQxTb3VyY2VIMTU1MzFmYTItMTIwNS00ZjYxLWI2ZTQtYzlmNjhlY2Y4MWY3FENvbnRlbnQtSWSAAWE5ZTRhMGRkZGY4ZWJmNjFlNzAxM2I1YzEwMGM2ZWE5YjM5MDg1YzZmMjhjZTc4ZGI5YjVhODU4YTUwZGQ5YzIcQ29udGVudC1EaWdlc3SAAWE5ZTRhMGRkZGY4ZWJmNjFlNzAxM2I1YzEwMGM2ZWE5YjM5MDg1YzZmMjhjZTc4ZGI5YjVhODU4YTUwZGQ5YzIcQ29udGVudC1BdXRob3IYanZwbm1hemUxcHhhAHsiY29udGVudCI6IntcIm9wXCI6XCJjb21tZW50XCIsXCJhZGRyZXNzXCI6XCIweDVlOWIxNDY4YjIyYWQ1Yzg5MzliZGY5MmE3MjRjZmFkZjg0YWE5MmRcIixcInRzXCI6MTY5MTQ2MDYxODMwMSxcImNoYWluSWRcIjo1NixcImhhbmRsZVwiOlwianZwbm1hemUxcHhhXCIsXCJ0YXJnZXRcIjpcIjM5ZjAyMTg4MWU3Mzg2ZjhkNzNkNmVmMjU1MzNlNjA5MWYyYTAyNTZlNDIyYjRiM2M0ZTNkMzM1Y2NhZTE0N2VcIixcInRpdGxlXCI6XCJGbGFwcHlNb29uYmlyZFwiLFwiYm9keVwiOlwiU28gZnVuIHRvIHBsYXkgaW4gbXkgc3BhcmUgdGltZS5cIn0iLCJkaWdlc3QiOiJhOWU0YTBkZGRmOGViZjYxZTcwMTNiNWMxMDBjNmVhOWIzOTA4NWM2ZjI4Y2U3OGRiOWI1YTg1OGE1MGRkOWMyIiwic2lnbmF0dXJlIjoiMHhlM2Y2ZjlkMjliMjQ4N2M0ODQ4MjNiZDdhNDAzMWZiZjRjNTE2OTAzNmUxYzhlOGZiM2VmMWRjYmU2YTM2MmRhYzFlNzgxNzllYjljYzdjM2U3MGUzMzE1OWYyMjVlNzIxNjYzNzk2NmNjOGVkYTg0MjJmZmM5YjU3M2YyZmI0MyIsInNpZ25pbmdLZXkiOnsicHVibGljS2V5IjoiTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFT1IvZ3gxMmh1L1hSZzB1QTlXbnpFQXU5VFg5Mk8vTVRBY3VmT3YxNElVbVhuajNlWWthYXZVazFZczNDNk1ObGtVaEt4Z2orYnhaN3k4SUVYTUhiUkE9PSIsImZvcm1hdCI6IlN1YmplY3RQdWJsaWNLZXlJbmZvIiwiYWxnb3JpdGhtIjoiRVMyNTYifSwic2lnbmluZ0tleUF1dGgiOnsiYWRkcmVzcyI6IjB4NWU5YjE0NjhiMjJhZDVjODkzOWJkZjkyYTcyNGNmYWRmODRhYTkyZCIsInNpZ25pbmdLZXlTaWduYXR1cmUiOiIweDZjYmFiYTVmZjg4OTc1MTc2MzFlYzcxNjJmZGE3MzU1MzcxYjVlN2NhMGJjODQ2MmU2ZGMzMDQxZjZjZTU5YjM3OTFiYmJlY2RiMWUwN2U5MmI3NDgxMTc1YjExYjUwM2Q1OTIwNzNjNDM0MzE4MzEwZDYyNzEzNTM4NDFlZGZmMWMiLCJzaWduaW5nS2V5TWVzc2FnZSI6IkkgYXV0aG9yaXplIEN5YmVyQ29ubmVjdCBmcm9tIHRoaXMgZGV2aWNlIHVzaW5nIHNpZ25pbmcga2V5OlxuTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFT1IvZ3gxMmh1L1hSZzB1QTlXbnpFQXU5VFg5Mk8vTVRBY3VmT3YxNElVbVhuajNlWWthYXZVazFZczNDNk1ObGtVaEt4Z2orYnhaN3k4SUVYTUhiUkE9PSJ9fQEASjduLbz5q9JRuhdSD8Q4R2o9F24qLprPskKXQYkFd25ZGu1vrtLX1rXr1H-EcBCJAXacKORIgHErMDgI1oaS0txlQeeOPlrp-XmJW2dZWMOaY2SDplmI60dvHtsh7ZzfQPdKkGfWUo7lK6SUKbZV8q_2bmqIP0Tgfu5lTQbHqu9lpDaW5gmmh8f66bftafRsj1OZaGoGcieIl2QlbEAVsetyIxVvw7gFC0nyFkErRb8nTyKJoK-5KG92Ql8HUkvdbbCE3KPPnRyWPEjUUSlMO7bOhyrV1m4TbWguIJrnDF9ctIm-NeGAUmDOJYxo24RCm5stAMvUc90hAN4eFh3LgesvEpTqNNJP1A2cemxT8CxZ2UlX1IRNMKicvvYCDvOPv_OpP1NfVsDyPrHLUTq-9cMkGfD4JbIQjmnrca0lT6F_mLaXc-siu8mw4GD6UCSLmnvg_yQ38nVpQUwtcXyoYbiSefotE-J2CV9SlqQwyYjicmNnxJxWkTwOYWMuUeooiAJqUPsnp_zkEHanFG1LgFTYRQls58ef4AhKX_yZJ-hYTK2Fw0BSSiibZSNxcfu0tD-cK6eblIDYPSWBnLYaw0ZqE2A6MvlwDP-_9E8WQA6uLpZvQejApeCk3p4bE3bKl6AV7_yt3dachNmkFaPCmU_4bPVDDQ0AP4KyceW-o1ic-BftbJWhOdPEW3IwfMr-LJD2MpO5M289kO-kpfKtoi6M3vFwLg28ndonzOyxQsVA2CqILlxDailsU6GDQDsYsgGRc3BJXAPkEF8ccKyJX6bCOOp26OWXPL6lHkEK-9XYVng-VUCCzFfyEIRBQ1Wk7n-AhJIT9J4u5FZeWF1JFEjh0YU1absTvlknN46f8LmFkK5CMh2BL9r47__m_YyoFCUoNR23DnileeJSRkDhSE9c2BwbBW90EOzJsIl4z_9qRUOENatjqeoY6jMd-shRLVVH8J2jgs_nsOVKQ87B9vzUwMGRiPM-7Udg1MsRQJxaI23DT5hXuPh4PH9rmnp6w2IhkidcrcMkbDZrg1rt70XJEtbNI0-13nhizSqNwZhNXAkm-Xh7qgTtsw9cpKm0CJ6I7eOEKcMVE6Xhabc1fZrUgTgNlh-TWFGOGLjun1OBtmYGTDz_XLmu6d4BvhmY7I7WOI7FDqZAIE74BCmigedpw2VC2CHLTmVFHmSp0mwMRxlm5Kmnie5AlPt-QGOZE5vDWU6qenIMHCsQUpD_dy3Xa2g8so3qN9N1hTudo5jTF7038O5atWXNZkOO-S5yItnbk_pUjgjiutFsm7BUCTlFcE9XhFxe4f7xJk-W6KVDq1_KAsMRVB4XyW2WtEzESaOhQ30YqQ-N-bJnOx6WaQAACAAAAAAAAAB9AQAAAAAAAA_yBRhDb250ZW50LVR5cGUgYXBwbGljYXRpb24vanNvbhZBcHBsaWNhdGlvbhhDeWJlckNvbm5lY3QUQ29udGVudC1JZIABYTJjNjIwYzUwZWM0YmQ0OWZhMGUyNDAxNDUxNGM3NTlmZjZjZDRlYjFiOTRjNDRjMzc0Y2NkNGNmNGVmYzAwMRxDb250ZW50LURpZ2VzdIABYTJjNjIwYzUwZWM0YmQ0OWZhMGUyNDAxNDUxNGM3NTlmZjZjZDRlYjFiOTRjNDRjMzc0Y2NkNGNmNGVmYzAwMRxDb250ZW50LUF1dGhvchg1aTNhNTZzZjY5NjQOQ2hhaW5JZAQ1NhxDb250ZW50LVRhcmdldIABMzlmMDIxODgxZTczODZmOGQ3M2Q2ZWYyNTUzM2U2MDkxZjJhMDI1NmU0MjJiNGIzYzRlM2QzMzVjY2FlMTQ3ZQxTb3VyY2VIMTU1MzFmYTItMTIwNS00ZjYxLWI2ZTQtYzlmNjhlY2Y4MWY3AHsiY29udGVudCI6IntcIm9wXCI6XCJjb21tZW50XCIsXCJhZGRyZXNzXCI6XCIweDY3NzM2YjI5MGFhZWI1ZjM1NzZmOWEyZGVhYzYwYTVlNmY4ZWRlNjBcIixcInRzXCI6MTY5MTQ2MDYxODA5NSxcImNoYWluSWRcIjo1NixcImhhbmRsZVwiOlwiNWkzYTU2c2Y2OTY0XCIsXCJ0YXJnZXRcIjpcIjM5ZjAyMTg4MWU3Mzg2ZjhkNzNkNmVmMjU1MzNlNjA5MWYyYTAyNTZlNDIyYjRiM2M0ZTNkMzM1Y2NhZTE0N2VcIixcInRpdGxlXCI6XCJGbGFwcHlNb29uYmlyZFwiLFwiYm9keVwiOlwiU28gZnVuIHRvIHBsYXkgaW4gbXkgc3BhcmUgdGltZS5cIn0iLCJkaWdlc3QiOiJhMmM2MjBjNTBlYzRiZDQ5ZmEwZTI0MDE0NTE0Yzc1OWZmNmNkNGViMWI5NGM0NGMzNzRjY2Q0Y2Y0ZWZjMDAxIiwic2lnbmF0dXJlIjoiMHhhNDhjOThiM2FkZGQ0MDdiMjk1ZTUzYjJmMzgwZmJjNDBlNDFkZjY1OWQ4MmM2YjMyZjIxOGUzZjdkNGI3OTZkMjAyZDdjMDhhZDFlNWUyMTUzMWM2N2FhNjFmM2EwMWQ5MjhmZDY0Yjk2YmFhMmE3NjA5NDQ0YjI0NTQyZjFmMCIsInNpZ25pbmdLZXkiOnsicHVibGljS2V5IjoiTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFY0xOY1Nqcm1PdHJIN2hSQTBaZkRKc29kbE5UWDYyc0YrWG16R3Q3OFFHZS9IdFlaZ1EvWGlCc1ZUUTV1VUhHQTd3RGdsOUxUenZhUzAzSUZsN1dzb0E9PSIsImZvcm1hdCI6IlN1YmplY3RQdWJsaWNLZXlJbmZvIiwiYWxnb3JpdGhtIjoiRVMyNTYifSwic2lnbmluZ0tleUF1dGgiOnsiYWRkcmVzcyI6IjB4Njc3MzZiMjkwYWFlYjVmMzU3NmY5YTJkZWFjNjBhNWU2ZjhlZGU2MCIsInNpZ25pbmdLZXlTaWduYXR1cmUiOiIweGNlMzJjYjMzOTUzZDJmZGIwNDNlNzhjZjBlM2JlYWNkZDgzMDI0NDEwYmMyNDc3YjE4ODAxY2Q5M2E0YTI0ZDg1Y2RiMWMxODM1MjQ5ODI2ZWI1NmRkZWNkNTc3MjA2YWExOWMxNDlmYjdlZjU0OTcxMmIwMzFhNTliZjEzZDRkMWIiLCJzaWduaW5nS2V5TWVzc2FnZSI6IkkgYXV0aG9yaXplIEN5YmVyQ29ubmVjdCBmcm9tIHRoaXMgZGV2aWNlIHVzaW5nIHNpZ25pbmcga2V5OlxuTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFY0xOY1Nqcm1PdHJIN2hSQTBaZkRKc29kbE5UWDYyc0YrWG16R3Q3OFFHZS9IdFlaZ1EvWGlCc1ZUUTV1VUhHQTd3RGdsOUxUenZhUzAzSUZsN1dzb0E9PSJ9fQEAFKoU3ie5lW7RMjwwmy_pGSxGlqkxRwEi3WQrUec028qreZy4lna8hpiPnu2wMo88hHOt51MXRnzVCX686M3_igQddk5iH-BI-GS0B3bOUo7ytMkMWwA9jRLPPSZOSwiUwTlu3xRJtt9Zy80ikx8V2XAEx0TK2E1FKnf3P4c4waN5RBURsqYVFGV0JpjRvXAk9D1hTkQGC7mga5RWiJJIGc6wbBuFdsXnZhgBiryNYThnUsu1hki1tJrppVfH_Y7gXThrsSS6ltuCnGZ5wtwhq2TqMeY78BBAAcMcnYSN56DSh0NNPqzKRsyfVFhpBc1CFh7cJogwW1LK5iCTCmXkE9TDndnftGERxPJK3L5ELWfAhckHAWwBj01KZ0-nVQoLGt2msWApiyoqVHeU09tPlCD9EA0v_jsOS6MnS2bUFb6XqVFiqMCueOW_0Sbq2s_J8PWn90lorfkZjLps21LNRnlenxy7qeCC2x_7Ui1TbGmCFajA9iA8LI27lBRBF1kvnM-ME7xXJx68lbqkxiDvGNJthQXKxnL8O4GcaOEVyXG5TITT35TuKs9HIiUB3L6tO0ILw2YMi5-Gxldr4PqZqmTbuB44N_AzYbbVkxhGvabT4Jx1eXtN2YT7kgBChGGEBWgMytaw4GCeavXHuIxygxriOG-ODQF_EnusyuFSJh-c-BftbJWhOdPEW3IwfMr-LJD2MpO5M289kO-kpfKtoi6M3vFwLg28ndonzOyxQsVA2CqILlxDailsU6GDQDsYsgGRc3BJXAPkEF8ccKyJX6bCOOp26OWXPL6lHkEK-9XYVng-VUCCzFfyEIRBQ1Wk7n-AhJIT9J4u5FZeWF1JFEjh0YU1absTvlknN46f8LmFkK5CMh2BL9r47__m_YyoFCUoNR23DnileeJSRkDhSE9c2BwbBW90EOzJsIl4z_9qRUOENatjqeoY6jMd-shRLVVH8J2jgs_nsOVKQ87B9vzUwMGRiPM-7Udg1MsRQJxaI23DT5hXuPh4PH9rmnp6w2IhkidcrcMkbDZrg1rt70XJEtbNI0-13nhizSqNwZhNXAkm-Xh7qgTtsw9cpKm0CJ6I7eOEKcMVE6Xhabc1fZrUgTgNlh-TWFGOGLjun1OBtmYGTDz_XLmu6d4BvhmY7I7WOI7FDqZAIE74BCmigedpw2VC2CHLTmVFHmSp0mwMRxlm5Kmnie5AlPt-QGOZE5vDWU6qenIMHCsQUpD_dy3Xa2g8so3qN9N1hTudo5jTF7038O5atWXNZkOO-S5yItnbk_pUjgjiutFsm7BUCTlFcE9XhFxe4f7xJk-W6KVDq1_KAsMRVB4XyW2WtEzESaOhQ30YqQ-N-bJnOx6WaQAABwAAAAAAAAAMAQAAAAAAAA2QBBhDb250ZW50LVR5cGUgYXBwbGljYXRpb24vanNvbhZBcHBsaWNhdGlvbhhDeWJlckNvbm5lY3QUQ29udGVudC1JZIABNzY0NWQ0MGM1NjhkZDdmMDdmNDg2MTgxYTc0OGE3Y2FlZTM4ZmMwZjA4Y2NmOWYyYzI3NTkzZWI3ZWY1MDg4NRxDb250ZW50LURpZ2VzdIABNzY0NWQ0MGM1NjhkZDdmMDdmNDg2MTgxYTc0OGE3Y2FlZTM4ZmMwZjA4Y2NmOWYyYzI3NTkzZWI3ZWY1MDg4NRxDb250ZW50LUF1dGhvchhraWIwMDY1ZWUyMXgOQ2hhaW5JZAQ1NgxTb3VyY2UIYXRlbQB7ImNvbnRlbnQiOiJ7XCJvcFwiOlwicG9zdFwiLFwiYWRkcmVzc1wiOlwiMHg0NzM1YTBkMjY1YzEwYmZkMzdmYjllZjUwYjg1MGQ1MzUzOGI1NDZjXCIsXCJ0c1wiOjE2OTE0NjA2MTg2OTQsXCJjaGFpbklkXCI6NTYsXCJoYW5kbGVcIjpcImtpYjAwNjVlZTIxeFwiLFwidGl0bGVcIjpcIjExMTEyXCIsXCJib2R5XCI6XCIyMjIyMjIyMjIyMjIyMjIyMjJcIn0iLCJkaWdlc3QiOiI3NjQ1ZDQwYzU2OGRkN2YwN2Y0ODYxODFhNzQ4YTdjYWVlMzhmYzBmMDhjY2Y5ZjJjMjc1OTNlYjdlZjUwODg1Iiwic2lnbmF0dXJlIjoiMHhmZjBiNGY0ODk3OWUzZDJiYzc3MWY3NGVlMDEyOTcxZDQ3MDZlOWM4MDI0MmZlYWE5Y2Q0NTRlMmM5N2E3ODQyMDI0NGFkYjFkMzI2ZmU2NjNlNDc1MzEwYjg1MTBjYTFkODJiNzYwZjdkMTYxODQxMzE4M2M2NWRkMGI4ZWU5OSIsInNpZ25pbmdLZXkiOnsicHVibGljS2V5IjoiTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFRUp6WUt5TXF6ZnRueDJsbWkvZ1lSNXFWN1U1Q1NGWjR0QUZhb1NFbGhGTUhrYWdRcW5sM1NKTWpEWllXK2RaV0NqNGtUR1pIL29acE94WFN2TENWc0E9PSIsImZvcm1hdCI6IlN1YmplY3RQdWJsaWNLZXlJbmZvIiwiYWxnb3JpdGhtIjoiRVMyNTYifSwic2lnbmluZ0tleUF1dGgiOnsiYWRkcmVzcyI6IjB4NDczNWEwZDI2NWMxMGJmZDM3ZmI5ZWY1MGI4NTBkNTM1MzhiNTQ2YyIsInNpZ25pbmdLZXlTaWduYXR1cmUiOiIweDZlZjk1M2M1ODkyNTZiYjI4MWQ4Njg5NjY0ODE1ZjZkOTlmYTc1ZGZlNjJhNjEyOWNjODQ5OGEzYWY0YWIxN2U1NGQzM2I1MDMzNzkwNzEyYzkyNjUyODUxZDgyZWRhZWUzYjY5MGE2OTg0ZDVmYThkY2E5OTUxZTBkMDZjODU5MWMiLCJzaWduaW5nS2V5TWVzc2FnZSI6IkkgYXV0aG9yaXplIEF0ZW1SZXZpZXcgZnJvbSB0aGlzIGRldmljZSB1c2luZyBzaWduaW5nIGtleTpcbk1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRUVKellLeU1xemZ0bngybG1pL2dZUjVxVjdVNUNTRlo0dEFGYW9TRWxoRk1Ia2FnUXFubDNTSk1qRFpZVytkWldDajRrVEdaSC9vWnBPeFhTdkxDVnNBPT0ifX0BAI_bnzo7AAftuAxV83Ap1Slip7XUxT5CPuq0mXIDhpdX-P9Eigb3ujKiNHBfz7T4kwQnMQd0OGkie6Gl41QA_oJENvlA3HqC08nQghvUVafaPaepioRVgeOk1RdbsTly8hW9as7kY_qX0shdVtWFPASlXlnoB8tDd2wqdRf9hDop1J7EkySOwCx5s3NoSsgJEJ6r7Fhp5iNOdj2aG8LPJ95rOhec0qcSv1GFUxRJRB9Wm9o6vplDQk4uPmqjlywkXKGZmgPY4c_6IigO0F1XWJq5ubAqmO4ijovTZpuy4ZydM2WC6xZaSpngNLqn8_oGLwMvoYxZiPcPxFAiSIcVDRtzPtBvw-VbpI-a5TxdSZSshWVeA7sE8oKf8XNZameaNAg7UmYez3YYOfXt4lJeWDudyqceiYLtyjfLd0fIGAXh7q4PLhlhYzybFjOjuHKkOA-msoXwvYfAgfOzkQZTFQk6W7uAqqB11RPWLb_QT2mZ00y1fBLwG9W_NOnEBgP0iNNDIcLU5H-XbctDHbCkWjy9Ra0ofXm9De7B61kxEis0GCmwBXfguQRtq54edxlftewe_0UYHsMBckGfJDXba39f4z14vqyqYj03IIJKs3at_ITEp01TF9Of5lcLgtswX6qrrkQ-bLBcJqrigEowlzo-v6PYkPLm7K3V7Y38Cew4nPgX7WyVoTnTxFtyMHzK_iyQ9jKTuTNvPZDvpKXyraIujN7xcC4NvJ3aJ8zssULFQNgqiC5cQ2opbFOhg0A7GLIBkXNwSVwD5BBfHHCsiV-mwjjqdujllzy-pR5BCvvV2FZ4PlVAgsxX8hCEQUNVpO5_gISSE_SeLuRWXlhdSRRI4dGFNWm7E75ZJzeOn_C5hZCuQjIdgS_a-O__5v2MqBQlKDUdtw54pXniUkZA4UhPXNgcGwVvdBDsybCJeM__akVDhDWrY6nqGOozHfrIUS1VR_Cdo4LP57DlSkPOwfb81MDBkYjzPu1HYNTLEUCcWiNtw0-YV7j4eDx_a5p6esNiIZInXK3DJGw2a4Na7e9FyRLWzSNPtd54Ys0qjcGYTVwJJvl4e6oE7bMPXKSptAieiO3jhCnDFROl4Wm3NX2a1IE4DZYfk1hRjhi47p9TgbZmBkw8_1y5runeAb4ZmOyO1jiOxQ6mQCBO-AQpooHnacNlQtghy05lRR5kqdJsDEcZZuSpp4nuQJT7fkBjmRObw1lOqnpyDBwrEFKQ_3ct12toPLKN6jfTdYU7naOY0xe9N_DuWrVlzWZDjvkuciLZ25P6VI4I4rrRbJuwVAk5RXBPV4RcXuH-8SZPluilQ6tfygLDEVQeF8ltlrRMxEmjoUN9GKkPjfmyZzselmkAAAgAAAAAAAAAfgEAAAAAAAAP9AUYQ29udGVudC1UeXBlIGFwcGxpY2F0aW9uL2pzb24WQXBwbGljYXRpb24YQ3liZXJDb25uZWN0DkNoYWluSWQENTYcQ29udGVudC1UYXJnZXSAATM5ZjAyMTg4MWU3Mzg2ZjhkNzNkNmVmMjU1MzNlNjA5MWYyYTAyNTZlNDIyYjRiM2M0ZTNkMzM1Y2NhZTE0N2UMU291cmNlSDE1NTMxZmEyLTEyMDUtNGY2MS1iNmU0LWM5ZjY4ZWNmODFmNxRDb250ZW50LUlkgAE1NDQxYzhiZWZjMjNhY2JiODcyNjcwZmM2NjI3MzBkOWU1NWM0NDMyYjI3ZjEyODQyMTZmMjI4MmM1MTZmMWUwHENvbnRlbnQtRGlnZXN0gAE1NDQxYzhiZWZjMjNhY2JiODcyNjcwZmM2NjI3MzBkOWU1NWM0NDMyYjI3ZjEyODQyMTZmMjI4MmM1MTZmMWUwHENvbnRlbnQtQXV0aG9yGjAwNjYxMDU1OTY3MzEAeyJjb250ZW50Ijoie1wib3BcIjpcImNvbW1lbnRcIixcImFkZHJlc3NcIjpcIjB4MGYwMTIzMGYwNjVkYjljMzQ4ZDNmZTZjNThlODZkNGRlMjk1MDhlZlwiLFwidHNcIjoxNjkxNDYwNjE5OTI1LFwiY2hhaW5JZFwiOjU2LFwiaGFuZGxlXCI6XCIwMDY2MTA1NTk2NzMxXCIsXCJ0YXJnZXRcIjpcIjM5ZjAyMTg4MWU3Mzg2ZjhkNzNkNmVmMjU1MzNlNjA5MWYyYTAyNTZlNDIyYjRiM2M0ZTNkMzM1Y2NhZTE0N2VcIixcInRpdGxlXCI6XCJGbGFwcHlNb29uYmlyZFwiLFwiYm9keVwiOlwiU28gZnVuIHRvIHBsYXkgaW4gbXkgc3BhcmUgdGltZS5cIn0iLCJkaWdlc3QiOiI1NDQxYzhiZWZjMjNhY2JiODcyNjcwZmM2NjI3MzBkOWU1NWM0NDMyYjI3ZjEyODQyMTZmMjI4MmM1MTZmMWUwIiwic2lnbmF0dXJlIjoiMHgzNTZlMmRkNmI2NmQ4MjEwMDZjNWMxMDk0ZDRkZDk0ZjA5MTJmNjZkMTVmZDc4OTc1YmY4MmE0MzJlMDcwNjE5YmZkMjE0ODg5OTU4MmVkN2M5NWYwNTExMmE0MDBhYmU2MzcyOTdhMmExYTJkYjVkYjMzMjIyODFmNWZhOWE1ZCIsInNpZ25pbmdLZXkiOnsicHVibGljS2V5IjoiTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFbWs3aks3M2Uwb0FyQjJyS0VpclVvSjZ1Mmp1N3ZVQnRLSGozckdTSDFGQVJka1UvTUVPd2x5blZ2czltMHFEOVFhV2hmVU1pUXhNb2x0c2dvN2gzRlE9PSIsImZvcm1hdCI6IlN1YmplY3RQdWJsaWNLZXlJbmZvIiwiYWxnb3JpdGhtIjoiRVMyNTYifSwic2lnbmluZ0tleUF1dGgiOnsiYWRkcmVzcyI6IjB4MGYwMTIzMGYwNjVkYjljMzQ4ZDNmZTZjNThlODZkNGRlMjk1MDhlZiIsInNpZ25pbmdLZXlTaWduYXR1cmUiOiIweDE4MmU3ZmM2YzhjYjI2YTExNzJiMDk0YjEwOWI3Y2FjNTBiOWVkYmE4ZDE4ZjgyZDJkN2ZjODI5ZTcwZGI3OGQ0ZDUyMTI1ZjkzMDNmMWFhZDFjNGQ4MmU3YjAzMWQyNDNhM2FmN2Y0NWMwOGVjN2JlMGQ4ZTExMDM4YjcwY2Q5MWMiLCJzaWduaW5nS2V5TWVzc2FnZSI6IkkgYXV0aG9yaXplIEN5YmVyQ29ubmVjdCBmcm9tIHRoaXMgZGV2aWNlIHVzaW5nIHNpZ25pbmcga2V5OlxuTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFbWs3aks3M2Uwb0FyQjJyS0VpclVvSjZ1Mmp1N3ZVQnRLSGozckdTSDFGQVJka1UvTUVPd2x5blZ2czltMHFEOVFhV2hmVU1pUXhNb2x0c2dvN2gzRlE9PSJ9fQEAQWbiM7sww_5Us231eAaPVnM7FPqcGlMV0c-8rLTO2sKuZnsqcx21n29y1vQgTklGcxyLOOVTjxokynhjtwmnJsYUYvT0LSnYjFvNQtjv7HnPKGtAafL2ns4th8B4ImVqeb3SznqnAZ6PH5Q1lNe9R1YxpyQ_HahuL3g00nOSastUaLMCAdPBQdGsfyu-Y3k2XhxDXa8V0EQWTFrhPtGZzZl8zr0D9pktOni79gQT9aVq_3CJPRuiYNjfZlCFun1TdlA_AIIK-LaGDrwfV5DAsDX5-WtsrccL6dWe0ULHY3mfNvBSi0nn0wPG30K4WAPS7VDCg5mYDJfS1lv0p65w4A1sJzMrSmgZ6ohb_XTwn1wb-5h-E_wom6wJqFlVpSGMspUPqgi1Ycp46Qa8elWSPTF1zHjQtOUWACHjkKPElFak98ZThdM4LYQ7tOdDPAJCdINejMAtr3lrVHTdkza68oSFs1g8Ob5K5n-bmE67uK9EkXIx1fqfZuU46asBXkIqK9DkMtSjIAd16ghHGyamDXNPtKZm3Z6oS7jH5YrwXp5afOa30-RagepyS5f6jwb4HRUPxhweyqE6LJ812y_CZF4uW352tdOKNStGZTA6QddobGPHZdn-j8D7MiZSgnUlhYQMedLQPmxLPS5ypPt6TagQ6MneHyTV9H2Ldcc_rMyc-BftbJWhOdPEW3IwfMr-LJD2MpO5M289kO-kpfKtoi6M3vFwLg28ndonzOyxQsVA2CqILlxDailsU6GDQDsYsgGRc3BJXAPkEF8ccKyJX6bCOOp26OWXPL6lHkEK-9XYVng-VUCCzFfyEIRBQ1Wk7n-AhJIT9J4u5FZeWF1JFEjh0YU1absTvlknN46f8LmFkK5CMh2BL9r47__m_YyoFCUoNR23DnileeJSRkDhSE9c2BwbBW90EOzJsIl4z_9qRUOENatjqeoY6jMd-shRLVVH8J2jgs_nsOVKQ87B9vzUwMGRiPM-7Udg1MsRQJxaI23DT5hXuPh4PH9rmnp6w2IhkidcrcMkbDZrg1rt70XJEtbNI0-13nhizSqNwZhNXAkm-Xh7qgTtsw9cpKm0CJ6I7eOEKcMVE6Xhabc1fZrUgTgNlh-TWFGOGLjun1OBtmYGTDz_XLmu6d4BvhmY7I7WOI7FDqZAIE74BCmigedpw2VC2CHLTmVFHmSp0mwMRxlm5Kmnie5AlPt-QGOZE5vDWU6qenIMHCsQUpD_dy3Xa2g8so3qN9N1hTudo5jTF7038O5atWXNZkOO-S5yItnbk_pUjgjiutFsm7BUCTlFcE9XhFxe4f7xJk-W6KVDq1_KAsMRVB4XyW2WtEzESaOhQ30YqQ-N-bJnOx6WaQAACAAAAAAAAAB9AQAAAAAAAA_yBRhDb250ZW50LVR5cGUgYXBwbGljYXRpb24vanNvbhZBcHBsaWNhdGlvbhhDeWJlckNvbm5lY3QUQ29udGVudC1JZIABNTU3ZmM5ZDBkODgzYzU3NDU0YjNhMTE2OTBkN2YyYmMzYWUyYjAyZDcxOTVhMTdiYjkwYWQ4ZDEyYWU1NTBhNRxDb250ZW50LURpZ2VzdIABNTU3ZmM5ZDBkODgzYzU3NDU0YjNhMTE2OTBkN2YyYmMzYWUyYjAyZDcxOTVhMTdiYjkwYWQ4ZDEyYWU1NTBhNRxDb250ZW50LUF1dGhvchhtYXdtdnMxcml3bHEOQ2hhaW5JZAQ1NhxDb250ZW50LVRhcmdldIABMzlmMDIxODgxZTczODZmOGQ3M2Q2ZWYyNTUzM2U2MDkxZjJhMDI1NmU0MjJiNGIzYzRlM2QzMzVjY2FlMTQ3ZQxTb3VyY2VIMTU1MzFmYTItMTIwNS00ZjYxLWI2ZTQtYzlmNjhlY2Y4MWY3AHsiY29udGVudCI6IntcIm9wXCI6XCJjb21tZW50XCIsXCJhZGRyZXNzXCI6XCIweDYxMzA4MTIyNWExNGI0OGYzMWFmZmIzNzNhYTA0YTBlZDk5YzAxNDdcIixcInRzXCI6MTY5MTQ2MDYxOTg2OSxcImNoYWluSWRcIjo1NixcImhhbmRsZVwiOlwibWF3bXZzMXJpd2xxXCIsXCJ0YXJnZXRcIjpcIjM5ZjAyMTg4MWU3Mzg2ZjhkNzNkNmVmMjU1MzNlNjA5MWYyYTAyNTZlNDIyYjRiM2M0ZTNkMzM1Y2NhZTE0N2VcIixcInRpdGxlXCI6XCJGbGFwcHlNb29uYmlyZFwiLFwiYm9keVwiOlwiU28gZnVuIHRvIHBsYXkgaW4gbXkgc3BhcmUgdGltZS5cIn0iLCJkaWdlc3QiOiI1NTdmYzlkMGQ4ODNjNTc0NTRiM2ExMTY5MGQ3ZjJiYzNhZTJiMDJkNzE5NWExN2JiOTBhZDhkMTJhZTU1MGE1Iiwic2lnbmF0dXJlIjoiMHhmZTE3NTc0NGJkZjU3MDQ5MjljZmE5NzMwNDhiODM0ZTkxMTMyMjcwMmIxMTkyMjIyMzZhNDlmOGVmMDZlNTdjYjRiNTA1OTBjY2VjZjBmYjdkOTEzNWE5MmFlOTIwMDJjMGZkODQwODc3Mjg5NTNkODQ4YTNkOTI1ZjZkZGRjOSIsInNpZ25pbmdLZXkiOnsicHVibGljS2V5IjoiTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFWkQ4UXJmUktVc2ZkME9iTjdvZlEvZkN1K2N1akIrNlMvZVY3eml0dUlWa3lId2d6UlBRejZBVUJSaFRYQVRNSGZNemRMQmNCQ2phTFE2ZWtjbGhpeFE9PSIsImZvcm1hdCI6IlN1YmplY3RQdWJsaWNLZXlJbmZvIiwiYWxnb3JpdGhtIjoiRVMyNTYifSwic2lnbmluZ0tleUF1dGgiOnsiYWRkcmVzcyI6IjB4NjEzMDgxMjI1YTE0YjQ4ZjMxYWZmYjM3M2FhMDRhMGVkOTljMDE0NyIsInNpZ25pbmdLZXlTaWduYXR1cmUiOiIweGFmOGZmY2UyYjMyZGI5ZGIxNzJjZTdmMDI4OTc0ODMwZDliMmY1YjI1YWNkMzMwOWVkNGEwY2VhODRmZjFjOGQ1MDQ1NjRiY2UzZDNjZmYxMTkxOGNhYjUzNzNjYzFkNDM0MDU1OTNmNGIzOGVlOTVlZDE4MzFkNzNkMDlhMDI0MWMiLCJzaWduaW5nS2V5TWVzc2FnZSI6IkkgYXV0aG9yaXplIEN5YmVyQ29ubmVjdCBmcm9tIHRoaXMgZGV2aWNlIHVzaW5nIHNpZ25pbmcga2V5OlxuTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFWkQ4UXJmUktVc2ZkME9iTjdvZlEvZkN1K2N1akIrNlMvZVY3eml0dUlWa3lId2d6UlBRejZBVUJSaFRYQVRNSGZNemRMQmNCQ2phTFE2ZWtjbGhpeFE9PSJ9fQEAjrnmlMttmqdj5USxoJyAfCOFt-hjCsTQQ3c98q9-jSNHbe6oSfQngjqG5C30nMI5OkoWDYHulfVeqDBoLeepmYDR_BHQKURXfadEXzqrtt4Cn8HMXgULO7DuF7iXZ9eec3WQvCbtFhUy-MwszxRw7kMqkTdYxVj9Hp8Qx3_eJe6JFus1MNJSZN-PC6w1R9t-vnDD-c8RNrjcwwwdRFY1DRH1POCQnOOJg0KyO8837G1IaoFc9hickgk5gw3ykyWqspmcMPDHFSGJt6eYSq67O0Ez-TPhPPURxaKWHlLG4_QbEHKWuJTjNMo-X6bElDLZfdF1wgQ-5Ja_8rJZ29m78e7lnnzeToqKAlitvg0LPl7-T20l0E4_VHi32YkiYMDDDZ49sRR7Ygm0bIpP6CclJCF0tBnEJQe_VQ3BiPxv9JxOOXewXhPAKKyZnOHgDN6p-_g9joHXDyD_1H-EdXpltIKBAumKjJAloqP9J9FDaCwqULqQmi0u_zC2Xwbq-tPurRKG_evsJlbVEEFJe6-HNaSCrMEgKRPjjgHmxBjQIj5wGv_ZTLkpbtdZ3ZL5tMPu2GhIEgudhKj5eW3NXjyW2sX6nXBz1JbF30vFIMmBupJTJ5m9rhnflUeCKS466QROfb844dpQTtfZVWwunMHOU_Yh9WlQvxnINdRR_fX616mc-BftbJWhOdPEW3IwfMr-LJD2MpO5M289kO-kpfKtoi6M3vFwLg28ndonzOyxQsVA2CqILlxDailsU6GDQDsYsgGRc3BJXAPkEF8ccKyJX6bCOOp26OWXPL6lHkEK-9XYVng-VUCCzFfyEIRBQ1Wk7n-AhJIT9J4u5FZeWF1JFEjh0YU1absTvlknN46f8LmFkK5CMh2BL9r47__m_YyoFCUoNR23DnileeJSRkDhSE9c2BwbBW90EOzJsIl4z_9qRUOENatjqeoY6jMd-shRLVVH8J2jgs_nsOVKQ87B9vzUwMGRiPM-7Udg1MsRQJxaI23DT5hXuPh4PH9rmnp6w2IhkidcrcMkbDZrg1rt70XJEtbNI0-13nhizSqNwZhNXAkm-Xh7qgTtsw9cpKm0CJ6I7eOEKcMVE6Xhabc1fZrUgTgNlh-TWFGOGLjun1OBtmYGTDz_XLmu6d4BvhmY7I7WOI7FDqZAIE74BCmigedpw2VC2CHLTmVFHmSp0mwMRxlm5Kmnie5AlPt-QGOZE5vDWU6qenIMHCsQUpD_dy3Xa2g8so3qN9N1hTudo5jTF7038O5atWXNZkOO-S5yItnbk_pUjgjiutFsm7BUCTlFcE9XhFxe4f7xJk-W6KVDq1_KAsMRVB4XyW2WtEzESaOhQ30YqQ-N-bJnOx6WaQAACAAAAAAAAAB9AQAAAAAAAA_yBRhDb250ZW50LVR5cGUgYXBwbGljYXRpb24vanNvbhZBcHBsaWNhdGlvbhhDeWJlckNvbm5lY3QcQ29udGVudC1EaWdlc3SAATVlZWJjNmM2NzZmNzMyN2JkZjkzNDkzYmIxMzM2ZmQ5Yzk5MWUyNzQ0ODlhODdmZjczY2EwZTcwODNkNDQwOTUcQ29udGVudC1BdXRob3IYOTFpZG9ybnh2ZmczDkNoYWluSWQENTYcQ29udGVudC1UYXJnZXSAATM5ZjAyMTg4MWU3Mzg2ZjhkNzNkNmVmMjU1MzNlNjA5MWYyYTAyNTZlNDIyYjRiM2M0ZTNkMzM1Y2NhZTE0N2UMU291cmNlSDE1NTMxZmEyLTEyMDUtNGY2MS1iNmU0LWM5ZjY4ZWNmODFmNxRDb250ZW50LUlkgAE1ZWViYzZjNjc2ZjczMjdiZGY5MzQ5M2JiMTMzNmZkOWM5OTFlMjc0NDg5YTg3ZmY3M2NhMGU3MDgzZDQ0MDk1AHsiY29udGVudCI6IntcIm9wXCI6XCJjb21tZW50XCIsXCJhZGRyZXNzXCI6XCIweDZmNGE5Mjk5OWJhZDc0OWY5MWZlMzJhNjIyYjhlM2VmNDE2MzY3MDVcIixcInRzXCI6MTY5MTQ2MDYxOTM5MixcImNoYWluSWRcIjo1NixcImhhbmRsZVwiOlwiOTFpZG9ybnh2ZmczXCIsXCJ0YXJnZXRcIjpcIjM5ZjAyMTg4MWU3Mzg2ZjhkNzNkNmVmMjU1MzNlNjA5MWYyYTAyNTZlNDIyYjRiM2M0ZTNkMzM1Y2NhZTE0N2VcIixcInRpdGxlXCI6XCJGbGFwcHlNb29uYmlyZFwiLFwiYm9keVwiOlwiU28gZnVuIHRvIHBsYXkgaW4gbXkgc3BhcmUgdGltZS5cIn0iLCJkaWdlc3QiOiI1ZWViYzZjNjc2ZjczMjdiZGY5MzQ5M2JiMTMzNmZkOWM5OTFlMjc0NDg5YTg3ZmY3M2NhMGU3MDgzZDQ0MDk1Iiwic2lnbmF0dXJlIjoiMHg2ZDUzZDcwNzc2ZGIyMWNmNDY1NjMzNTJlMWY4MGIyNzE1ZDg2YzA3ZGNmMThjNjcxZmM1YWU2NjY4NDAzN2Q5MWRhNTJkYzJlZmJiYzQzZjk2NWI5YjQ3Y2ZhZjBiNGNkYTg1NGE3ZWFhZGEzOTVhYTk0M2JmMGUzZDBmNjI2MiIsInNpZ25pbmdLZXkiOnsicHVibGljS2V5IjoiTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFOVc5eGhjN2lucUtWRWxRL05zNnpqdTlrcXpEVkNQSTRNWmxxVkFyWTF5djRzV3IwSEIycEloazZOUjlycW1ha2Jza2Z2VzRoUjgzU0k1UGxLZEJiL3c9PSIsImZvcm1hdCI6IlN1YmplY3RQdWJsaWNLZXlJbmZvIiwiYWxnb3JpdGhtIjoiRVMyNTYifSwic2lnbmluZ0tleUF1dGgiOnsiYWRkcmVzcyI6IjB4NmY0YTkyOTk5YmFkNzQ5ZjkxZmUzMmE2MjJiOGUzZWY0MTYzNjcwNSIsInNpZ25pbmdLZXlTaWduYXR1cmUiOiIweDQ5MzAyMGY1MzgxYTkwY2E5NzQ4MGU5ZDNjNGRiN2Y4MjE4NWMyYjMyZjczNjYxMjA0MjFhMDk1NTVjYTZkZGE2YWM5Y2Q4OGEzYjBhNzE2MTczNGQ0ZDNiYzQyM2EzYjk2YTRhMmJmYTZkNzU2MDJmMDFkYWRkYmExNmFlMjQyMWIiLCJzaWduaW5nS2V5TWVzc2FnZSI6IkkgYXV0aG9yaXplIEN5YmVyQ29ubmVjdCBmcm9tIHRoaXMgZGV2aWNlIHVzaW5nIHNpZ25pbmcga2V5OlxuTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFOVc5eGhjN2lucUtWRWxRL05zNnpqdTlrcXpEVkNQSTRNWmxxVkFyWTF5djRzV3IwSEIycEloazZOUjlycW1ha2Jza2Z2VzRoUjgzU0k1UGxLZEJiL3c9PSJ9fQEAkAh0rKMc6sJlO4yZoP6oexiYJjklR2yvaOauUJt4aYIQjIc3IWjTjTdQEBC3KST5zlFadDi-8D-sY4O0IOFkE5JfOVIjPe5PBDw10YY_eydOF73KYdEebEjcWiLWQMtbE64HbElsetrRqZBmrMcEgqDs815rwoXUvCfqGZ8NSt9LanXE5BFVWMbfJlDXiQ5gXBGYk44aCTli1KRBdsF3KwQLEOci-3t9LkQTMU7adLwzxbSh-oJFZsBq-gZSuDfaQzeHwzhicPzZ-Qoq80nZW0I-W8f4W1NnRnUL6qJcLJcCamR0aeqioc7286v6FgSNOu7wqCfmzx7JEWNS0De7ZhP3LkFf3K1Fwpl23M_MFlWAzdSZg5JuigWjsH4GSAWIKW7-7XdgjFi6WwEC7yzzUaSKeIqdopjtmOmALeKvbYzmfsiXiM20pz-dgOPsEn3upopgENfr_GhoEzCh3e_rQ66Xc9tAO6ZKaNi8whN90nehJc7tOR9JSFLPveS03gVEYIA9BffkAdZHDmh--EZWgenU67VKDAOJtoi_rzYJo_ylQ1HKUEcclFw67rCuih5HJlGhZKRdxgBkzo43tdwRgK_e-__3tOo_2UdM5sJJ2bDgf8m-bJkI3RJhOHDvLl3k3T9F1xJRCMzm7-v8FLH_g-PbwX1SI5S8iVRRYM3-ynKc-BftbJWhOdPEW3IwfMr-LJD2MpO5M289kO-kpfKtoi6M3vFwLg28ndonzOyxQsVA2CqILlxDailsU6GDQDsYsgGRc3BJXAPkEF8ccKyJX6bCOOp26OWXPL6lHkEK-9XYVng-VUCCzFfyEIRBQ1Wk7n-AhJIT9J4u5FZeWF1JFEjh0YU1absTvlknN46f8LmFkK5CMh2BL9r47__m_YyoFCUoNR23DnileeJSRkDhSE9c2BwbBW90EOzJsIl4z_9qRUOENatjqeoY6jMd-shRLVVH8J2jgs_nsOVKQ87B9vzUwMGRiPM-7Udg1MsRQJxaI23DT5hXuPh4PH9rmnp6w2IhkidcrcMkbDZrg1rt70XJEtbNI0-13nhizSqNwZhNXAkm-Xh7qgTtsw9cpKm0CJ6I7eOEKcMVE6Xhabc1fZrUgTgNlh-TWFGOGLjun1OBtmYGTDz_XLmu6d4BvhmY7I7WOI7FDqZAIE74BCmigedpw2VC2CHLTmVFHmSp0mwMRxlm5Kmnie5AlPt-QGOZE5vDWU6qenIMHCsQUpD_dy3Xa2g8so3qN9N1hTudo5jTF7038O5atWXNZkOO-S5yItnbk_pUjgjiutFsm7BUCTlFcE9XhFxe4f7xJk-W6KVDq1_KAsMRVB4XyW2WtEzESaOhQ30YqQ-N-bJnOx6WaQAACAAAAAAAAAB9AQAAAAAAAA_yBRhDb250ZW50LVR5cGUgYXBwbGljYXRpb24vanNvbhZBcHBsaWNhdGlvbhhDeWJlckNvbm5lY3QUQ29udGVudC1JZIABOWY5MGYwOTdkMzJlNzkyZDQyMjNkZGM3ZTJmMmU1ODhjYjNkMGEyYzZjNzMzMmZmNmEzZTI3MGQ5ZDE2NDhlZBxDb250ZW50LURpZ2VzdIABOWY5MGYwOTdkMzJlNzkyZDQyMjNkZGM3ZTJmMmU1ODhjYjNkMGEyYzZjNzMzMmZmNmEzZTI3MGQ5ZDE2NDhlZBxDb250ZW50LUF1dGhvchhkbjYzYTdkYTdvM2IOQ2hhaW5JZAQ1NhxDb250ZW50LVRhcmdldIABMzlmMDIxODgxZTczODZmOGQ3M2Q2ZWYyNTUzM2U2MDkxZjJhMDI1NmU0MjJiNGIzYzRlM2QzMzVjY2FlMTQ3ZQxTb3VyY2VIMTU1MzFmYTItMTIwNS00ZjYxLWI2ZTQtYzlmNjhlY2Y4MWY3AHsiY29udGVudCI6IntcIm9wXCI6XCJjb21tZW50XCIsXCJhZGRyZXNzXCI6XCIweGQ1ZDkxMTc2ZGIxYjIyMjk4YTMzNGI5YzMzMmZiYTJmM2MzZGYwMmJcIixcInRzXCI6MTY5MTQ2MDYxOTQyMixcImNoYWluSWRcIjo1NixcImhhbmRsZVwiOlwiZG42M2E3ZGE3bzNiXCIsXCJ0YXJnZXRcIjpcIjM5ZjAyMTg4MWU3Mzg2ZjhkNzNkNmVmMjU1MzNlNjA5MWYyYTAyNTZlNDIyYjRiM2M0ZTNkMzM1Y2NhZTE0N2VcIixcInRpdGxlXCI6XCJGbGFwcHlNb29uYmlyZFwiLFwiYm9keVwiOlwiU28gZnVuIHRvIHBsYXkgaW4gbXkgc3BhcmUgdGltZS5cIn0iLCJkaWdlc3QiOiI5ZjkwZjA5N2QzMmU3OTJkNDIyM2RkYzdlMmYyZTU4OGNiM2QwYTJjNmM3MzMyZmY2YTNlMjcwZDlkMTY0OGVkIiwic2lnbmF0dXJlIjoiMHg3YzMyNzZiN2RkZDExYTA0MWE1NWYwMGJkNTIxOTIxNDA4MDgxYWQ4MDk5Yzk1YzZiNTI1YWI4MmM4MmZmNThiMGRlN2QyZmQ1NmJmODJkZjAzNGYyMzkzNGRlNDY2YmUwZTcyOTUyNjUyMTQyMDQzODk4M2M1ODkwOTAwMDQzNyIsInNpZ25pbmdLZXkiOnsicHVibGljS2V5IjoiTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFNGVCRTBMcXJFS1Q4NHMvZkgvL2RmK1NYeUFTRnVQNzZxNkJ3T05tcU0wWGlCUzNnR25DTHEyam9vVkZCUXhVYUxkeFJTRnp2U0w0blFRU291NHpiK0E9PSIsImZvcm1hdCI6IlN1YmplY3RQdWJsaWNLZXlJbmZvIiwiYWxnb3JpdGhtIjoiRVMyNTYifSwic2lnbmluZ0tleUF1dGgiOnsiYWRkcmVzcyI6IjB4ZDVkOTExNzZkYjFiMjIyOThhMzM0YjljMzMyZmJhMmYzYzNkZjAyYiIsInNpZ25pbmdLZXlTaWduYXR1cmUiOiIweDQwNTI1NGRmYjY0YmY4YzM3ZjFjMTIyNjYwOGI1ZDliZTQ4YWJmMmEwNjUzZjhhZDZlMmQ0ZDA1NTk5MDUxZTIyMTJiZDdjZGJiNTM3YjJjZDc5MWUwODkxZmU3MzcxMTFjOTM3OWQxZDY5MDkyYjZiYTZmZDNiYjhkOWE0YWQzMWMiLCJzaWduaW5nS2V5TWVzc2FnZSI6IkkgYXV0aG9yaXplIEN5YmVyQ29ubmVjdCBmcm9tIHRoaXMgZGV2aWNlIHVzaW5nIHNpZ25pbmcga2V5OlxuTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFNGVCRTBMcXJFS1Q4NHMvZkgvL2RmK1NYeUFTRnVQNzZxNkJ3T05tcU0wWGlCUzNnR25DTHEyam9vVkZCUXhVYUxkeFJTRnp2U0w0blFRU291NHpiK0E9PSJ9fQEAZI4AV8tE7Ly8f6711NK5XCYbc5P5w6lx4s1JTeyC1lDtySrlLEgQHc7Kqra94ZtTz0ywgi2fUu7BCfyrIgKSFGPvGEiJ9IrxwXAfULUkwaRQVnFdAp7ZIFXWkGSFv2LTlBEHBg8-dflIQhbo77-fisDCpwP5cNzR2s2zk2JevhCtiA6nSbe6Y6V7JlL-yZ7wT3cujH1yA4jgZzLECOlOAdWU8J8NNIU_RGK9YsVv4_XUimaWv6XmVnn16t9lsCF-eGRNF3fqRcSXR5vhvz5CfuO4Cq2m8-mhKbdnbXAA8OpfmXRpF8FINXq9XeTNUN7FEbSzcqjXvISE7nCuSSQiGBolf4_RS-rhLtwYPBauSsLp2B9Nx_duKjry-7MFZp1Jzp1qksttfx3arm7BY2DdebaYexiOk7bgm33X5ZKLu1Jld6RWToIzJTIztlhzwQIggyMNpkKDxUS63C5qohu-6rCH1j_FQvcKcTTDDDA19sTCr9RD6vg5OUq541LqA75_0bzFilkxe4F877AZ9DS1xix44sGym87_8FHWPxSBxK10S2S9a0Zn-1DMb7zig4TSlRxMrDusDFIW46Kjm6ptIjeAqDaRGN_AgWm_Ao8rOCiudKVdCr4HYTg0KWs1fz8IQpPL7CY8E89EH5SXewIoM2LKxHV3zH4MpPt4BmpZa8yc-BftbJWhOdPEW3IwfMr-LJD2MpO5M289kO-kpfKtoi6M3vFwLg28ndonzOyxQsVA2CqILlxDailsU6GDQDsYsgGRc3BJXAPkEF8ccKyJX6bCOOp26OWXPL6lHkEK-9XYVng-VUCCzFfyEIRBQ1Wk7n-AhJIT9J4u5FZeWF1JFEjh0YU1absTvlknN46f8LmFkK5CMh2BL9r47__m_YyoFCUoNR23DnileeJSRkDhSE9c2BwbBW90EOzJsIl4z_9qRUOENatjqeoY6jMd-shRLVVH8J2jgs_nsOVKQ87B9vzUwMGRiPM-7Udg1MsRQJxaI23DT5hXuPh4PH9rmnp6w2IhkidcrcMkbDZrg1rt70XJEtbNI0-13nhizSqNwZhNXAkm-Xh7qgTtsw9cpKm0CJ6I7eOEKcMVE6Xhabc1fZrUgTgNlh-TWFGOGLjun1OBtmYGTDz_XLmu6d4BvhmY7I7WOI7FDqZAIE74BCmigedpw2VC2CHLTmVFHmSp0mwMRxlm5Kmnie5AlPt-QGOZE5vDWU6qenIMHCsQUpD_dy3Xa2g8so3qN9N1hTudo5jTF7038O5atWXNZkOO-S5yItnbk_pUjgjiutFsm7BUCTlFcE9XhFxe4f7xJk-W6KVDq1_KAsMRVB4XyW2WtEzESaOhQ30YqQ-N-bJnOx6WaQAABwAAAAAAAAAMAQAAAAAAAA2QBBhDb250ZW50LVR5cGUgYXBwbGljYXRpb24vanNvbhZBcHBsaWNhdGlvbhhDeWJlckNvbm5lY3QUQ29udGVudC1JZIABMmYwMzgyN2M1NTNkOTAzYWNlZDcxNTY5OWEyMzFjMDk0YzQzMmZiMzhlZDBlNDZhNjkwOWRmZjA0OWFjOTIyYhxDb250ZW50LURpZ2VzdIABMmYwMzgyN2M1NTNkOTAzYWNlZDcxNTY5OWEyMzFjMDk0YzQzMmZiMzhlZDBlNDZhNjkwOWRmZjA0OWFjOTIyYhxDb250ZW50LUF1dGhvchhscmczNnc3MmEydHEOQ2hhaW5JZAQ1NgxTb3VyY2UIYXRlbQB7ImNvbnRlbnQiOiJ7XCJvcFwiOlwicG9zdFwiLFwiYWRkcmVzc1wiOlwiMHg2M2NkNzhlZDVjOGIzZDdmMGYxMjJjOThmMDRjMmE3YTYyN2JhOGIzXCIsXCJ0c1wiOjE2OTE0NjA2MTkzNDQsXCJjaGFpbklkXCI6NTYsXCJoYW5kbGVcIjpcImxyZzM2dzcyYTJ0cVwiLFwidGl0bGVcIjpcIjExMTEyXCIsXCJib2R5XCI6XCIyMjIyMjIyMjIyMjIyMjIyMjJcIn0iLCJkaWdlc3QiOiIyZjAzODI3YzU1M2Q5MDNhY2VkNzE1Njk5YTIzMWMwOTRjNDMyZmIzOGVkMGU0NmE2OTA5ZGZmMDQ5YWM5MjJiIiwic2lnbmF0dXJlIjoiMHgzZmQyZDFmNDdmZTM3ZWMyNmNkMGE1OTVmOTEwYTYxMWRlNDM1MWM0ZjEzMWJhOTg4ZWY2ZGYxMTNlMzE3ZTlmZmMxZjk3MjkwMTk4ZjcxZWFlMDg0MGI5MDM2NGYwZDdhODA1ZDhjYzM5YjhiYzMzYTA4MjkwYWE0YjcwNGU4MSIsInNpZ25pbmdLZXkiOnsicHVibGljS2V5IjoiTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFejhOdHN1TGdiWFpaekdkajZ4NnFLTVp0S0tkSEIzM0MvNjdUT2F2aXNLczhNY1dnS0hMaEhNVUxmUjhBZjhXSk11YUJvcFVORUJHSjlOcndWaUNITGc9PSIsImZvcm1hdCI6IlN1YmplY3RQdWJsaWNLZXlJbmZvIiwiYWxnb3JpdGhtIjoiRVMyNTYifSwic2lnbmluZ0tleUF1dGgiOnsiYWRkcmVzcyI6IjB4NjNjZDc4ZWQ1YzhiM2Q3ZjBmMTIyYzk4ZjA0YzJhN2E2MjdiYThiMyIsInNpZ25pbmdLZXlTaWduYXR1cmUiOiIweGYwMzExOTdhN2M3OTEzNmI3OTNkZDYzNmY3ZjhiZDY4MjFiZmNmOTJhYmI3NDE2YTRhNTQwZTgyOTdmMjk0YTQ3NjFiYmM5Y2NmZmU3M2I1MWIzZTc0ZjY4NGU0NjQ4OGE5MjVhM2VkOWYzNDYyOTAwZmNhYzZhYzA2MzNiNmY1MWIiLCJzaWduaW5nS2V5TWVzc2FnZSI6IkkgYXV0aG9yaXplIEF0ZW1SZXZpZXcgZnJvbSB0aGlzIGRldmljZSB1c2luZyBzaWduaW5nIGtleTpcbk1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRXo4TnRzdUxnYlhaWnpHZGo2eDZxS01adEtLZEhCMzNDLzY3VE9hdmlzS3M4TWNXZ0tITGhITVVMZlI4QWY4V0pNdWFCb3BVTkVCR0o5TnJ3VmlDSExnPT0ifX0BAEu5x3Usma1zD3MSvE6GBWqsczzjBQvqobYYtD6wUygmB7ASUDv138eUZndcTY2PgkC0WzoghvLnSXDm0pptOnpv5HbNRfJ-luipdZHoUam9K0t23arG2Rj5uixIxI6M_X2MCT8rY4nMMGGjwAE-Rff5JLNAcRekNgauzfwI4vkSWJ6MTIpIot3t3X_QFv0D7G1Y4Mlev36Juv939S81Id5EBnrWqGDTlU4ezrrHZSjmUtBYNX8_gCLjIu1KE82RLpI5L7R9w934OurQLCUrhDGAaTVsU8ejJ0e5SFBHnM0K-vXTS52LIxQ4uM1lopdzdLyvNjMICISj3Ds5R-9ICnCqvAh3TZr22t21P3cayHasZBI3E61XcWUsKpSrMS9FoIUcD6RfyJvTURPJG9GjYuLo-rZXL1LELM4Jx2zmKeuDv33Ug3duSYQaBzEUNCPWnLe1-jdze44kYmc6R8xQ9zs2cKw6C9htviMPbQVWdrj1L5Tk6nhDafj8RnwJ_0tAVtb3yiefxN4NB_Q5j2vpyhSWDtR0MSwn9QcXyUyrHu9nX480HijHgWbZvJXIuK5KAZ8GmcO9jdQmMHEwYghfJJG0LrTEhk5Pea7nX6foFr8xLIR44GVMzZZV27FjzC-gmeH_z_fhq9YoC6ASp3IJ1tL4_68umOfVNsHu05LX_w5wnPgX7WyVoTnTxFtyMHzK_iyQ9jKTuTNvPZDvpKXyraIujN7xcC4NvJ3aJ8zssULFQNgqiC5cQ2opbFOhg0A7GLIBkXNwSVwD5BBfHHCsiV-mwjjqdujllzy-pR5BCvvV2FZ4PlVAgsxX8hCEQUNVpO5_gISSE_SeLuRWXlhdSRRI4dGFNWm7E75ZJzeOn_C5hZCuQjIdgS_a-O__5v2MqBQlKDUdtw54pXniUkZA4UhPXNgcGwVvdBDsybCJeM__akVDhDWrY6nqGOozHfrIUS1VR_Cdo4LP57DlSkPOwfb81MDBkYjzPu1HYNTLEUCcWiNtw0-YV7j4eDx_a5p6esNiIZInXK3DJGw2a4Na7e9FyRLWzSNPtd54Ys0qjcGYTVwJJvl4e6oE7bMPXKSptAieiO3jhCnDFROl4Wm3NX2a1IE4DZYfk1hRjhi47p9TgbZmBkw8_1y5runeAb4ZmOyO1jiOxQ6mQCBO-AQpooHnacNlQtghy05lRR5kqdJsDEcZZuSpp4nuQJT7fkBjmRObw1lOqnpyDBwrEFKQ_3ct12toPLKN6jfTdYU7naOY0xe9N_DuWrVlzWZDjvkuciLZ25P6VI4I4rrRbJuwVAk5RXBPV4RcXuH-8SZPluilQ6tfygLDEVQeF8ltlrRMxEmjoUN9GKkPjfmyZzselmkAAAgAAAAAAAAAfQEAAAAAAAAP8gUYQ29udGVudC1UeXBlIGFwcGxpY2F0aW9uL2pzb24WQXBwbGljYXRpb24YQ3liZXJDb25uZWN0DkNoYWluSWQENTYcQ29udGVudC1UYXJnZXSAATM5ZjAyMTg4MWU3Mzg2ZjhkNzNkNmVmMjU1MzNlNjA5MWYyYTAyNTZlNDIyYjRiM2M0ZTNkMzM1Y2NhZTE0N2UMU291cmNlSDE1NTMxZmEyLTEyMDUtNGY2MS1iNmU0LWM5ZjY4ZWNmODFmNxRDb250ZW50LUlkgAE0MGFmOTRhMWE4YTFiZGJhZDlmMjdjZTRlYmY4YTIxMzkwM2MyNjMyNGJlNjIxYmNlOTRkNmNjMjg4YzFhNjM2HENvbnRlbnQtRGlnZXN0gAE0MGFmOTRhMWE4YTFiZGJhZDlmMjdjZTRlYmY4YTIxMzkwM2MyNjMyNGJlNjIxYmNlOTRkNmNjMjg4YzFhNjM2HENvbnRlbnQtQXV0aG9yGGY0MDExNjUzMTIyeQB7ImNvbnRlbnQiOiJ7XCJvcFwiOlwiY29tbWVudFwiLFwiYWRkcmVzc1wiOlwiMHg2ZGIyMjY1ZWNiYjRmNDYxNDNiNmEyNjZiNWUxNDZkMWUyOGM4MjAyXCIsXCJ0c1wiOjE2OTE0NjA2MjAyMzUsXCJjaGFpbklkXCI6NTYsXCJoYW5kbGVcIjpcImY0MDExNjUzMTIyeVwiLFwidGFyZ2V0XCI6XCIzOWYwMjE4ODFlNzM4NmY4ZDczZDZlZjI1NTMzZTYwOTFmMmEwMjU2ZTQyMmI0YjNjNGUzZDMzNWNjYWUxNDdlXCIsXCJ0aXRsZVwiOlwiRmxhcHB5TW9vbmJpcmRcIixcImJvZHlcIjpcIlNvIGZ1biB0byBwbGF5IGluIG15IHNwYXJlIHRpbWUuXCJ9IiwiZGlnZXN0IjoiNDBhZjk0YTFhOGExYmRiYWQ5ZjI3Y2U0ZWJmOGEyMTM5MDNjMjYzMjRiZTYyMWJjZTk0ZDZjYzI4OGMxYTYzNiIsInNpZ25hdHVyZSI6IjB4NWViMGVkZWU4YjU3N2Q0MjllZmUxNTllZTVhNGIwMGNmNDRjZGYxODVmOGY2Zjc5Y2QwM2VmMjhiMzg4NWIzZWViNDg3NTU3NjlhZWMxN2Y4OGYzZDY3NWI5ZDZhY2RmZmQ0ODJkYmU3MmE5NjViMDY2YjAyZjVjMmRmZTMyYjEiLCJzaWduaW5nS2V5Ijp7InB1YmxpY0tleSI6Ik1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRVhHWU9VK21STlk5RzM5L1lzcWFBV0dqbGpyMC9GSHZlWWFFRmxSODlHcDdqQitMNFhmKzRGRjNiOTF0V0NBcGhaZ0N6NElNRVRtU0Q1Qit0QjdmSmt3PT0iLCJmb3JtYXQiOiJTdWJqZWN0UHVibGljS2V5SW5mbyIsImFsZ29yaXRobSI6IkVTMjU2In0sInNpZ25pbmdLZXlBdXRoIjp7ImFkZHJlc3MiOiIweDZkYjIyNjVlY2JiNGY0NjE0M2I2YTI2NmI1ZTE0NmQxZTI4YzgyMDIiLCJzaWduaW5nS2V5U2lnbmF0dXJlIjoiMHhlM2UxM2Q2NWJkNGMxOTkyMzgzMDBiMDIwYmIwOTUyNmNiOWQwZTk0NGE1MTQzYTA4MzUyZDBiZDU2YzNhYzZjNDFjYjUxMTYzYzg5YzIxNGViN2Q2MDMzZDc5MjcwYWUzMzE3YjU1NjJhMWQ1YWE2ZTk0NzgxYmU2OTEwYWEwMDFjIiwic2lnbmluZ0tleU1lc3NhZ2UiOiJJIGF1dGhvcml6ZSBDeWJlckNvbm5lY3QgZnJvbSB0aGlzIGRldmljZSB1c2luZyBzaWduaW5nIGtleTpcbk1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRVhHWU9VK21STlk5RzM5L1lzcWFBV0dqbGpyMC9GSHZlWWFFRmxSODlHcDdqQitMNFhmKzRGRjNiOTF0V0NBcGhaZ0N6NElNRVRtU0Q1Qit0QjdmSmt3PT0ifX0BACC2-5l3m6KnICUDwWqKYLcQGGED9In1BzfP_A3ZTKfMNXzE4RuLxoJzlBpyGK01dduflBTE02xHwYxVWF9yf1XSXm5vu4AZIf3CbNolzp0smMgaeEq15lmT736tKNd9lcFnV2iXwKN5p9Pkg0fP5CpRjbUVE7pcaYbSwevj_VVSADkmJgwatL_o2k6kyMD5OoRYL0Ipli1Y9ZsnvDu3RhhqudDPh0I39PLU72ZamHzzRM2Hhm6vL1hbcDHk11lE7TP8V0410hO8epHPIiIAncOaEb1OmhkNKkK4X2iyqtpjUYwCBhKDo2WaayQAcZimwh3WZmszM1GzbyxX0UMSczFidurhmWHZ3iHHSH4shDri5vMp7_3WFo6VxkPajaiG4f3EKDhM5-zO-LjLloLBODT9_mC_V24IvRYJ5Gz8t6NrTsSL5QWk4pgUCkxTz3gN6oxbgz08MkryOujba-cBUXYsjqnZasN931QEd70DSlYhL6sP7T9ettgctWyE7oRcgMiG2WzLfFqU3FTm-6IarLgGBkf5IHCXEy8aQ0q2DREexYHiMOb6f0w1ixQmncPB_VLastirPxsSAcZa1pkXNEqvmSmr8xXnUuPoQwmu9tKLYMOL_jkPczHAX1LD9U85nKEdctLhdnSoudxEhKx4Ho33HcStZmh0PZD1rbZ5uhVfnPgX7WyVoTnTxFtyMHzK_iyQ9jKTuTNvPZDvpKXyraIujN7xcC4NvJ3aJ8zssULFQNgqiC5cQ2opbFOhg0A7GLIBkXNwSVwD5BBfHHCsiV-mwjjqdujllzy-pR5BCvvV2FZ4PlVAgsxX8hCEQUNVpO5_gISSE_SeLuRWXlhdSRRI4dGFNWm7E75ZJzeOn_C5hZCuQjIdgS_a-O__5v2MqBQlKDUdtw54pXniUkZA4UhPXNgcGwVvdBDsybCJeM__akVDhDWrY6nqGOozHfrIUS1VR_Cdo4LP57DlSkPOwfb81MDBkYjzPu1HYNTLEUCcWiNtw0-YV7j4eDx_a5p6esNiIZInXK3DJGw2a4Na7e9FyRLWzSNPtd54Ys0qjcGYTVwJJvl4e6oE7bMPXKSptAieiO3jhCnDFROl4Wm3NX2a1IE4DZYfk1hRjhi47p9TgbZmBkw8_1y5runeAb4ZmOyO1jiOxQ6mQCBO-AQpooHnacNlQtghy05lRR5kqdJsDEcZZuSpp4nuQJT7fkBjmRObw1lOqnpyDBwrEFKQ_3ct12toPLKN6jfTdYU7naOY0xe9N_DuWrVlzWZDjvkuciLZ25P6VI4I4rrRbJuwVAk5RXBPV4RcXuH-8SZPluilQ6tfygLDEVQeF8ltlrRMxEmjoUN9GKkPjfmyZzselmkAAAcAAAAAAAAAEwEAAAAAAAANngQYQ29udGVudC1UeXBlIGFwcGxpY2F0aW9uL2pzb24WQXBwbGljYXRpb24YQ3liZXJDb25uZWN0FENvbnRlbnQtSWSAATU3YTlmNTE2NTNjYjg5OTc2MTY2ODJjOWRiNWQzNWFlNDc1MzFmYzYwNGJkZGMxMzBlMDk1OWJmOTY3MTA4NTQcQ29udGVudC1EaWdlc3SAATU3YTlmNTE2NTNjYjg5OTc2MTY2ODJjOWRiNWQzNWFlNDc1MzFmYzYwNGJkZGMxMzBlMDk1OWJmOTY3MTA4NTQcQ29udGVudC1BdXRob3IcaGllbmRoMTEyMjAwMjMOQ2hhaW5JZAQ1NgxTb3VyY2USY3liZXJ0dW5lAHsiY29udGVudCI6IntcIm9wXCI6XCJwb3N0XCIsXCJhZGRyZXNzXCI6XCIweGQwOTA2OTE4ZDRiZGYyZDc3NWY5OTExZWNiOTVhZWQzYjAxMjY1OGFcIixcInRzXCI6MTY5MTQ2MDYyMDYzMSxcImNoYWluSWRcIjo1NixcImhhbmRsZVwiOlwiaGllbmRoMTEyMjAwMjNcIixcInRpdGxlXCI6XCI1NDU0NVwiLFwiYm9keVwiOlwiNDU0NVwifSIsImRpZ2VzdCI6IjU3YTlmNTE2NTNjYjg5OTc2MTY2ODJjOWRiNWQzNWFlNDc1MzFmYzYwNGJkZGMxMzBlMDk1OWJmOTY3MTA4NTQiLCJzaWduYXR1cmUiOiIweGEwZDE4YzMxNTMxYTM3ODYxMjUzYTcwZWE0NmQ1MzZiZmUwNmNiMGY4YTJmZjYxYzZiOGIwOWE0MmJiNTM0MmIyMWZkMTliOTJlMTg3MDUzN2JiMGNjMjMxNDcxY2MwNTM4ZjkxOGIwNDMyZjg4ZWIxYjZlYzIyZTYwYmQzYWFhIiwic2lnbmluZ0tleSI6eyJwdWJsaWNLZXkiOiJNRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUVHVWp5M09oNnNzemZXTjg0U1BsMHdQYTVjUVRUWEJ0YXVYMDdid0l5d3lSRU5GMGk4SjErZUZSUG5PRHF1SmVxbjduVGNjQmFvVWtTelFlejh4M0pMZz09IiwiZm9ybWF0IjoiU3ViamVjdFB1YmxpY0tleUluZm8iLCJhbGdvcml0aG0iOiJFUzI1NiJ9LCJzaWduaW5nS2V5QXV0aCI6eyJhZGRyZXNzIjoiMHhkMDkwNjkxOGQ0YmRmMmQ3NzVmOTkxMWVjYjk1YWVkM2IwMTI2NThhIiwic2lnbmluZ0tleVNpZ25hdHVyZSI6IjB4NDQ4NzE0ODg3MTkxYjgzYTRmOTczN2QyMWU0Njc3ZDE3ZTNiYWRlNTcxMGRiMzI4MzE1ZjFjYjg1NzczZDNjNjNhZGYxODNkZDNmZmUxNzY3NDkyMGYxOTEzYmFkMmI0MTJjODJmNTc0NzEyYzdhZTE4YjAzZDAxYjg4ZGZmMzIxYyIsInNpZ25pbmdLZXlNZXNzYWdlIjoiSSBhdXRob3JpemUgSSBhdXRob3JpemUgQ3liZXJUdW5lLnh5eiBmcm9tIHRoaXMgZGV2aWNlIHVzaW5nIHNpZ25pbmcga2V5OiAgZnJvbSB0aGlzIGRldmljZSB1c2luZyBzaWduaW5nIGtleTpcbk1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRUdVankzT2g2c3N6ZldOODRTUGwwd1BhNWNRVFRYQnRhdVgwN2J3SXl3eVJFTkYwaThKMStlRlJQbk9EcXVKZXFuN25UY2NCYW9Va1N6UWV6OHgzSkxnPT0ifX0BAIXJUsxYSPA4WDT5Blj_h3_fHLOgrqifbHA9UPiDlEoS8pvd51Xw_gnfjbPBhyavhCP0l3ym1yl0OpzRsNmN3cnY-kzS4midZEj-FP-_4HYikBz06m8tz0SPDaxLBHcWC03buGm3Hg3WtL-_giYBkjjPDC9DCN9d5jGYcDQnpIlxy2O7R66SSP84BEgwfqmw-qd9K7WmsPrvkv31r2CujGcsFaVjtBWjrDcp77_GHIZtc28xVv14fXTKbaQcy2_boehRKj5BfllHB-4CqY_xRsd_pC2N7Qu5N1iW9XMVz5scFy-kKdhnCBhfhSEpHrUYrOLpLUxrLmNIlnEpwYY3SIqLfvL9jj8B30VZKl2TqsbHABXTWoSNBstl3F9bcS5fKcg9kSOZWJ_CxpzfNiZ03pB9eETV1d6r5tflxDQn2oOHgwsi3iH66aFpJZ0Ou90TMYPOaQbKArDNVLkjVRhTtr0dJ3fQdyGTJxogaWXAHG1H18OmwH_AnXTMoH7eQi3CD6ndyjjnzOJk2Sm-LlfKBBJ1x3QrVZpFDztOztJbY7K85QB0yiGJqeGdn8s3KPgC91yMAcFvnEFxq_ZFI-WmOKWlyDWdQU1tcm6xX339dZwZJbkAJ_QEdZhk5a3AN0BEUS7N_ALl-ugBNuQ5XKc4i2GYlb9Pbxg0NF5i49Xyo_mEnPgX7WyVoTnTxFtyMHzK_iyQ9jKTuTNvPZDvpKXyraIujN7xcC4NvJ3aJ8zssULFQNgqiC5cQ2opbFOhg0A7GLIBkXNwSVwD5BBfHHCsiV-mwjjqdujllzy-pR5BCvvV2FZ4PlVAgsxX8hCEQUNVpO5_gISSE_SeLuRWXlhdSRRI4dGFNWm7E75ZJzeOn_C5hZCuQjIdgS_a-O__5v2MqBQlKDUdtw54pXniUkZA4UhPXNgcGwVvdBDsybCJeM__akVDhDWrY6nqGOozHfrIUS1VR_Cdo4LP57DlSkPOwfb81MDBkYjzPu1HYNTLEUCcWiNtw0-YV7j4eDx_a5p6esNiIZInXK3DJGw2a4Na7e9FyRLWzSNPtd54Ys0qjcGYTVwJJvl4e6oE7bMPXKSptAieiO3jhCnDFROl4Wm3NX2a1IE4DZYfk1hRjhi47p9TgbZmBkw8_1y5runeAb4ZmOyO1jiOxQ6mQCBO-AQpooHnacNlQtghy05lRR5kqdJsDEcZZuSpp4nuQJT7fkBjmRObw1lOqnpyDBwrEFKQ_3ct12toPLKN6jfTdYU7naOY0xe9N_DuWrVlzWZDjvkuciLZ25P6VI4I4rrRbJuwVAk5RXBPV4RcXuH-8SZPluilQ6tfygLDEVQeF8ltlrRMxEmjoUN9GKkPjfmyZzselmkAAAgAAAAAAAAAgwEAAAAAAAAP_gUYQ29udGVudC1UeXBlIGFwcGxpY2F0aW9uL2pzb24WQXBwbGljYXRpb24YQ3liZXJDb25uZWN0HENvbnRlbnQtRGlnZXN0gAFlYzc1YWI5NzQ2NWE0NmUxZDI1NGU0MmJlYzUyZWQwMjg0OTJlMWRhYWMxN2Y3YjZkYjUyYWFjNWI0OTAyOTNkHENvbnRlbnQtQXV0aG9yJGVsbGlzb25iZXJuYXJkb200Yw5DaGFpbklkBDU2HENvbnRlbnQtVGFyZ2V0gAEzOWYwMjE4ODFlNzM4NmY4ZDczZDZlZjI1NTMzZTYwOTFmMmEwMjU2ZTQyMmI0YjNjNGUzZDMzNWNjYWUxNDdlDFNvdXJjZUgxNTUzMWZhMi0xMjA1LTRmNjEtYjZlNC1jOWY2OGVjZjgxZjcUQ29udGVudC1JZIABZWM3NWFiOTc0NjVhNDZlMWQyNTRlNDJiZWM1MmVkMDI4NDkyZTFkYWFjMTdmN2I2ZGI1MmFhYzViNDkwMjkzZAB7ImNvbnRlbnQiOiJ7XCJvcFwiOlwiY29tbWVudFwiLFwiYWRkcmVzc1wiOlwiMHg4OTBhODM4ZTExNmY2ZDQ2N2E1ZmFlMTc2M2RkODFhZjZhZjQ0N2JmXCIsXCJ0c1wiOjE2OTE0NjA2MjAyMjAsXCJjaGFpbklkXCI6NTYsXCJoYW5kbGVcIjpcImVsbGlzb25iZXJuYXJkb200Y1wiLFwidGFyZ2V0XCI6XCIzOWYwMjE4ODFlNzM4NmY4ZDczZDZlZjI1NTMzZTYwOTFmMmEwMjU2ZTQyMmI0YjNjNGUzZDMzNWNjYWUxNDdlXCIsXCJ0aXRsZVwiOlwiRmxhcHB5TW9vbmJpcmRcIixcImJvZHlcIjpcIk9NRywgSSB3b24gYSBsb3Qgb2YgRk1CIGp1c3Qgbm93LlwifSIsImRpZ2VzdCI6ImVjNzVhYjk3NDY1YTQ2ZTFkMjU0ZTQyYmVjNTJlZDAyODQ5MmUxZGFhYzE3ZjdiNmRiNTJhYWM1YjQ5MDI5M2QiLCJzaWduYXR1cmUiOiIweGNhYTk5NzgzNDM0ODEwZTkyMWIwNzk2MWE2Y2I1MDlmNzUxNGI4OWVmZTYwYjc5YmMwMGRkYjM1YTYwOTA3NzUwNzcwNjRlOTkzYTcwNWFkNzkzMmM2Y2IxNzY2NDFmZGE2YzZiYmIzZTk4MTg3ZDRhODE3M2M4Y2RhNWQ0N2JkIiwic2lnbmluZ0tleSI6eyJwdWJsaWNLZXkiOiJNRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUViQWhma3gyUmJuWW5oMitmTWhnV1NKamR1cXRXU3Fyd2tnZUYyU29HM01HR2YwSTY1bk1MVGNhU3BvakMvRXBWM09iVDVrOCtQdHVmckhoeWlHejVyQT09IiwiZm9ybWF0IjoiU3ViamVjdFB1YmxpY0tleUluZm8iLCJhbGdvcml0aG0iOiJFUzI1NiJ9LCJzaWduaW5nS2V5QXV0aCI6eyJhZGRyZXNzIjoiMHg4OTBhODM4ZTExNmY2ZDQ2N2E1ZmFlMTc2M2RkODFhZjZhZjQ0N2JmIiwic2lnbmluZ0tleVNpZ25hdHVyZSI6IjB4NWYyZjI5NDgxY2ZmMDQxN2ZmZmVlNDUxYzhkNDQ5MjFjMmUzNDk4MjFkYjIyMzc3ZTlmMzFjMDA0NzMyM2IyMTE4YjQwMjk2NzQ3ZDM4OGZlMTVjM2Y2Mzc2NjExYmEzOGQyMDQyN2E0YjcxOTk0NmNiMGRjNmZkOTAxZWY3MmIxYiIsInNpZ25pbmdLZXlNZXNzYWdlIjoiSSBhdXRob3JpemUgQ3liZXJDb25uZWN0IGZyb20gdGhpcyBkZXZpY2UgdXNpbmcgc2lnbmluZyBrZXk6XG5NRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUViQWhma3gyUmJuWW5oMitmTWhnV1NKamR1cXRXU3Fyd2tnZUYyU29HM01HR2YwSTY1bk1MVGNhU3BvakMvRXBWM09iVDVrOCtQdHVmckhoeWlHejVyQT09In19AQBseznYeayR5lK8-xfQ0E-ojrsihxMW7QEL-rIeUXfnzM67HFzgCFg1BsafeJGtd82k6oACp2fiqCMO0KaDhyMqQikgX2fERlp3Tp5SScvpq2O93ow8luVBgJwxR3qfc3G48FPUy7CvjMxm1Ex7l7ZCZCBi0LGqVjN6Ho09GuZ4idJnHx_Q5TAIzI5ObEHOkUKgDqsChbRxE2YeqjjqQ4Lwmx93ecSZ12sMmXfYqmolSI6Fzpth64mszlTW4HId4hlEr1iLHcYj7B1kcNKdX2TLsrCiLnidwpXjQSA02XLENrWixL1_zBOU3VQ4_AtEoGMPhD-PtDlL3vL-JAMOm98gSb7j4Kiq9H63j1tq9EixtZpeKKvAi8cdo350ANgvU0WZv9z_ie2GaQ9ilgA2WZ7o70sGPiAb5doNCXbTWGh_TtMhfWb-SfuAwexsCVuICH0JW6k-8VZXGrQMIb0KH20O7xJbIZnm8__OndcB41W0RooSDGrnwLj2mFuISwIvHCt1f6OStEhJiL3r_I9bG9ru4QAw6i1NrnCbh-fVz658Cm8WGZf4klakadft-lfqtaig4nyQELc-ouhMtUT0xNFGFjrtKt7aVvIerkb7-NTVn5ak9M7c0ZOxHmoXHUlzxbWfk_dJcvCXAyLbda4rH6Q97m8g6jErF0quZtRA182i4pz4F-1slaE508RbcjB8yv4skPYyk7kzbz2Q76Sl8q2iLoze8XAuDbyd2ifM7LFCxUDYKoguXENqKWxToYNAOxiyAZFzcElcA-QQXxxwrIlfpsI46nbo5Zc8vqUeQQr71dhWeD5VQILMV_IQhEFDVaTuf4CEkhP0ni7kVl5YXUkUSOHRhTVpuxO-WSc3jp_wuYWQrkIyHYEv2vjv_-b9jKgUJSg1HbcOeKV54lJGQOFIT1zYHBsFb3QQ7MmwiXjP_2pFQ4Q1q2Op6hjqMx36yFEtVUfwnaOCz-ew5UpDzsH2_NTAwZGI8z7tR2DUyxFAnFojbcNPmFe4-Hg8f2uaenrDYiGSJ1ytwyRsNmuDWu3vRckS1s0jT7XeeGLNKo3BmE1cCSb5eHuqBO2zD1ykqbQInojt44QpwxUTpeFptzV9mtSBOA2WH5NYUY4YuO6fU4G2ZgZMPP9cua7p3gG-GZjsjtY4jsUOpkAgTvgEKaKB52nDZULYIctOZUUeZKnSbAxHGWbkqaeJ7kCU-35AY5kTm8NZTqp6cgwcKxBSkP93LddraDyyjeo303WFO52jmNMXvTfw7lq1Zc1mQ475LnIi2duT-lSOCOK60WybsFQJOUVwT1eEXF7h_vEmT5bopUOrX8oCwxFUHhfJbZa0TMRJo6FDfRipD435smc7HpZpAAAHAAAAAAAAAAwBAAAAAAAADZAEGENvbnRlbnQtVHlwZSBhcHBsaWNhdGlvbi9qc29uFkFwcGxpY2F0aW9uGEN5YmVyQ29ubmVjdBxDb250ZW50LUF1dGhvchhieHY2ZXVtcXdlajAOQ2hhaW5JZAQ1NgxTb3VyY2UIYXRlbRRDb250ZW50LUlkgAEwZDFkNmRiYmZiOGYxMWZiZDYxZTBhNTZiYThiYjU2YTYwNDg4ZmE0OWYwMmMwZjNlYzc3ZmRhZGYyODA4NGZiHENvbnRlbnQtRGlnZXN0gAEwZDFkNmRiYmZiOGYxMWZiZDYxZTBhNTZiYThiYjU2YTYwNDg4ZmE0OWYwMmMwZjNlYzc3ZmRhZGYyODA4NGZiAHsiY29udGVudCI6IntcIm9wXCI6XCJwb3N0XCIsXCJhZGRyZXNzXCI6XCIweGYwYzQxMDgxYzMzM2Y2YzQ4ZTE4ZjU3OTQ5OWY4OGQ1ODYzNGMwZmVcIixcInRzXCI6MTY5MTQ2MDYxOTgyNCxcImNoYWluSWRcIjo1NixcImhhbmRsZVwiOlwiYnh2NmV1bXF3ZWowXCIsXCJ0aXRsZVwiOlwiMTExMTJcIixcImJvZHlcIjpcIjIyMjIyMjIyMjIyMjIyMjIyMlwifSIsImRpZ2VzdCI6IjBkMWQ2ZGJiZmI4ZjExZmJkNjFlMGE1NmJhOGJiNTZhNjA0ODhmYTQ5ZjAyYzBmM2VjNzdmZGFkZjI4MDg0ZmIiLCJzaWduYXR1cmUiOiIweDYwNjY4OGMyYjYxMDAxMjBmNDRmNjIyOTA5ZDU4NjdlN2RhZjEyYTI4NGU5OTk1MmM5ZWNiM2U1MjFhNTNlYTg2NjFjNDZiYzI4YTc1YTA2MGFlZDk3Y2FiZmFiMjk5YTk4MTgxZDIyOWMwN2VkMTkwZDVmMTkyMWQ3MGI4YjlkIiwic2lnbmluZ0tleSI6eyJwdWJsaWNLZXkiOiJNRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUVYckNhUnVzdFQweHZLeUlsZ0NIandqUlVNR1JOWVQ3QUE5MUVEcU5EbkVsYzhsTlhqcjU0eHRiK0Q5aW9aQlRXOWlpWmJpdHJDWVNtQWtwTTVNRjgrQT09IiwiZm9ybWF0IjoiU3ViamVjdFB1YmxpY0tleUluZm8iLCJhbGdvcml0aG0iOiJFUzI1NiJ9LCJzaWduaW5nS2V5QXV0aCI6eyJhZGRyZXNzIjoiMHhmMGM0MTA4MWMzMzNmNmM0OGUxOGY1Nzk0OTlmODhkNTg2MzRjMGZlIiwic2lnbmluZ0tleVNpZ25hdHVyZSI6IjB4Y2E4Mjg4NGM0ODA2YjE0NTllM2Q1MzYzYmI1NGQ3ZjEzMWVkNmExODQzMzY2OTJlMzZiYzQ4OTI2ODQwMzU2MTNjNmY4YmY5MzY4NzEzOGM5Y2IwM2Q1NjBkODY4Yzc4Y2U4OTg2OWE2MDRhZThkYWNjNjUwZGYyZGUxNjUyNGMxYiIsInNpZ25pbmdLZXlNZXNzYWdlIjoiSSBhdXRob3JpemUgQXRlbVJldmlldyBmcm9tIHRoaXMgZGV2aWNlIHVzaW5nIHNpZ25pbmcga2V5OlxuTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFWHJDYVJ1c3RUMHh2S3lJbGdDSGp3alJVTUdSTllUN0FBOTFFRHFORG5FbGM4bE5YanI1NHh0YitEOWlvWkJUVzlpaVpiaXRyQ1lTbUFrcE01TUY4K0E9PSJ9fQEAApBkElnWSNOxTOlfy9gS3KMmydUXeiuk-8CEofvfAbayeo5fGZvmH6tnSGWI5Ni2V6Htf1fGWYWOZbERwjhUe1I301OwBDZOdvgVxV_cQTCY-Wn3ekyuZUqhcbK8NhPZuOane1neoR8dvi74i7DudpxE7-NFHTFKsIE9Hs03W7-OjsGFgL-gQUVQ_hwxautY7ILSHqJlkcW6cq46yI9v1Uy6pgkJO3oksmJ2M_LgXyScAFmFL_qeIgGkyRiPZyE9BJaaVfc8bE_lRqIUjED412CH-hHFQWtLkPUWR7i8zs9Xp7qtMRmG7oEJl9qXzOCFPzrA12Lb6_SpaDmSpH6qsu3lmhs2LJxqZK6zxgeVqxhMdXuUvJCivnyQ6r6V3n2usij6G4BnU8tIkvkAIyG0eZmTpYwwNUUdtFnb9fl3LNHivrFfdHFGqHK2ARdhBF2-q8x9uRzsZOv3Z_R9YEH1KJvszgvAiDrdY6z1BDH-Vwn1oTRQEWN3_JaJB9GRxoa4omMWvhHEo9vsfE6p_Tf7Jce3pPqD3wovosRiWtShNpzLWsT4VSlgw-UHHwunRSuDoPF0mNCuT3Hr10HH6YV6RxHKCZ-4Mrs075wrtgA2sgkzqTwJxa0w8ban_3bvRnFUsG40skGQnZOMpWoRTsrR1nNJGauFbSMDyZM35Po5Yvmc-BftbJWhOdPEW3IwfMr-LJD2MpO5M289kO-kpfKtoi6M3vFwLg28ndonzOyxQsVA2CqILlxDailsU6GDQDsYsgGRc3BJXAPkEF8ccKyJX6bCOOp26OWXPL6lHkEK-9XYVng-VUCCzFfyEIRBQ1Wk7n-AhJIT9J4u5FZeWF1JFEjh0YU1absTvlknN46f8LmFkK5CMh2BL9r47__m_YyoFCUoNR23DnileeJSRkDhSE9c2BwbBW90EOzJsIl4z_9qRUOENatjqeoY6jMd-shRLVVH8J2jgs_nsOVKQ87B9vzUwMGRiPM-7Udg1MsRQJxaI23DT5hXuPh4PH9rmnp6w2IhkidcrcMkbDZrg1rt70XJEtbNI0-13nhizSqNwZhNXAkm-Xh7qgTtsw9cpKm0CJ6I7eOEKcMVE6Xhabc1fZrUgTgNlh-TWFGOGLjun1OBtmYGTDz_XLmu6d4BvhmY7I7WOI7FDqZAIE74BCmigedpw2VC2CHLTmVFHmSp0mwMRxlm5Kmnie5AlPt-QGOZE5vDWU6qenIMHCsQUpD_dy3Xa2g8so3qN9N1hTudo5jTF7038O5atWXNZkOO-S5yItnbk_pUjgjiutFsm7BUCTlFcE9XhFxe4f7xJk-W6KVDq1_KAsMRVB4XyW2WtEzESaOhQ30YqQ-N-bJnOx6WaQAACAAAAAAAAAB-AQAAAAAAAA_0BRhDb250ZW50LVR5cGUgYXBwbGljYXRpb24vanNvbhZBcHBsaWNhdGlvbhhDeWJlckNvbm5lY3QUQ29udGVudC1JZIABNGIwNzllNmRmZWExMTU2MjgxY2Q2NjdjZGMwYjU1NzU1YWMyZDcwZTA5NmMxNmQ2YzU4ZDdkZDdiNjJmOTI3YxxDb250ZW50LURpZ2VzdIABNGIwNzllNmRmZWExMTU2MjgxY2Q2NjdjZGMwYjU1NzU1YWMyZDcwZTA5NmMxNmQ2YzU4ZDdkZDdiNjJmOTI3YxxDb250ZW50LUF1dGhvchoxMTMyODYzMDEzOTYxDkNoYWluSWQENTYcQ29udGVudC1UYXJnZXSAATM5ZjAyMTg4MWU3Mzg2ZjhkNzNkNmVmMjU1MzNlNjA5MWYyYTAyNTZlNDIyYjRiM2M0ZTNkMzM1Y2NhZTE0N2UMU291cmNlSDE1NTMxZmEyLTEyMDUtNGY2MS1iNmU0LWM5ZjY4ZWNmODFmNwB7ImNvbnRlbnQiOiJ7XCJvcFwiOlwiY29tbWVudFwiLFwiYWRkcmVzc1wiOlwiMHg1YWYxZGYwY2ExMDc4YjkyYmNhMDc0ODU2MTA2MThhNzBhMjk3NGUwXCIsXCJ0c1wiOjE2OTE0NjA2MjA1NDAsXCJjaGFpbklkXCI6NTYsXCJoYW5kbGVcIjpcIjExMzI4NjMwMTM5NjFcIixcInRhcmdldFwiOlwiMzlmMDIxODgxZTczODZmOGQ3M2Q2ZWYyNTUzM2U2MDkxZjJhMDI1NmU0MjJiNGIzYzRlM2QzMzVjY2FlMTQ3ZVwiLFwidGl0bGVcIjpcIkZsYXBweU1vb25iaXJkXCIsXCJib2R5XCI6XCJTbyBmdW4gdG8gcGxheSBpbiBteSBzcGFyZSB0aW1lLlwifSIsImRpZ2VzdCI6IjRiMDc5ZTZkZmVhMTE1NjI4MWNkNjY3Y2RjMGI1NTc1NWFjMmQ3MGUwOTZjMTZkNmM1OGQ3ZGQ3YjYyZjkyN2MiLCJzaWduYXR1cmUiOiIweGUwN2ZmZWViMzI1MDg2OTJkYTA4MzZlZDk2MGRjOGFlZDFlNTcyZDk3MmJiNDVmOTIyNDc1MDNjYTc4ZmUzZjIyYmNlMTlhNDgwOWYwNTcyOTE5MTY1OWRjMDZkNjUxYWQyMTViNjNkY2RjZTA4MDQxZGI0NmYzMzBiM2RjN2JhIiwic2lnbmluZ0tleSI6eyJwdWJsaWNLZXkiOiJNRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUVsZXR3YjBXUi9VT01XN2JQUy9NWE1ZSWY0WEZ5SVI3TWR0S0ZCWjlFb3VmbXlna3F0MjJTWFhpVlVQYnpjdFhCV1hqR1Exa29EWHkyNHlmcjFwQnVWUT09IiwiZm9ybWF0IjoiU3ViamVjdFB1YmxpY0tleUluZm8iLCJhbGdvcml0aG0iOiJFUzI1NiJ9LCJzaWduaW5nS2V5QXV0aCI6eyJhZGRyZXNzIjoiMHg1YWYxZGYwY2ExMDc4YjkyYmNhMDc0ODU2MTA2MThhNzBhMjk3NGUwIiwic2lnbmluZ0tleVNpZ25hdHVyZSI6IjB4ZDQzMjBmMGY1OWZkM2QwMWJmZTcxNmJlMDgwN2NmZmEyZDcwMjlhOGNhMjkyNTBjMWRmY2FkOTYwNjM5ZDM0ODE4MTc2ZjRlN2VhYmQwNjA0NGU3YWQ5M2ExOGYzNjE0NmVkMTRmNTAyMjJmNzZlYzYxNzNiNmJmNzZlYTcxOTcxYiIsInNpZ25pbmdLZXlNZXNzYWdlIjoiSSBhdXRob3JpemUgQ3liZXJDb25uZWN0IGZyb20gdGhpcyBkZXZpY2UgdXNpbmcgc2lnbmluZyBrZXk6XG5NRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUVsZXR3YjBXUi9VT01XN2JQUy9NWE1ZSWY0WEZ5SVI3TWR0S0ZCWjlFb3VmbXlna3F0MjJTWFhpVlVQYnpjdFhCV1hqR1Exa29EWHkyNHlmcjFwQnVWUT09In19AQCGx6Akn1fizpaeFg6vWJhSdGRrLM5SjgVccqwlWJV71itRyxnnxNsDWjLfBa3Lwbrs-pAKPCEx46EKTPJA8aP9eObgQQihwhXJqJMNSCs8_pm-_yCxvpN48RpcQSp-kb3CFvlZt86uOHtzcHvwnP0UtLebpSkWXzaqSuWMssghw9SAfYkoqSyGrkz5L-GVRXZZXFyAnQ6BEAu3fgFWKXDkLgujs1PoUtLuDUMOOTuWMa81kYXcfB5pS3myJaBl_c8qEMFoFelegOl3ao12DuKozJShLcvAZmoby4hd0yDvb8ZAPppC1KRqX6qLR9fdwtKvNIn7VXwVdLY9ki9s-jVBel_KcNeMR7QLseYcFExDZ4sGf8MKL8v8YzIJUFrJd2rBOJM5QyrcrjCbxEOaHWAiBo4EWKto3BbUAjZY_Fm42vXuVHgM7Lbn0jGlWRIV-ODkZAq184guqQ2XPTMHrVs87lRU_EMWP0FKxpImr4gZFn7VlCBob0QInOGPPvkh_dPsqf6woS2CeQn_NKJDSgKPX7IMe83Q7HGNwiJfjR5OpJ1qLN4XZhERohYxbiuNN0ivL2Rah5rMDm8pPcgywYoMx_UevNa43HEQzQwtLVIxpum6_kb-UsNNiWQkaOm0yhTOC3zGCnIICLump0F13gaNrqJM8ZpHncA3C4i-fFV3upz4F-1slaE508RbcjB8yv4skPYyk7kzbz2Q76Sl8q2iLoze8XAuDbyd2ifM7LFCxUDYKoguXENqKWxToYNAOxiyAZFzcElcA-QQXxxwrIlfpsI46nbo5Zc8vqUeQQr71dhWeD5VQILMV_IQhEFDVaTuf4CEkhP0ni7kVl5YXUkUSOHRhTVpuxO-WSc3jp_wuYWQrkIyHYEv2vjv_-b9jKgUJSg1HbcOeKV54lJGQOFIT1zYHBsFb3QQ7MmwiXjP_2pFQ4Q1q2Op6hjqMx36yFEtVUfwnaOCz-ew5UpDzsH2_NTAwZGI8z7tR2DUyxFAnFojbcNPmFe4-Hg8f2uaenrDYiGSJ1ytwyRsNmuDWu3vRckS1s0jT7XeeGLNKo3BmE1cCSb5eHuqBO2zD1ykqbQInojt44QpwxUTpeFptzV9mtSBOA2WH5NYUY4YuO6fU4G2ZgZMPP9cua7p3gG-GZjsjtY4jsUOpkAgTvgEKaKB52nDZULYIctOZUUeZKnSbAxHGWbkqaeJ7kCU-35AY5kTm8NZTqp6cgwcKxBSkP93LddraDyyjeo303WFO52jmNMXvTfw7lq1Zc1mQ475LnIi2duT-lSOCOK60WybsFQJOUVwT1eEXF7h_vEmT5bopUOrX8oCwxFUHhfJbZa0TMRJo6FDfRipD435smc7HpZpAAAIAAAAAAAAAH0BAAAAAAAAD_IFGENvbnRlbnQtVHlwZSBhcHBsaWNhdGlvbi9qc29uFkFwcGxpY2F0aW9uGEN5YmVyQ29ubmVjdBRDb250ZW50LUlkgAFiNmRmOWJjYmJjYTgzNjhiN2I4ZTgxZWVjOTRjY2IxYjk3ODY3M2M5NjJjMTM3NjhjYzJkOWYzYzc5MDlmNzE0HENvbnRlbnQtRGlnZXN0gAFiNmRmOWJjYmJjYTgzNjhiN2I4ZTgxZWVjOTRjY2IxYjk3ODY3M2M5NjJjMTM3NjhjYzJkOWYzYzc5MDlmNzE0HENvbnRlbnQtQXV0aG9yGHcwODg4NTE2MDYzdA5DaGFpbklkBDU2HENvbnRlbnQtVGFyZ2V0gAEzOWYwMjE4ODFlNzM4NmY4ZDczZDZlZjI1NTMzZTYwOTFmMmEwMjU2ZTQyMmI0YjNjNGUzZDMzNWNjYWUxNDdlDFNvdXJjZUgxNTUzMWZhMi0xMjA1LTRmNjEtYjZlNC1jOWY2OGVjZjgxZjcAeyJjb250ZW50Ijoie1wib3BcIjpcImNvbW1lbnRcIixcImFkZHJlc3NcIjpcIjB4YzVlZGQ5YmI2NDdmZDY2MjQ5ZmVlYTA2NjBmNTBmZTM4YjE5ZTNiZVwiLFwidHNcIjoxNjkxNDYwNjE5MzE1LFwiY2hhaW5JZFwiOjU2LFwiaGFuZGxlXCI6XCJ3MDg4ODUxNjA2M3RcIixcInRhcmdldFwiOlwiMzlmMDIxODgxZTczODZmOGQ3M2Q2ZWYyNTUzM2U2MDkxZjJhMDI1NmU0MjJiNGIzYzRlM2QzMzVjY2FlMTQ3ZVwiLFwidGl0bGVcIjpcIkZsYXBweU1vb25iaXJkXCIsXCJib2R5XCI6XCJTbyBmdW4gdG8gcGxheSBpbiBteSBzcGFyZSB0aW1lLlwifSIsImRpZ2VzdCI6ImI2ZGY5YmNiYmNhODM2OGI3YjhlODFlZWM5NGNjYjFiOTc4NjczYzk2MmMxMzc2OGNjMmQ5ZjNjNzkwOWY3MTQiLCJzaWduYXR1cmUiOiIweGUwMTNhMTM3ZDE3N2U0OWM2MmI4OWFlZDVlMmZlNzZkNTQ1ZGJlNDdjY2E4MTE1YjI0YTAxNWUzYzNhOGMyN2E3OTQ3MDljMmFlNDFkMzAxNjBjOTI1YTU3ZTM0YzNjMzQzNTY3ZGFkZmFkNjNlOGIyYTE3NTlmOWQxZjU0NmQxIiwic2lnbmluZ0tleSI6eyJwdWJsaWNLZXkiOiJNRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUV0Qzd1TFdWRjRyV042UGU2YzQwQ2QzNTlQc2sxM3RMZFROOCtlY0pHYzhldC8xbFh6N3hKYUZ6SURudXN5VE8wRUxwdU12NzJxelc4RXk1dlFYa1pUUT09IiwiZm9ybWF0IjoiU3ViamVjdFB1YmxpY0tleUluZm8iLCJhbGdvcml0aG0iOiJFUzI1NiJ9LCJzaWduaW5nS2V5QXV0aCI6eyJhZGRyZXNzIjoiMHhjNWVkZDliYjY0N2ZkNjYyNDlmZWVhMDY2MGY1MGZlMzhiMTllM2JlIiwic2lnbmluZ0tleVNpZ25hdHVyZSI6IjB4MzJlNTZjM2EyOWNjN2VkZjdlNDY2YTc0YjZhNmU0OWFjMDNmNDM3N2I2OWQ0MGJkYzQ2YjA0MzdjMTNkYzZkOTNjZTJiNTk3MTBhNTM3MmU1MzU5OGQ3ZjhiYWNmMmRiYmM4OWI2MzBlMGMwNTM1OTA5MTYzNjJkYTFjMWJlYjQxYiIsInNpZ25pbmdLZXlNZXNzYWdlIjoiSSBhdXRob3JpemUgQ3liZXJDb25uZWN0IGZyb20gdGhpcyBkZXZpY2UgdXNpbmcgc2lnbmluZyBrZXk6XG5NRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUV0Qzd1TFdWRjRyV042UGU2YzQwQ2QzNTlQc2sxM3RMZFROOCtlY0pHYzhldC8xbFh6N3hKYUZ6SURudXN5VE8wRUxwdU12NzJxelc4RXk1dlFYa1pUUT09In19AQADfbg7hHNbSnuyvcwbq4zlvLUrvbjaeT65Q_piS-mpVYug3PSg4QjIcEt_AdW9d3lJPLOjl3NC9zJYoiDTQNDcpzzx1q0hcg7_wMROF56-Fq-jlW691jxFjc8i5GDYbYIWXYBkqwiZXnuKMqkRi2cG3RXYxqmaP4biVx4hVHSJL9wD1J1brnhmGG11timDGdm5w-IQ-zvCWAGOTQ-Orv5bUJUrbETorVgFZUzxWjdTWtSm36mAdGq5XeDTE_k-4CfcrCZAnOKIPiyJBnVC1LigboJR1rqcmwk5FV9zQrG4Rt8LokQ6dOPmC4HA6Bu_uujQEMKKYmoEUp5nJJX9YViKo2a3VCh4GjSp7UbavQ8Zl65VVyfUpesCxcBmjIcyFfz8564gUIAJMFNbykSXgoC6OBb_FdfB_ziX97yTdM7YpvuVApaMrrsXo9m9utDG-BksmTkZq6n2SwNt5oCRGHG4f7ks5uewA7hjhkg238RoJJiHL84fXI8FA_hxosepqqB4_oZ-g9MgNul38CA9KPX56ranae_AvSAdWkmM7aaJwKaSo9uLX-WX9cHZ82N5UxVGEZ_4v3xyWn1z2C2wTdXY-JUpsJkMKczDeETYvH-vpmpOMG-P-A2ZbUaAyZXdmSdBDTby0N7k-3HEtEs7Z3iUqFkyU93iNPsGzdgK8b5gppz4F-1slaE508RbcjB8yv4skPYyk7kzbz2Q76Sl8q2iLoze8XAuDbyd2ifM7LFCxUDYKoguXENqKWxToYNAOxiyAZFzcElcA-QQXxxwrIlfpsI46nbo5Zc8vqUeQQr71dhWeD5VQILMV_IQhEFDVaTuf4CEkhP0ni7kVl5YXUkUSOHRhTVpuxO-WSc3jp_wuYWQrkIyHYEv2vjv_-b9jKgUJSg1HbcOeKV54lJGQOFIT1zYHBsFb3QQ7MmwiXjP_2pFQ4Q1q2Op6hjqMx36yFEtVUfwnaOCz-ew5UpDzsH2_NTAwZGI8z7tR2DUyxFAnFojbcNPmFe4-Hg8f2uaenrDYiGSJ1ytwyRsNmuDWu3vRckS1s0jT7XeeGLNKo3BmE1cCSb5eHuqBO2zD1ykqbQInojt44QpwxUTpeFptzV9mtSBOA2WH5NYUY4YuO6fU4G2ZgZMPP9cua7p3gG-GZjsjtY4jsUOpkAgTvgEKaKB52nDZULYIctOZUUeZKnSbAxHGWbkqaeJ7kCU-35AY5kTm8NZTqp6cgwcKxBSkP93LddraDyyjeo303WFO52jmNMXvTfw7lq1Zc1mQ475LnIi2duT-lSOCOK60WybsFQJOUVwT1eEXF7h_vEmT5bopUOrX8oCwxFUHhfJbZa0TMRJo6FDfRipD435smc7HpZpAAAIAAAAAAAAAH0BAAAAAAAAD_IFGENvbnRlbnQtVHlwZSBhcHBsaWNhdGlvbi9qc29uFkFwcGxpY2F0aW9uGEN5YmVyQ29ubmVjdBRDb250ZW50LUlkgAEwMjhkZmQzMWViMTljOTgwNjhlZTY2YzA2YTU0NmM4NWM5NjM5NWM4YzI4MzYzOGMzMTQ1Y2E3ZTdkYTY4OWE4HENvbnRlbnQtRGlnZXN0gAEwMjhkZmQzMWViMTljOTgwNjhlZTY2YzA2YTU0NmM4NWM5NjM5NWM4YzI4MzYzOGMzMTQ1Y2E3ZTdkYTY4OWE4HENvbnRlbnQtQXV0aG9yGG1oOGx2a2psM2I1Ng5DaGFpbklkBDU2HENvbnRlbnQtVGFyZ2V0gAEzOWYwMjE4ODFlNzM4NmY4ZDczZDZlZjI1NTMzZTYwOTFmMmEwMjU2ZTQyMmI0YjNjNGUzZDMzNWNjYWUxNDdlDFNvdXJjZUgxNTUzMWZhMi0xMjA1LTRmNjEtYjZlNC1jOWY2OGVjZjgxZjcAeyJjb250ZW50Ijoie1wib3BcIjpcImNvbW1lbnRcIixcImFkZHJlc3NcIjpcIjB4MDBmYjdiY2Y0MWU5Yjc0NTBlNDFlMmIwMmQxNTNjNTA4MzNhYjkzOFwiLFwidHNcIjoxNjkxNDYwNjIwMDIzLFwiY2hhaW5JZFwiOjU2LFwiaGFuZGxlXCI6XCJtaDhsdmtqbDNiNTZcIixcInRhcmdldFwiOlwiMzlmMDIxODgxZTczODZmOGQ3M2Q2ZWYyNTUzM2U2MDkxZjJhMDI1NmU0MjJiNGIzYzRlM2QzMzVjY2FlMTQ3ZVwiLFwidGl0bGVcIjpcIkZsYXBweU1vb25iaXJkXCIsXCJib2R5XCI6XCJTbyBmdW4gdG8gcGxheSBpbiBteSBzcGFyZSB0aW1lLlwifSIsImRpZ2VzdCI6IjAyOGRmZDMxZWIxOWM5ODA2OGVlNjZjMDZhNTQ2Yzg1Yzk2Mzk1YzhjMjgzNjM4YzMxNDVjYTdlN2RhNjg5YTgiLCJzaWduYXR1cmUiOiIweDc1MGYyZTkwNmEyNGJhYWI3NWU0NTcyMDA0YmFlNTVlZGQ4MTQ5ZWU1MzUxM2VjMWMzODJjM2U5NmMyZTI2NjRiNmQzNDhmMWM4MjZjZWU3OWFkZTNjOGZkZmZlNzI4ZWI0MGZiMzEzMmFiNmEzMDBiOGU2MmYyNmIxYzk0NjE3Iiwic2lnbmluZ0tleSI6eyJwdWJsaWNLZXkiOiJNRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUVpRkJlTU9xbmVERTZ6V1BybHJObU5OSWZ3UUJYdFVVYlVSN2tQRVN2RzlTTkdBcHFrRVZMRENEY3lOaGpxd0c2NTYydExqTzQyWlNZZnRkdER3TC9IZz09IiwiZm9ybWF0IjoiU3ViamVjdFB1YmxpY0tleUluZm8iLCJhbGdvcml0aG0iOiJFUzI1NiJ9LCJzaWduaW5nS2V5QXV0aCI6eyJhZGRyZXNzIjoiMHgwMGZiN2JjZjQxZTliNzQ1MGU0MWUyYjAyZDE1M2M1MDgzM2FiOTM4Iiwic2lnbmluZ0tleVNpZ25hdHVyZSI6IjB4ZTVhOTk2NDlhODE0YmEyNTAxZjc0YzFiNTllZDc1YjdhNDk0NDNmYzM0MDRiYTc5MzNmYjAxNzI5ZDgwMGQ5NDU5NmFiYTIyMjhlMmQ5MzkyOWI5NTNmYWNiN2Q4NWI3ZjMzNGI4YWM2MTI3ZGM4YTg5NDM5N2VhZDE4OTlkOWMxYyIsInNpZ25pbmdLZXlNZXNzYWdlIjoiSSBhdXRob3JpemUgQ3liZXJDb25uZWN0IGZyb20gdGhpcyBkZXZpY2UgdXNpbmcgc2lnbmluZyBrZXk6XG5NRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUVpRkJlTU9xbmVERTZ6V1BybHJObU5OSWZ3UUJYdFVVYlVSN2tQRVN2RzlTTkdBcHFrRVZMRENEY3lOaGpxd0c2NTYydExqTzQyWlNZZnRkdER3TC9IZz09In19AQBW_DBFCnOmzFjJCbzWYmUI4ae8xSl5C41e54rgJhzyl70VIAhra2HaP38lpqJJgxcLVzuk-Ja_SWPHdUIwQ3khj-6vZQzewbjjR5Zu1G2FfztcIrW6Ylj0rNMWtsd0h6uA3T7b_3zVwAFr9VomS3AK1czo6QBDlk7Agfx_FpOjVYVwaqrwUptNVVCFGYrYeh7Y_nG4EgLmRndYyFmXAbrZ8m4L2zc0TKeiQNMHQYjuOO9fl1-3ta2Sz4VgOgBQUMYx9-IfEk3WvIeJmhCZo-wwgjjmfM14QrHTkGRNB9sd8GIB94kqQdTSMPKecH45a27Vut4CsI_fCIVpVuJhd9l6rr5cI-NO1--n_FMx-Rrc7Wclg7sF5QdZTbA1FTn_ARbpo2YdDUs6LnJbvhi23z4p3zopyGC5B7SVMCYtpnSF4IOezSicMkbx1Ld2I-692MotdPNaEMVLzPKDxjWd4RPnQRlVcziANRIVY0oE4a6QjFfmK7JSK6D1cAgzMa5LjkEoZHPaA2awphp7IQdQl7e7gFoximm38GLVhYBP3FHrQZ8rbe56-jZdi6qGZi1o3ZcAUNl6ElQjKmEZS1zy2s842-NuE3jgRXOBR4xJoFT6rmqMrrzsIpGdie0-7bZE_o2l7LuupOlkvqa3Cdk7H9NSS0lzv7qIMi6WntqeznoRhpz4F-1slaE508RbcjB8yv4skPYyk7kzbz2Q76Sl8q2iLoze8XAuDbyd2ifM7LFCxUDYKoguXENqKWxToYNAOxiyAZFzcElcA-QQXxxwrIlfpsI46nbo5Zc8vqUeQQr71dhWeD5VQILMV_IQhEFDVaTuf4CEkhP0ni7kVl5YXUkUSOHRhTVpuxO-WSc3jp_wuYWQrkIyHYEv2vjv_-b9jKgUJSg1HbcOeKV54lJGQOFIT1zYHBsFb3QQ7MmwiXjP_2pFQ4Q1q2Op6hjqMx36yFEtVUfwnaOCz-ew5UpDzsH2_NTAwZGI8z7tR2DUyxFAnFojbcNPmFe4-Hg8f2uaenrDYiGSJ1ytwyRsNmuDWu3vRckS1s0jT7XeeGLNKo3BmE1cCSb5eHuqBO2zD1ykqbQInojt44QpwxUTpeFptzV9mtSBOA2WH5NYUY4YuO6fU4G2ZgZMPP9cua7p3gG-GZjsjtY4jsUOpkAgTvgEKaKB52nDZULYIctOZUUeZKnSbAxHGWbkqaeJ7kCU-35AY5kTm8NZTqp6cgwcKxBSkP93LddraDyyjeo303WFO52jmNMXvTfw7lq1Zc1mQ475LnIi2duT-lSOCOK60WybsFQJOUVwT1eEXF7h_vEmT5bopUOrX8oCwxFUHhfJbZa0TMRJo6FDfRipD435smc7HpZpAAAHAAAAAAAAAA0BAAAAAAAADZIEGENvbnRlbnQtVHlwZSBhcHBsaWNhdGlvbi9qc29uFkFwcGxpY2F0aW9uGEN5YmVyQ29ubmVjdBRDb250ZW50LUlkgAFjMjcyMDlmYWFiNDNiMWQ4YzgwODAxM2NkZDM3ZWUyNzJjZDRiNTkyN2MwMjczYTkxOTExNDRiYThlOWQxZTVkHENvbnRlbnQtRGlnZXN0gAFjMjcyMDlmYWFiNDNiMWQ4YzgwODAxM2NkZDM3ZWUyNzJjZDRiNTkyN2MwMjczYTkxOTExNDRiYThlOWQxZTVkHENvbnRlbnQtQXV0aG9yGjgxNjI1NTg2NTE1OTEOQ2hhaW5JZAQ1NgxTb3VyY2UIYXRlbQB7ImNvbnRlbnQiOiJ7XCJvcFwiOlwicG9zdFwiLFwiYWRkcmVzc1wiOlwiMHg4YzMwYWYyNTQ3MTBiNTJlNWJiZjM5MTJjOTJmZjY2MGQ3NTRkNTBiXCIsXCJ0c1wiOjE2OTE0NjA2MjA2MDUsXCJjaGFpbklkXCI6NTYsXCJoYW5kbGVcIjpcIjgxNjI1NTg2NTE1OTFcIixcInRpdGxlXCI6XCIxMTExMlwiLFwiYm9keVwiOlwiMjIyMjIyMjIyMjIyMjIyMjIyXCJ9IiwiZGlnZXN0IjoiYzI3MjA5ZmFhYjQzYjFkOGM4MDgwMTNjZGQzN2VlMjcyY2Q0YjU5MjdjMDI3M2E5MTkxMTQ0YmE4ZTlkMWU1ZCIsInNpZ25hdHVyZSI6IjB4ZjkxOGVmYWMyMzY1YjVmMTY0YzdiMDgzOWI4N2YzNmZhNmE5MjBjODhjZDIwY2RkOWI3ZTkxYmEwODE5NDM5YTQ3MzUxZWYzMTAxMGU4MTVkMTNkNmRjMmEzMGUxMDc0NmQ4ODg5ZDU4OWY3MzE1M2I5NmRiODViYTBiMDlmN2QiLCJzaWduaW5nS2V5Ijp7InB1YmxpY0tleSI6Ik1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRWhGWWF1Z0RLcXRVK05RbFVoUmVjUjNIdmJGK1hLVGYxWmI2cmhodEt4ZVFZN0w0OWp5anVGY0k0K3daQTJkTjJIdGlycS8xMmlpS2IyWDg2N0hLd3RnPT0iLCJmb3JtYXQiOiJTdWJqZWN0UHVibGljS2V5SW5mbyIsImFsZ29yaXRobSI6IkVTMjU2In0sInNpZ25pbmdLZXlBdXRoIjp7ImFkZHJlc3MiOiIweDhjMzBhZjI1NDcxMGI1MmU1YmJmMzkxMmM5MmZmNjYwZDc1NGQ1MGIiLCJzaWduaW5nS2V5U2lnbmF0dXJlIjoiMHgzNWU3ZmExZjc3ZTVkYjhkODgzM2NjYmFmNTgwMGJkMTg2YTI2NmUyZWU2NWUyYzBmYzBhNTNhM2IzMzE1NzFkMDQ2NzA5MDAwNmIzNGE4ZjMwZTFkMDJjMmYzNDFhN2VhODZkZTM2NTg0ZGM0Yjc1MzYyZGRkNWE2M2YzMzg3NDFiIiwic2lnbmluZ0tleU1lc3NhZ2UiOiJJIGF1dGhvcml6ZSBBdGVtUmV2aWV3IGZyb20gdGhpcyBkZXZpY2UgdXNpbmcgc2lnbmluZyBrZXk6XG5NRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUVoRllhdWdES3F0VStOUWxVaFJlY1IzSHZiRitYS1RmMVpiNnJoaHRLeGVRWTdMNDlqeWp1RmNJNCt3WkEyZE4ySHRpcnEvMTJpaUtiMlg4NjdIS3d0Zz09In19AQAvdWd4Bv5gLKO6-6Eit1GykEJkKwbzIyteTikMasGtD3D9_x2wpA9Ad0Oe6XmKEo7f5biWeIkU_Yqcu-7M5w_LK6hEDpDq6YC-bWBzIG5YAWmvTfS40wdNnQoFl1QDVKdF8yRJ_HYvdkgFLMCNIZiB3Nnzb2mO4w69wQMkNUQ88bKEVIwq0-A4v6_L0--3ijAXJMVudstYL2digiqlWJklJCGpFAhqwmumQmj4Fq2VG11VraYj3W1TDn3hJWAnzneIXztz7QFGSu4qk17hzND0NRkZL5YkZFLS4NYZINhYyunGBw89at0RUY9vQAkpfZl73TlRFL8_rH4wwOQZy3SnuAOBx72dsNXQazfOYAefk5a5iAAkyq_tfBSUBZow7PrdQe39CgFPhXY9iuJ7p3QzuOxiiBXPqhnVRUz62xdWzz1gVxZWprGeCszCOqhDTAuRogeQg4l5E_okiWoAGb-n6fE0Zxa3C_RMC9nYnNSKmNyP2P4iho2zpEfExV2N-zQGwclN6F_fdpS43XawJKbBzxLYS8Quf20T0wORzz02tDI59S4at7S0PX6KR3NDQfc_X90Ot9DFqFXxryYT6nVS2WI6Ylce8VFVnoc0VopY8gKieDDjyoMIL9UFmz0BtdLnOb12eyjKoLs5eH4oRSPEr7ORitA0s8BJ03nk0uwRf5z4F-1slaE508RbcjB8yv4skPYyk7kzbz2Q76Sl8q2iLoze8XAuDbyd2ifM7LFCxUDYKoguXENqKWxToYNAOxiyAZFzcElcA-QQXxxwrIlfpsI46nbo5Zc8vqUeQQr71dhWeD5VQILMV_IQhEFDVaTuf4CEkhP0ni7kVl5YXUkUSOHRhTVpuxO-WSc3jp_wuYWQrkIyHYEv2vjv_-b9jKgUJSg1HbcOeKV54lJGQOFIT1zYHBsFb3QQ7MmwiXjP_2pFQ4Q1q2Op6hjqMx36yFEtVUfwnaOCz-ew5UpDzsH2_NTAwZGI8z7tR2DUyxFAnFojbcNPmFe4-Hg8f2uaenrDYiGSJ1ytwyRsNmuDWu3vRckS1s0jT7XeeGLNKo3BmE1cCSb5eHuqBO2zD1ykqbQInojt44QpwxUTpeFptzV9mtSBOA2WH5NYUY4YuO6fU4G2ZgZMPP9cua7p3gG-GZjsjtY4jsUOpkAgTvgEKaKB52nDZULYIctOZUUeZKnSbAxHGWbkqaeJ7kCU-35AY5kTm8NZTqp6cgwcKxBSkP93LddraDyyjeo303WFO52jmNMXvTfw7lq1Zc1mQ475LnIi2duT-lSOCOK60WybsFQJOUVwT1eEXF7h_vEmT5bopUOrX8oCwxFUHhfJbZa0TMRJo6FDfRipD435smc7HpZpAAAIAAAAAAAAAIMBAAAAAAAAD_4FGENvbnRlbnQtVHlwZSBhcHBsaWNhdGlvbi9qc29uFkFwcGxpY2F0aW9uGEN5YmVyQ29ubmVjdAxTb3VyY2VIMTU1MzFmYTItMTIwNS00ZjYxLWI2ZTQtYzlmNjhlY2Y4MWY3FENvbnRlbnQtSWSAATdlNWJjNGE1ODNkODY3NzRiNDE3YmMyZTc2YmRhNjcxMzBiODUyYWI0MzlkMTQ3YzYzNDI2ODU0MjgyZjA3N2McQ29udGVudC1EaWdlc3SAATdlNWJjNGE1ODNkODY3NzRiNDE3YmMyZTc2YmRhNjcxMzBiODUyYWI0MzlkMTQ3YzYzNDI2ODU0MjgyZjA3N2McQ29udGVudC1BdXRob3IkY29sdG9uYW5nZWxhbGpmbDM0DkNoYWluSWQENTYcQ29udGVudC1UYXJnZXSAATM5ZjAyMTg4MWU3Mzg2ZjhkNzNkNmVmMjU1MzNlNjA5MWYyYTAyNTZlNDIyYjRiM2M0ZTNkMzM1Y2NhZTE0N2UAeyJjb250ZW50Ijoie1wib3BcIjpcImNvbW1lbnRcIixcImFkZHJlc3NcIjpcIjB4ZjIwMmVmMGNmNDhjYmM5ZTgyZWQ4ZWMxYTIzZDMzNmIyYTMwMzMwMFwiLFwidHNcIjoxNjkxNDYwNjIwNzQ1LFwiY2hhaW5JZFwiOjU2LFwiaGFuZGxlXCI6XCJjb2x0b25hbmdlbGFsamZsMzRcIixcInRhcmdldFwiOlwiMzlmMDIxODgxZTczODZmOGQ3M2Q2ZWYyNTUzM2U2MDkxZjJhMDI1NmU0MjJiNGIzYzRlM2QzMzVjY2FlMTQ3ZVwiLFwidGl0bGVcIjpcIkZsYXBweU1vb25iaXJkXCIsXCJib2R5XCI6XCJEYW1uIGl0LiBTbyBlbmdhaW5nIHRoYXQgSSBwbGF5ZWQgYWxsIG5pZ2h0LlwifSIsImRpZ2VzdCI6IjdlNWJjNGE1ODNkODY3NzRiNDE3YmMyZTc2YmRhNjcxMzBiODUyYWI0MzlkMTQ3YzYzNDI2ODU0MjgyZjA3N2MiLCJzaWduYXR1cmUiOiIweDc4OWNlMGFkMDU3MTUzZTZlMGRlYTliYWNlYmQ4MjM2YjE0YjhmMjNjOTg2YzUwYzRmNGRhOTRmYWM1NmJmMzAyOWVhMDhkZjIxZTkyNzE0ZjlkYWU3MmU3ZDI0ZmZmODZhMjQxMGQyZGYwYzM0ZGYwZDQzMmY0N2ZkZjBhYWZhIiwic2lnbmluZ0tleSI6eyJwdWJsaWNLZXkiOiJNRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUVCZzZ0V1pyd05yRXVtN21FdWZRVit0dzViSnhjZ2gvNzVTc05RZEEwUFhGQ1RqbkZkSnlaQXo4YW5GS1FKL3VFa0dFSDZJM1k1NWp4UG9UZUYwZGdDZz09IiwiZm9ybWF0IjoiU3ViamVjdFB1YmxpY0tleUluZm8iLCJhbGdvcml0aG0iOiJFUzI1NiJ9LCJzaWduaW5nS2V5QXV0aCI6eyJhZGRyZXNzIjoiMHhmMjAyZWYwY2Y0OGNiYzllODJlZDhlYzFhMjNkMzM2YjJhMzAzMzAwIiwic2lnbmluZ0tleVNpZ25hdHVyZSI6IjB4ZTY3MzhhZjM4ZTFiZjg2MTFjY2UxOGNjN2QyNjAxMTllZWEzOWEyMGFjMzYyMDZhNGUwZDAxZDk3OWI4NjI3NzcxOGVkODZlOGEyOTkwNTQ5ZWQwNTM4YTljYjU5YTRmNjFlYjFkODdmYTc1MjJjMWViZWEzMTk1ZjFmYjY1ZWIxYyIsInNpZ25pbmdLZXlNZXNzYWdlIjoiSSBhdXRob3JpemUgQ3liZXJDb25uZWN0IGZyb20gdGhpcyBkZXZpY2UgdXNpbmcgc2lnbmluZyBrZXk6XG5NRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUVCZzZ0V1pyd05yRXVtN21FdWZRVit0dzViSnhjZ2gvNzVTc05RZEEwUFhGQ1RqbkZkSnlaQXo4YW5GS1FKL3VFa0dFSDZJM1k1NWp4UG9UZUYwZGdDZz09In19AQCI6rlxFMer8FzvqekmclPzmJfPgnqGBWF_B8DnlQg_mDpLATWYrn7c2nv53E_P9IKmmbnriuIBxP-ujJKlu0sB0FmkTZpWX0H5IHNV8DppeS1HeHutBgySgSpkjEAdhrA1thbtdCplYSYCPfo-mzS_Q6b5xEX6WvqTFtls0Z405GWe1ob-sdUc5RDHBqmxBwWtoStn7p71vKuEyn9Y0XAAjcyKFksXnPqlpuX-9tHpVoHIFmIzfdRdrPU3qhxtna3u3jX4v9ksz-nqAkQedk3DDHnCHQ0WWRBvBDL82in06MldqTnkQL3Ih2lkyvtfcysE-3Nfx4mVxSyFFfkeZHcwZNE-1Guw3OeuDOA6GJzrZjBLPMsH6f95Fdn0B9vPNT8Y5_IOO_FumvBa5Be5nShI-ad7FcWDXhOtmA3aE0asMKdiUV9zV-MeT-dUxWWDw7T7zbknFoYU-eHjlwP3oRRYzeccv6qUAGnI_38evf5druIkgG4fHn4J4rzpnHNfdiZ4bvOQbWNd2c661aXcLZ89y-MfnOgqKowGg8vlqDdn6Yp17fQnfZsyGpkoXdMvO0Z2LRDeEdwZRrfZSCP1GKzPBusYgjxNbIICKMW3ZYeqZZFnI9HEdlGf8qeXVJspBOUWoWnPRE3ANHP9SLik9LqhR85Tpd1kOKG2RfeDzGJcd5z4F-1slaE508RbcjB8yv4skPYyk7kzbz2Q76Sl8q2iLoze8XAuDbyd2ifM7LFCxUDYKoguXENqKWxToYNAOxiyAZFzcElcA-QQXxxwrIlfpsI46nbo5Zc8vqUeQQr71dhWeD5VQILMV_IQhEFDVaTuf4CEkhP0ni7kVl5YXUkUSOHRhTVpuxO-WSc3jp_wuYWQrkIyHYEv2vjv_-b9jKgUJSg1HbcOeKV54lJGQOFIT1zYHBsFb3QQ7MmwiXjP_2pFQ4Q1q2Op6hjqMx36yFEtVUfwnaOCz-ew5UpDzsH2_NTAwZGI8z7tR2DUyxFAnFojbcNPmFe4-Hg8f2uaenrDYiGSJ1ytwyRsNmuDWu3vRckS1s0jT7XeeGLNKo3BmE1cCSb5eHuqBO2zD1ykqbQInojt44QpwxUTpeFptzV9mtSBOA2WH5NYUY4YuO6fU4G2ZgZMPP9cua7p3gG-GZjsjtY4jsUOpkAgTvgEKaKB52nDZULYIctOZUUeZKnSbAxHGWbkqaeJ7kCU-35AY5kTm8NZTqp6cgwcKxBSkP93LddraDyyjeo303WFO52jmNMXvTfw7lq1Zc1mQ475LnIi2duT-lSOCOK60WybsFQJOUVwT1eEXF7h_vEmT5bopUOrX8oCwxFUHhfJbZa0TMRJo6FDfRipD435smc7HpZpAAAIAAAAAAAAAIQBAAAAAAAAD4AGGENvbnRlbnQtVHlwZSBhcHBsaWNhdGlvbi9qc29uFkFwcGxpY2F0aW9uGEN5YmVyQ29ubmVjdBxDb250ZW50LURpZ2VzdIABZDlmMmRlMzMxZTU1MDRjZmRlOTkyYjIyZWYyYmEwMGU0ZWY1NWI1YjBiZGQ1MTcxY2JmYTk0ZDYwYmM4NzhiZBxDb250ZW50LUF1dGhvciZsYWJvcmVsd2F1dGVtX2N5YmVyDkNoYWluSWQENTYcQ29udGVudC1UYXJnZXSAATM5ZjAyMTg4MWU3Mzg2ZjhkNzNkNmVmMjU1MzNlNjA5MWYyYTAyNTZlNDIyYjRiM2M0ZTNkMzM1Y2NhZTE0N2UMU291cmNlSDE1NTMxZmEyLTEyMDUtNGY2MS1iNmU0LWM5ZjY4ZWNmODFmNxRDb250ZW50LUlkgAFkOWYyZGUzMzFlNTUwNGNmZGU5OTJiMjJlZjJiYTAwZTRlZjU1YjViMGJkZDUxNzFjYmZhOTRkNjBiYzg3OGJkAHsiY29udGVudCI6IntcIm9wXCI6XCJjb21tZW50XCIsXCJhZGRyZXNzXCI6XCIweGRiY2IwZTMzMjU4M2JjMmRjNDEwODA2ZTgxZmRmNWFjODI1MzAwOGZcIixcInRzXCI6MTY5MTQ2MDYyMTE1MCxcImNoYWluSWRcIjo1NixcImhhbmRsZVwiOlwibGFib3JlbHdhdXRlbV9jeWJlclwiLFwidGFyZ2V0XCI6XCIzOWYwMjE4ODFlNzM4NmY4ZDczZDZlZjI1NTMzZTYwOTFmMmEwMjU2ZTQyMmI0YjNjNGUzZDMzNWNjYWUxNDdlXCIsXCJ0aXRsZVwiOlwiRmxhcHB5TW9vbmJpcmRcIixcImJvZHlcIjpcIlNvIGZ1biB0byBwbGF5IGluIG15IHNwYXJlIHRpbWUuXCJ9IiwiZGlnZXN0IjoiZDlmMmRlMzMxZTU1MDRjZmRlOTkyYjIyZWYyYmEwMGU0ZWY1NWI1YjBiZGQ1MTcxY2JmYTk0ZDYwYmM4NzhiZCIsInNpZ25hdHVyZSI6IjB4OTQzZjBmMTIyOTgwZmZkZGYwMDQ0Y2NhNTVjNjU3MDI0YzNiZWY1NWMzZjdiMjEwYmE0N2EwY2VlZWU3Njk1MThlYTYyYjJkNDJlYmNjYmU2YjJjYjMzYTcyZGRhYjQ4YTM4NjRmZTIwZWQyMzQxOTA3YTM3ZTc1ZDMxZWQ4MmMiLCJzaWduaW5nS2V5Ijp7InB1YmxpY0tleSI6Ik1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRW1FK0FvYW9HYkhHb0ZkWUZwMDFucVpCZDBqYVJLelNWZ3hsUWU1U04zd09LKzhCZE1YTGR6S0dIMkdpRHJHNGJFb25mSWh3Wkp1OU9xc0VvZExiVEVnPT0iLCJmb3JtYXQiOiJTdWJqZWN0UHVibGljS2V5SW5mbyIsImFsZ29yaXRobSI6IkVTMjU2In0sInNpZ25pbmdLZXlBdXRoIjp7ImFkZHJlc3MiOiIweGRiY2IwZTMzMjU4M2JjMmRjNDEwODA2ZTgxZmRmNWFjODI1MzAwOGYiLCJzaWduaW5nS2V5U2lnbmF0dXJlIjoiMHg5YzdmMWVjNTkwMjU3YmQ1Njc2Yjk0ZTgwNzE0ZjViYzJhZGMwNTQ0NjYyMzQ3MDJlYWZhNzdhOTIxMGQ4MTUwNjMwZWYxOTg4Mzc3ZjE0ZDQ5ZmNjYzllOGFhNzg3YjhiOTFhNmQ2ZTQ2NGJmZDczZjU5Y2Q0NmI3OGI3ZDdiOTFiIiwic2lnbmluZ0tleU1lc3NhZ2UiOiJJIGF1dGhvcml6ZSBDeWJlckNvbm5lY3QgZnJvbSB0aGlzIGRldmljZSB1c2luZyBzaWduaW5nIGtleTpcbk1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRW1FK0FvYW9HYkhHb0ZkWUZwMDFucVpCZDBqYVJLelNWZ3hsUWU1U04zd09LKzhCZE1YTGR6S0dIMkdpRHJHNGJFb25mSWh3Wkp1OU9xc0VvZExiVEVnPT0ifX0BAIi0MGv509ewzuQcTTGaXlKVMCJ8D7zliOgOx01j2ryMyIHg_T52PHYV4L8hBo0ByOvlzDrq28ROBFCUuxF6jDfZZLwgBSIQXSdkCGJgpBgO6JcDfAEKWecMR4JEKrWu4_fGzTrHqY2GGjQhXP6-fjGRSkYanurI0yYvsQOi7VMIGvu0o7edWgqTentohFSTimDCSmjazg_M2Uka1IG1dLvEcuJGXmyG4vYIoYvtXb4SBcn-VT3VHX6K__EkdB0iEfTlU0lsp4JGOoSCXkPdX4LG2cfMTTbWRf6wqnz-rNQUIHM05UVPVgkVbEK25eZCkrCOeZ2gOpBu91P98ytR638jw_pg2wtxJod-0mCOPwbr0x0aMHtZpmV223bQ0pGHiPTtBQjLTtF-wLP8GEzRvHHwPrx73bmPe6V3uw8H0cQ0at4OLHVvn412V6FLTS2MySJhV6x4K4ggPrlksfdASAH6flKfYi8_6gxBNoVIUCISADXEifalt0Iy5d33s1TAzF9s-9tI-U0Lydpt1Xy3Nsd58maACHep0C5OjX2G0hebeLKQN6rbnMwFZUE0vSfmoSVEUcbCNdbudoyGwXkjfR2TJ-XCTixPJf-Skes2G4PoVVcXs9u6pgl_6bn1LvCkL8ZPrmBMEuQTIuLazN732QqnAVkEsp6um7MIiaUx8S2CnPgX7WyVoTnTxFtyMHzK_iyQ9jKTuTNvPZDvpKXyraIujN7xcC4NvJ3aJ8zssULFQNgqiC5cQ2opbFOhg0A7GLIBkXNwSVwD5BBfHHCsiV-mwjjqdujllzy-pR5BCvvV2FZ4PlVAgsxX8hCEQUNVpO5_gISSE_SeLuRWXlhdSRRI4dGFNWm7E75ZJzeOn_C5hZCuQjIdgS_a-O__5v2MqBQlKDUdtw54pXniUkZA4UhPXNgcGwVvdBDsybCJeM__akVDhDWrY6nqGOozHfrIUS1VR_Cdo4LP57DlSkPOwfb81MDBkYjzPu1HYNTLEUCcWiNtw0-YV7j4eDx_a5p6esNiIZInXK3DJGw2a4Na7e9FyRLWzSNPtd54Ys0qjcGYTVwJJvl4e6oE7bMPXKSptAieiO3jhCnDFROl4Wm3NX2a1IE4DZYfk1hRjhi47p9TgbZmBkw8_1y5runeAb4ZmOyO1jiOxQ6mQCBO-AQpooHnacNlQtghy05lRR5kqdJsDEcZZuSpp4nuQJT7fkBjmRObw1lOqnpyDBwrEFKQ_3ct12toPLKN6jfTdYU7naOY0xe9N_DuWrVlzWZDjvkuciLZ25P6VI4I4rrRbJuwVAk5RXBPV4RcXuH-8SZPluilQ6tfygLDEVQeF8ltlrRMxEmjoUN9GKkPjfmyZzselmkAAAcAAAAAAAAADAEAAAAAAAANkAQYQ29udGVudC1UeXBlIGFwcGxpY2F0aW9uL2pzb24WQXBwbGljYXRpb24YQ3liZXJDb25uZWN0HENvbnRlbnQtRGlnZXN0gAEyM2ZiN2YzNzkyNTVkOTY5Njc4ZTlhMTBjNmM2MjZkODc3YWRhMmUwZTg3MTQ0ZTA4MzRjMGU4YjQ0NGY1NDhiHENvbnRlbnQtQXV0aG9yGHBtaDVoM2E4bzhuYQ5DaGFpbklkBDU2DFNvdXJjZQhhdGVtFENvbnRlbnQtSWSAATIzZmI3ZjM3OTI1NWQ5Njk2NzhlOWExMGM2YzYyNmQ4NzdhZGEyZTBlODcxNDRlMDgzNGMwZThiNDQ0ZjU0OGIAeyJjb250ZW50Ijoie1wib3BcIjpcInBvc3RcIixcImFkZHJlc3NcIjpcIjB4MGQ1NTIyNGZhM2QxZGRjNjVkZjYzYjMwYmYwZTkzYWQ1OGVlNTI5NlwiLFwidHNcIjoxNjkxNDYwNjIwMzAxLFwiY2hhaW5JZFwiOjU2LFwiaGFuZGxlXCI6XCJwbWg1aDNhOG84bmFcIixcInRpdGxlXCI6XCIxMTExMlwiLFwiYm9keVwiOlwiMjIyMjIyMjIyMjIyMjIyMjIyXCJ9IiwiZGlnZXN0IjoiMjNmYjdmMzc5MjU1ZDk2OTY3OGU5YTEwYzZjNjI2ZDg3N2FkYTJlMGU4NzE0NGUwODM0YzBlOGI0NDRmNTQ4YiIsInNpZ25hdHVyZSI6IjB4YTNlMWM0MDVkZDdhZmNlMzNmZDRlMTU0YzA2NDEzOTNiM2EwODJiYjBmNWMzZTk0MTM2MzZmM2Q3MzYwZmE4YTY5ZTgxMjgyNWI5N2E2MzYyNmFjNDFiOTBmZjk0MGMyMTZiYTY1NTIwODYwNDk0Mzc3ZTY1NDY2Zjc1MGI4ZTIiLCJzaWduaW5nS2V5Ijp7InB1YmxpY0tleSI6Ik1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRXpXSlE3c1dtRHg4RTQxNHBUOHhmOTI5eTdQVkk5ckNVeTlzcGVDRlc1RDFpNjJoVTNsZGZnS3pJT1hNN1pSbnBPV1FYZWV2UW5BZGsvWCs1bnI3a1d3PT0iLCJmb3JtYXQiOiJTdWJqZWN0UHVibGljS2V5SW5mbyIsImFsZ29yaXRobSI6IkVTMjU2In0sInNpZ25pbmdLZXlBdXRoIjp7ImFkZHJlc3MiOiIweDBkNTUyMjRmYTNkMWRkYzY1ZGY2M2IzMGJmMGU5M2FkNThlZTUyOTYiLCJzaWduaW5nS2V5U2lnbmF0dXJlIjoiMHhjMTQ3MzE5YTI2MzYwYjIxMWFiNjM5NDlhNjZjOTgxMGZmYzVkM2JmZmU3MzgyZGU4ZTg2ZGUyZWJhY2JhYTEwNTQ5MjU2YjJjY2M4OGEzYWZlMGMwMjk5ODYzODU4Y2Q2ZjExYWRjZWQ5OWM4YTljODBkZDYzNGUwZGIyZWI5MzFjIiwic2lnbmluZ0tleU1lc3NhZ2UiOiJJIGF1dGhvcml6ZSBBdGVtUmV2aWV3IGZyb20gdGhpcyBkZXZpY2UgdXNpbmcgc2lnbmluZyBrZXk6XG5NRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUV6V0pRN3NXbUR4OEU0MTRwVDh4ZjkyOXk3UFZJOXJDVXk5c3BlQ0ZXNUQxaTYyaFUzbGRmZ0t6SU9YTTdaUm5wT1dRWGVldlFuQWRrL1grNW5yN2tXdz09In19AQBDNk_te6kOKW6sliJ6ugnnlvgZSpFs53SEw3XjmeOhZSg8Ox_xUZ7RCAY2LTIugNiWJ7Vr-IGJu2j9uXvijgfWnDFTy5GRHJUfdFFa7Ug6PQocdLtLODz4CSewe23RZvuToof5QlUqC0YJQ7k_2TppYTjlO1s2SKZEiCi_ls-0BkPMauPf9-8i9aBlKiCbrlVPMYkg1daAgpJG5BqQmqUBXfY5AMwk5_Sp1JukIaigGAGLoAkQRlMBXF-PJ05NCeeooPVLHt05P3JbXmow96OmH2bKAr_Oq_wysRBsLft3Dz2rddZCIaRO3gKFNHAW3fpjirXGW8zr4PC7HeUPJ0cBn4uiZNFrgz8dVWWyuRoyD6SnxWOdcehqBmvXktAzb-6iB6Nkg4oPI5I-g_MBtKciwesQUnQ6k7DpDDnqpNr3Yn9l7r1OaelL-iz3omerVFGcAgV-MHu6rXTSeScGzMy_V73O03BFM2Hs2mZZUnPFaVykqAsh5rFwFIZjZ3ZzFrFd9uDZ1TCnAHLDnji1r_PiT-7Hxo_svPoKs2H-Wt9ONYWLTDJ7fITuR598o5Yclp_DTOJHg3w_9pIiYszm7fz-eEOU1Hll_2LNbZDk-EuATvJ-bcT6H9qTI7-9zNZ4fF_fkg3Y5Q59Rx-wKbG2fxc2-Opiyyxq1FmXH9y1MkN7zpz4F-1slaE508RbcjB8yv4skPYyk7kzbz2Q76Sl8q2iLoze8XAuDbyd2ifM7LFCxUDYKoguXENqKWxToYNAOxiyAZFzcElcA-QQXxxwrIlfpsI46nbo5Zc8vqUeQQr71dhWeD5VQILMV_IQhEFDVaTuf4CEkhP0ni7kVl5YXUkUSOHRhTVpuxO-WSc3jp_wuYWQrkIyHYEv2vjv_-b9jKgUJSg1HbcOeKV54lJGQOFIT1zYHBsFb3QQ7MmwiXjP_2pFQ4Q1q2Op6hjqMx36yFEtVUfwnaOCz-ew5UpDzsH2_NTAwZGI8z7tR2DUyxFAnFojbcNPmFe4-Hg8f2uaenrDYiGSJ1ytwyRsNmuDWu3vRckS1s0jT7XeeGLNKo3BmE1cCSb5eHuqBO2zD1ykqbQInojt44QpwxUTpeFptzV9mtSBOA2WH5NYUY4YuO6fU4G2ZgZMPP9cua7p3gG-GZjsjtY4jsUOpkAgTvgEKaKB52nDZULYIctOZUUeZKnSbAxHGWbkqaeJ7kCU-35AY5kTm8NZTqp6cgwcKxBSkP93LddraDyyjeo303WFO52jmNMXvTfw7lq1Zc1mQ475LnIi2duT-lSOCOK60WybsFQJOUVwT1eEXF7h_vEmT5bopUOrX8oCwxFUHhfJbZa0TMRJo6FDfRipD435smc7HpZpAAAIAAAAAAAAAH0BAAAAAAAAD_IFGENvbnRlbnQtVHlwZSBhcHBsaWNhdGlvbi9qc29uFkFwcGxpY2F0aW9uGEN5YmVyQ29ubmVjdBRDb250ZW50LUlkgAE0N2I3OGYyYjdiYTAwZjg1ZWYyYzFmMTRiNzk5OTRiOWY2NGI5ZjA1YzBjODYxODEwZmZiMzNiNGMwZWE1YmI5HENvbnRlbnQtRGlnZXN0gAE0N2I3OGYyYjdiYTAwZjg1ZWYyYzFmMTRiNzk5OTRiOWY2NGI5ZjA1YzBjODYxODEwZmZiMzNiNGMwZWE1YmI5HENvbnRlbnQtQXV0aG9yGGtlczZnYzllY2NlZA5DaGFpbklkBDU2HENvbnRlbnQtVGFyZ2V0gAEzOWYwMjE4ODFlNzM4NmY4ZDczZDZlZjI1NTMzZTYwOTFmMmEwMjU2ZTQyMmI0YjNjNGUzZDMzNWNjYWUxNDdlDFNvdXJjZUgxNTUzMWZhMi0xMjA1LTRmNjEtYjZlNC1jOWY2OGVjZjgxZjcAeyJjb250ZW50Ijoie1wib3BcIjpcImNvbW1lbnRcIixcImFkZHJlc3NcIjpcIjB4YjQyOTY4NGNmNDRkMzhiYTAxOTk0ZGNmOWY5MzQ5YWRkNmUyZGZlZVwiLFwidHNcIjoxNjkxNDYwNjE5NjY2LFwiY2hhaW5JZFwiOjU2LFwiaGFuZGxlXCI6XCJrZXM2Z2M5ZWNjZWRcIixcInRhcmdldFwiOlwiMzlmMDIxODgxZTczODZmOGQ3M2Q2ZWYyNTUzM2U2MDkxZjJhMDI1NmU0MjJiNGIzYzRlM2QzMzVjY2FlMTQ3ZVwiLFwidGl0bGVcIjpcIkZsYXBweU1vb25iaXJkXCIsXCJib2R5XCI6XCJTbyBmdW4gdG8gcGxheSBpbiBteSBzcGFyZSB0aW1lLlwifSIsImRpZ2VzdCI6IjQ3Yjc4ZjJiN2JhMDBmODVlZjJjMWYxNGI3OTk5NGI5ZjY0YjlmMDVjMGM4NjE4MTBmZmIzM2I0YzBlYTViYjkiLCJzaWduYXR1cmUiOiIweDE4ZDYwZjM1YmMzMmEzOGRlYjZkODg2M2I3NmE2MzNkN2NjZGI5OGU0YTBiYTdkOTUxYTk3Zjg0MWFhYzE3ZDM5OTIwZThjNjVhMGRhNjU0NDRlZWIwZjM2ZTJiMzZiZTg4NDVhYTNhYzg4NTY3Y2EzY2U4MmE5MGQ0MGUzMmY2Iiwic2lnbmluZ0tleSI6eyJwdWJsaWNLZXkiOiJNRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUVOS1RaR3dXUzV0U0prakVkOEMzVXpZWEdnNHVaSzlheWJBV0hQd3RUSE52NHVtanZ0SzR2WkVTUFRFY015OFZxc2dtN3k2dlA1b2RmeFJycnVXVVJYZz09IiwiZm9ybWF0IjoiU3ViamVjdFB1YmxpY0tleUluZm8iLCJhbGdvcml0aG0iOiJFUzI1NiJ9LCJzaWduaW5nS2V5QXV0aCI6eyJhZGRyZXNzIjoiMHhiNDI5Njg0Y2Y0NGQzOGJhMDE5OTRkY2Y5ZjkzNDlhZGQ2ZTJkZmVlIiwic2lnbmluZ0tleVNpZ25hdHVyZSI6IjB4ZjdhOTZhMDEyYjFjNzkwOWMxYjYwOGMwYjQyYTI3NDJiMmJjNmViMjlhNDE5NTQxNTE1MjllZDVkMGIyNjZjMjRkMzcxZjY4OTZlNDEwNTQ5ZWQ1MWY1ZGU2ZjUzZGEzNjhkYjJiMzg4OTU2ZDE2OTdjZmM2ODkwZTc5ODc2NWMxYiIsInNpZ25pbmdLZXlNZXNzYWdlIjoiSSBhdXRob3JpemUgQ3liZXJDb25uZWN0IGZyb20gdGhpcyBkZXZpY2UgdXNpbmcgc2lnbmluZyBrZXk6XG5NRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUVOS1RaR3dXUzV0U0prakVkOEMzVXpZWEdnNHVaSzlheWJBV0hQd3RUSE52NHVtanZ0SzR2WkVTUFRFY015OFZxc2dtN3k2dlA1b2RmeFJycnVXVVJYZz09In19AQACXtWtuiKouB5IRrgTDUyqxLcRdtTzC3oOQbINn-Ij4knOvd8O7jjcBSjrplTaSU5_q9N53c_DpqSjBYl_aw4rAINgpN4wl_06iyv0baYCR-Dw4aDoQtoiy-ue00uAUfcVINTvqUYgalB0f6wiI4hnsixTFSHzYrvlmPuJN1OFzzRiqbTOByRMS9DVIcnMHbPkgaWgm7IS1GflEHdembPTMRpKz5taW1N-QqPNNCNbwl7P1TK9dmf0AJtDkmg7WC6oHbxBBYqt0Kzrlt5RQaWpYI1TsVWjTsfxBHcUAp0fzkQ2Tsg0d8XwNf-qReAeD1SFmdWIwoeDssCLsmYHeeUw5GKwR-S_UFkk8dKlYpu2oS7XODcX-PAgtTE7X2EXrtOhpNaIE49h-JUXD9AE-Z0rofzj69O5K8TpcQVrA3Q-uS4hsUV5XVEGferuCR8nHoyzKoIOqxQqncJj3dXN48Z91w5zcNK8KLkRAHhc_IA5SqPtVlU8jFpS3HUcIWxUPdz85ZKUpSuulvX6xa5Le9xp4iFQ3AcvqjQ-4Vqm_-cNV9JuVlPmJ88DsWgfVWYcZEhHmh408UR52hEhJjH5ArQ8V2hMFUvUNhdAfhpRevU403b_Ak-wHpdaEjdhV3AEVGY7vcHQnudUR6PmuTagkI0i57Gl2pPeskc6YB0MfPom15z4F-1slaE508RbcjB8yv4skPYyk7kzbz2Q76Sl8q2iLoze8XAuDbyd2ifM7LFCxUDYKoguXENqKWxToYNAOxiyAZFzcElcA-QQXxxwrIlfpsI46nbo5Zc8vqUeQQr71dhWeD5VQILMV_IQhEFDVaTuf4CEkhP0ni7kVl5YXUkUSOHRhTVpuxO-WSc3jp_wuYWQrkIyHYEv2vjv_-b9jKgUJSg1HbcOeKV54lJGQOFIT1zYHBsFb3QQ7MmwiXjP_2pFQ4Q1q2Op6hjqMx36yFEtVUfwnaOCz-ew5UpDzsH2_NTAwZGI8z7tR2DUyxFAnFojbcNPmFe4-Hg8f2uaenrDYiGSJ1ytwyRsNmuDWu3vRckS1s0jT7XeeGLNKo3BmE1cCSb5eHuqBO2zD1ykqbQInojt44QpwxUTpeFptzV9mtSBOA2WH5NYUY4YuO6fU4G2ZgZMPP9cua7p3gG-GZjsjtY4jsUOpkAgTvgEKaKB52nDZULYIctOZUUeZKnSbAxHGWbkqaeJ7kCU-35AY5kTm8NZTqp6cgwcKxBSkP93LddraDyyjeo303WFO52jmNMXvTfw7lq1Zc1mQ475LnIi2duT-lSOCOK60WybsFQJOUVwT1eEXF7h_vEmT5bopUOrX8oCwxFUHhfJbZa0TMRJo6FDfRipD435smc7HpZpAAAHAAAAAAAAAAwBAAAAAAAADZAEGENvbnRlbnQtVHlwZSBhcHBsaWNhdGlvbi9qc29uFkFwcGxpY2F0aW9uGEN5YmVyQ29ubmVjdBRDb250ZW50LUlkgAE5MTBkYjRjN2YyMDY5MTU3ZTQ4OGM3MmU3NjUwMjRkNDRiY2RjY2U5NTBhYjg5YWFjYWE2NWMzYzAyNmJjMTYwHENvbnRlbnQtRGlnZXN0gAE5MTBkYjRjN2YyMDY5MTU3ZTQ4OGM3MmU3NjUwMjRkNDRiY2RjY2U5NTBhYjg5YWFjYWE2NWMzYzAyNmJjMTYwHENvbnRlbnQtQXV0aG9yGGh3eWx2c29yNTV3cA5DaGFpbklkBDU2DFNvdXJjZQhhdGVtAHsiY29udGVudCI6IntcIm9wXCI6XCJwb3N0XCIsXCJhZGRyZXNzXCI6XCIweDBhYTJjMmRhOGJkNWYzZGQ2NzBmMzhjMzAyYTU1NTYxY2JmMzNmZDJcIixcInRzXCI6MTY5MTQ2MDYyMDAzOCxcImNoYWluSWRcIjo1NixcImhhbmRsZVwiOlwiaHd5bHZzb3I1NXdwXCIsXCJ0aXRsZVwiOlwiMTExMTJcIixcImJvZHlcIjpcIjIyMjIyMjIyMjIyMjIyMjIyMlwifSIsImRpZ2VzdCI6IjkxMGRiNGM3ZjIwNjkxNTdlNDg4YzcyZTc2NTAyNGQ0NGJjZGNjZTk1MGFiODlhYWNhYTY1YzNjMDI2YmMxNjAiLCJzaWduYXR1cmUiOiIweDUxNjVhMzUyODVjN2Q5Yzg4NmM4ZWJlOWI3MmU2ZmE0ZTYwZWI2ZmY4YzMzMGQ1MGM2MTM0M2I1NzFmODBlOTIwM2I2ZGI5MWVjYmRiNjIwMjY3MWVlNWM2ZDE2OWM3NzA2OTk3YzJhNzJjZmM3M2Y3YjA3OWJkMjVlYmJmYmI4Iiwic2lnbmluZ0tleSI6eyJwdWJsaWNLZXkiOiJNRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUVacVQvREMzdGRPMXRZeXdIb0pDMG9ibHRkSXl0djJKd1pwQXZEZnAvMnRtUVZrOVBhOEp0a2FSZTFEeHVWc2RjbXE0SlhwYmYvSHdDRFRJNW5zNmV1QT09IiwiZm9ybWF0IjoiU3ViamVjdFB1YmxpY0tleUluZm8iLCJhbGdvcml0aG0iOiJFUzI1NiJ9LCJzaWduaW5nS2V5QXV0aCI6eyJhZGRyZXNzIjoiMHgwYWEyYzJkYThiZDVmM2RkNjcwZjM4YzMwMmE1NTU2MWNiZjMzZmQyIiwic2lnbmluZ0tleVNpZ25hdHVyZSI6IjB4Yzc3YThjMWJlZTM0OTZiMjBjNDFhYTlkNTUwMWQ5MDg4M2Y1YWViYTNjMTc4NTk2ZWZmNTY1NzA0MDVhOTMwYTcwZjgyZWFmNDBkYjI4YTA2MjkwMTU2NTViN2M2MWI4NjBhZTdhMDMwNzU4NGZiZDVkMmQ4ZjgxM2UzYWVmYmUxYiIsInNpZ25pbmdLZXlNZXNzYWdlIjoiSSBhdXRob3JpemUgQXRlbVJldmlldyBmcm9tIHRoaXMgZGV2aWNlIHVzaW5nIHNpZ25pbmcga2V5OlxuTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFWnFUL0RDM3RkTzF0WXl3SG9KQzBvYmx0ZEl5dHYySndacEF2RGZwLzJ0bVFWazlQYThKdGthUmUxRHh1VnNkY21xNEpYcGJmL0h3Q0RUSTVuczZldUE9PSJ9fQEAYdoiny8bNp2mBpuPgFI4dxe1xOytTztoYskYCv9ESAELdknF00jjtyM5OjtfFfPqey8FhWPzhIHXZ8_JK8lp79mKN2lXnj6McJ5X4OrBWNLL4Aq3orvvqwSr_-8VCFoEKPT2_bY8bSSzFeOa1CE9wRitJJXqunGp0GZkdoklwfWU0APTjbBm2vFVP7W5_wIq_dflFzRkZm4oXsgyNgYucelDzi5fWplUzlqWO9jtK0ymBuCqrUg827uwB8Ytnp41PObmIKNP-RRyj3mDonSdTVRLVFFApImGQb2TRl0wxKLc1aAf-krgVv5o6Aa_1IoUdKet4O8kpJCElq1zGoIDHBpo7QHL8BCl_VNMf9C-3edmdtK6SpNdfwUZTtk2q3x5fvmjNfeGtu-QqJtsoORy3J6Y2qKD8kbBFbX-_OdYkDUrUs_T6xTFcEe71q2YpLz4LaE-HtcdYuaXdyLqSuee2-fmPd_F7NGs5ERe86G7Cke11o7_lYyDoZwKJEh3yxJbWWdaA-m_tcV5-S3z27XHhp878SfovxX7xuYiMCMK72L8yHmsBxa328xLwk_PiDD11AIB4bls_TzaNnZIhfTgwYRy21qw_cREJ-ox5m3Z2_WIcTNP5S9Yx5wP7VKJ71_cFWxgdNf3JTm140JXh9V62sesPmt3Dg4jd7FPiwBbxRWc-BftbJWhOdPEW3IwfMr-LJD2MpO5M289kO-kpfKtoi6M3vFwLg28ndonzOyxQsVA2CqILlxDailsU6GDQDsYsgGRc3BJXAPkEF8ccKyJX6bCOOp26OWXPL6lHkEK-9XYVng-VUCCzFfyEIRBQ1Wk7n-AhJIT9J4u5FZeWF1JFEjh0YU1absTvlknN46f8LmFkK5CMh2BL9r47__m_YyoFCUoNR23DnileeJSRkDhSE9c2BwbBW90EOzJsIl4z_9qRUOENatjqeoY6jMd-shRLVVH8J2jgs_nsOVKQ87B9vzUwMGRiPM-7Udg1MsRQJxaI23DT5hXuPh4PH9rmnp6w2IhkidcrcMkbDZrg1rt70XJEtbNI0-13nhizSqNwZhNXAkm-Xh7qgTtsw9cpKm0CJ6I7eOEKcMVE6Xhabc1fZrUgTgNlh-TWFGOGLjun1OBtmYGTDz_XLmu6d4BvhmY7I7WOI7FDqZAIE74BCmigedpw2VC2CHLTmVFHmSp0mwMRxlm5Kmnie5AlPt-QGOZE5vDWU6qenIMHCsQUpD_dy3Xa2g8so3qN9N1hTudo5jTF7038O5atWXNZkOO-S5yItnbk_pUjgjiutFsm7BUCTlFcE9XhFxe4f7xJk-W6KVDq1_KAsMRVB4XyW2WtEzESaOhQ30YqQ-N-bJnOx6WaQAABwAAAAAAAAAMAQAAAAAAAA2QBBhDb250ZW50LVR5cGUgYXBwbGljYXRpb24vanNvbhZBcHBsaWNhdGlvbhhDeWJlckNvbm5lY3QUQ29udGVudC1JZIABMWQ0ODcxMWEwZTEwZjg5MTQ1YmRiZjI1NWM1NjY5NDdkY2M5OWY5YjU0NDU4ZDM5NmY1MTEyN2MwOWQ1M2ZhYhxDb250ZW50LURpZ2VzdIABMWQ0ODcxMWEwZTEwZjg5MTQ1YmRiZjI1NWM1NjY5NDdkY2M5OWY5YjU0NDU4ZDM5NmY1MTEyN2MwOWQ1M2ZhYhxDb250ZW50LUF1dGhvchhxMTkzNTY3MjM0NHoOQ2hhaW5JZAQ1NgxTb3VyY2UIYXRlbQB7ImNvbnRlbnQiOiJ7XCJvcFwiOlwicG9zdFwiLFwiYWRkcmVzc1wiOlwiMHg2Y2YxNjc2YTQ3ZWI2MDk2ODhkZDVjMzZhYzg4ZGYxM2EyYWUwNDQ2XCIsXCJ0c1wiOjE2OTE0NjA2MjEyOTUsXCJjaGFpbklkXCI6NTYsXCJoYW5kbGVcIjpcInExOTM1NjcyMzQ0elwiLFwidGl0bGVcIjpcIjExMTEyXCIsXCJib2R5XCI6XCIyMjIyMjIyMjIyMjIyMjIyMjJcIn0iLCJkaWdlc3QiOiIxZDQ4NzExYTBlMTBmODkxNDViZGJmMjU1YzU2Njk0N2RjYzk5ZjliNTQ0NThkMzk2ZjUxMTI3YzA5ZDUzZmFiIiwic2lnbmF0dXJlIjoiMHg3ZjgyZTcyNTJjYzgwOWE3MTQ5ZWU5Y2QzZTY0ZDZmMTBhMjQxZGI4NzVjYzRhMjUzNDRiMzA5MzlhZmI3NmI5N2FmZWMxN2I3NThmYjJkMWJhYzhhNTgxNDQ3OTVhYzM3M2E0MWZiYjA4N2Q0YWQ5Y2E3NTc3MmM0ZjQzYzY1MyIsInNpZ25pbmdLZXkiOnsicHVibGljS2V5IjoiTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFWTJzY1VoTUp6Z29mOWZ0TW03NXFIVDJnK0t1cStVRVMyOWl3RW9KblpOWGllNS8zUmt3NWg1OVpFZ2tUU29yUVRlRzNpd2k2QlEwU0wvYzNjbXZQdEE9PSIsImZvcm1hdCI6IlN1YmplY3RQdWJsaWNLZXlJbmZvIiwiYWxnb3JpdGhtIjoiRVMyNTYifSwic2lnbmluZ0tleUF1dGgiOnsiYWRkcmVzcyI6IjB4NmNmMTY3NmE0N2ViNjA5Njg4ZGQ1YzM2YWM4OGRmMTNhMmFlMDQ0NiIsInNpZ25pbmdLZXlTaWduYXR1cmUiOiIweGM4ZTU1ZmE4ODQzZDMzOTJhMzRiNzMwYTA3MjcyZTVhZTQ0YzhlMTUwNjc5ZGZlMDZjMDIwYzQ3ZTFhMDIzNWI3NjlmYzFiYmQ4NTJmNzAyNDIyYWZiZjk0NTllZjRkOWVlZDRjODMzNWI0ZmIxY2Y1ZDNlZDQzY2IyOGEwODIyMWMiLCJzaWduaW5nS2V5TWVzc2FnZSI6IkkgYXV0aG9yaXplIEF0ZW1SZXZpZXcgZnJvbSB0aGlzIGRldmljZSB1c2luZyBzaWduaW5nIGtleTpcbk1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRVkyc2NVaE1KemdvZjlmdE1tNzVxSFQyZytLdXErVUVTMjlpd0VvSm5aTlhpZTUvM1JrdzVoNTlaRWdrVFNvclFUZUczaXdpNkJRMFNML2MzY212UHRBPT0ifX0BAIoyS3XQ3X_zYHbIdzVPV9sRp9C1h0Lr-VGjuzTM5G1XjgDUK9WYd_drz9IuqlufuV8cSQJZKyIVcfNi7wfkDD0mU8RiNiyZLNedXYsHMV6812n97lX6gBGY9eSIcaL7vRdpepd9GfUVndo82vb20Ygl1p_R9o3zJDM2s6WPgWugCWF_yPf2W216s_Wi2GdnhQTSjLVblJOeWL8okKE_BXH0qfJrgBCn4KtxBi_9pX7KKYiiuooPFE4qgb5sN2iVy8f3dDz418doxdumibpn4bImnhYs_xFmSEEoWDHrtk19BWEhpDmdAp48KqTEkWv9FiFvGjGFWB-vKTRkWPR18nv3BgpCDnl34cZo-nubHnVqd5MqFg6e8grO7ve2ChBqZU1s0i3kPn3cAkOXRFAFT9CDZRGOpcpsgqiX5yVaAjwT2-5H3w0VfAhtt6T_8QM3BYN3PQ2VbAFm8yuuYjxeug0n6zQNdgxQJB0cybbUeZdm24j5mYTkdmryKSGseaoAmwDH81G-h557ZeODvddnH_0PEsWi4oWsgQpLOerW1STnWN0VQTDxXhsYZSpPOsOOZAPS9gdmsRPuayjnMosZ9s3i6lcBnNQ9B8UGuF6lYY3yk1zbwD1Hb0dsmH5DCatSnXD-PJ2ZVgclyJgTVpt-QVBpVN1gv3PNR2A54LbGuuInnPgX7WyVoTnTxFtyMHzK_iyQ9jKTuTNvPZDvpKXyraIujN7xcC4NvJ3aJ8zssULFQNgqiC5cQ2opbFOhg0A7GLIBkXNwSVwD5BBfHHCsiV-mwjjqdujllzy-pR5BCvvV2FZ4PlVAgsxX8hCEQUNVpO5_gISSE_SeLuRWXlhdSRRI4dGFNWm7E75ZJzeOn_C5hZCuQjIdgS_a-O__5v2MqBQlKDUdtw54pXniUkZA4UhPXNgcGwVvdBDsybCJeM__akVDhDWrY6nqGOozHfrIUS1VR_Cdo4LP57DlSkPOwfb81MDBkYjzPu1HYNTLEUCcWiNtw0-YV7j4eDx_a5p6esNiIZInXK3DJGw2a4Na7e9FyRLWzSNPtd54Ys0qjcGYTVwJJvl4e6oE7bMPXKSptAieiO3jhCnDFROl4Wm3NX2a1IE4DZYfk1hRjhi47p9TgbZmBkw8_1y5runeAb4ZmOyO1jiOxQ6mQCBO-AQpooHnacNlQtghy05lRR5kqdJsDEcZZuSpp4nuQJT7fkBjmRObw1lOqnpyDBwrEFKQ_3ct12toPLKN6jfTdYU7naOY0xe9N_DuWrVlzWZDjvkuciLZ25P6VI4I4rrRbJuwVAk5RXBPV4RcXuH-8SZPluilQ6tfygLDEVQeF8ltlrRMxEmjoUN9GKkPjfmyZzselmkAAAgAAAAAAAAAfQEAAAAAAAAP8gUYQ29udGVudC1UeXBlIGFwcGxpY2F0aW9uL2pzb24WQXBwbGljYXRpb24YQ3liZXJDb25uZWN0FENvbnRlbnQtSWSAAWFiZjI4YzQyYjg1ZTA2OTE3NTAzNGE3MmZhNmFkMzQ2NDhjYWJhNTA3ZjY2OGEyOGM1YmEwZGE5YzQzYzc4MjkcQ29udGVudC1EaWdlc3SAAWFiZjI4YzQyYjg1ZTA2OTE3NTAzNGE3MmZhNmFkMzQ2NDhjYWJhNTA3ZjY2OGEyOGM1YmEwZGE5YzQzYzc4MjkcQ29udGVudC1BdXRob3IYMWV3OHZxaDVvcDU4DkNoYWluSWQENTYcQ29udGVudC1UYXJnZXSAATM5ZjAyMTg4MWU3Mzg2ZjhkNzNkNmVmMjU1MzNlNjA5MWYyYTAyNTZlNDIyYjRiM2M0ZTNkMzM1Y2NhZTE0N2UMU291cmNlSDE1NTMxZmEyLTEyMDUtNGY2MS1iNmU0LWM5ZjY4ZWNmODFmNwB7ImNvbnRlbnQiOiJ7XCJvcFwiOlwiY29tbWVudFwiLFwiYWRkcmVzc1wiOlwiMHg0NzY1NjBjYTIzM2Q1NGEwYzdiZDI4ZTIwMmNhNThmZDFiZWYyY2ZhXCIsXCJ0c1wiOjE2OTE0NjA2MjAwNjIsXCJjaGFpbklkXCI6NTYsXCJoYW5kbGVcIjpcIjFldzh2cWg1b3A1OFwiLFwidGFyZ2V0XCI6XCIzOWYwMjE4ODFlNzM4NmY4ZDczZDZlZjI1NTMzZTYwOTFmMmEwMjU2ZTQyMmI0YjNjNGUzZDMzNWNjYWUxNDdlXCIsXCJ0aXRsZVwiOlwiRmxhcHB5TW9vbmJpcmRcIixcImJvZHlcIjpcIlNvIGZ1biB0byBwbGF5IGluIG15IHNwYXJlIHRpbWUuXCJ9IiwiZGlnZXN0IjoiYWJmMjhjNDJiODVlMDY5MTc1MDM0YTcyZmE2YWQzNDY0OGNhYmE1MDdmNjY4YTI4YzViYTBkYTljNDNjNzgyOSIsInNpZ25hdHVyZSI6IjB4YTI4MjIyZTkyY2IzNTQ3YjAyNjUwY2RiZmI3NGYyYjIyZWVkYTRhODY1YTY5MzgwZWNmMDk5MDM4M2FkYWUyNDQyODllNzJhNzA4OTM5MzEwZjdjZDg4YWIwYjhlMzk1NDg1ZDIyZWI3MTFkYjFkOTU1OWRlODBkMzA5MDNjY2QiLCJzaWduaW5nS2V5Ijp7InB1YmxpY0tleSI6Ik1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRWJ3cUkzbExUWHVRMFJBWXB5NUkzeURzUUFETlFKTXMxTXluTVBuVE9SQm9OUVptWkQvQWdwUDRZOXhGUDdHaXVNSzVOUVRiR1ZMdEYrMDVnT2t2L2R3PT0iLCJmb3JtYXQiOiJTdWJqZWN0UHVibGljS2V5SW5mbyIsImFsZ29yaXRobSI6IkVTMjU2In0sInNpZ25pbmdLZXlBdXRoIjp7ImFkZHJlc3MiOiIweDQ3NjU2MGNhMjMzZDU0YTBjN2JkMjhlMjAyY2E1OGZkMWJlZjJjZmEiLCJzaWduaW5nS2V5U2lnbmF0dXJlIjoiMHg1ZDRjYjAyMzIxYjQzN2UwMWZkNTQwZTkwNmNkODFkN2MxMzg0M2M3YTYxYjQ5ODE1MTE2ODEwMDMwOTY4YTk0NWFjZTlmNGU2Njc1OWUzNDI2NWYxNGJlN2QyZWRiZDZhNjM1YTdhMDMzNmVhMjU0MTgxN2JlOTMwNDY0OTRkOTFjIiwic2lnbmluZ0tleU1lc3NhZ2UiOiJJIGF1dGhvcml6ZSBDeWJlckNvbm5lY3QgZnJvbSB0aGlzIGRldmljZSB1c2luZyBzaWduaW5nIGtleTpcbk1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRWJ3cUkzbExUWHVRMFJBWXB5NUkzeURzUUFETlFKTXMxTXluTVBuVE9SQm9OUVptWkQvQWdwUDRZOXhGUDdHaXVNSzVOUVRiR1ZMdEYrMDVnT2t2L2R3PT0ifX0BAAKu4nPohUvcoowMHUi45LioARdvgBiVGQvfxKNYFHxaGqi4CxUkmcGVvsgCNjKHVmaIR4X0695utyvzv0DgeHmwHRHTvutW-i0QKIHmtjSX0jxpbkzzviTrzQDGE5Ps-J_8JchuKMKlcnHlnpXMbwIRWayjiBSu4P60qJ1ceXmB7oFyM-2YdctSzAlojTbabzteRZlMu-A2LBwADFAl2T2KJYt8zwYMaVwgwb3tlJAp9_cDjfT499abpYIdur-D_cKX0fET_HV-10cc4ooqzCK0_VByvj2N-K0_5yS_xj8YigSekVYXzo-nMm1xmH3NIfR-O2NjQsjREkWftMDdsgXiFNokCCIqxItvPeAluLeWZoWobVxzcCP0Gsx93UrfXw4vDeS0C1ygqPwkKwp8GKI4Tf2pv7uo8wyDMLHQvIeGhurCwIYsGGMKI72FNCWvMSuzNiyC-W-ujsHMESqkMQAhF02Ps_5ChVU1hnJLUYFN2uStC51qXaY1WdFHM-bO__DHz61mXeAYA3QKv94tZm3PGWEaB7TcLT8jm9gxqxZG06OCaCTne_qfcR4yyB4ExQxvxYzmw22R7OZBXSdyVSj-qNBsURfUA1PeeSfRrxMJxmoN8cXoShgn_02ApfnP0EqOgSw9iezq2RpRsdA6AOPPVsXKS4LHHYMAfOXkyYR9nPgX7WyVoTnTxFtyMHzK_iyQ9jKTuTNvPZDvpKXyraIujN7xcC4NvJ3aJ8zssULFQNgqiC5cQ2opbFOhg0A7GLIBkXNwSVwD5BBfHHCsiV-mwjjqdujllzy-pR5BCvvV2FZ4PlVAgsxX8hCEQUNVpO5_gISSE_SeLuRWXlhdSRRI4dGFNWm7E75ZJzeOn_C5hZCuQjIdgS_a-O__5v2MqBQlKDUdtw54pXniUkZA4UhPXNgcGwVvdBDsybCJeM__akVDhDWrY6nqGOozHfrIUS1VR_Cdo4LP57DlSkPOwfb81MDBkYjzPu1HYNTLEUCcWiNtw0-YV7j4eDx_a5p6esNiIZInXK3DJGw2a4Na7e9FyRLWzSNPtd54Ys0qjcGYTVwJJvl4e6oE7bMPXKSptAieiO3jhCnDFROl4Wm3NX2a1IE4DZYfk1hRjhi47p9TgbZmBkw8_1y5runeAb4ZmOyO1jiOxQ6mQCBO-AQpooHnacNlQtghy05lRR5kqdJsDEcZZuSpp4nuQJT7fkBjmRObw1lOqnpyDBwrEFKQ_3ct12toPLKN6jfTdYU7naOY0xe9N_DuWrVlzWZDjvkuciLZ25P6VI4I4rrRbJuwVAk5RXBPV4RcXuH-8SZPluilQ6tfygLDEVQeF8ltlrRMxEmjoUN9GKkPjfmyZzselmkAAAcAAAAAAAAADAEAAAAAAAANkAQYQ29udGVudC1UeXBlIGFwcGxpY2F0aW9uL2pzb24WQXBwbGljYXRpb24YQ3liZXJDb25uZWN0DFNvdXJjZQhhdGVtFENvbnRlbnQtSWSAATc0MDJhZDdhMWMyNmE4YjQzMjcxNmNkYTk5ZDNmM2U2Mzk2MDNkODdkNjk1NThlNWQ5NmQwY2I5YTM1ZTdlNDkcQ29udGVudC1EaWdlc3SAATc0MDJhZDdhMWMyNmE4YjQzMjcxNmNkYTk5ZDNmM2U2Mzk2MDNkODdkNjk1NThlNWQ5NmQwY2I5YTM1ZTdlNDkcQ29udGVudC1BdXRob3IYdzBkZ2VjZ2t0a3FoDkNoYWluSWQENTYAeyJjb250ZW50Ijoie1wib3BcIjpcInBvc3RcIixcImFkZHJlc3NcIjpcIjB4ZDM3ODVmY2E0OTc1ZDU3M2M3MjU3YTliMmQ2NTMxOTI5MjhhMjZjYlwiLFwidHNcIjoxNjkxNDYwNjIwNzc1LFwiY2hhaW5JZFwiOjU2LFwiaGFuZGxlXCI6XCJ3MGRnZWNna3RrcWhcIixcInRpdGxlXCI6XCIxMTExMlwiLFwiYm9keVwiOlwiMjIyMjIyMjIyMjIyMjIyMjIyXCJ9IiwiZGlnZXN0IjoiNzQwMmFkN2ExYzI2YThiNDMyNzE2Y2RhOTlkM2YzZTYzOTYwM2Q4N2Q2OTU1OGU1ZDk2ZDBjYjlhMzVlN2U0OSIsInNpZ25hdHVyZSI6IjB4MmJiOGU0NDc5MDY2MWRkYWZkMTdkMWM1ZTNiM2U3MmU1MjgzYTk1OWNlMGVmNDY1MjQ1MmMwMDAzNmZlODU1MDY0MDJmMzMzNzhkNjI5NThhMmQ2OTZiNTI0YjIwMWJiYmUyN2Q2YzlmMWRhMmIzMGM4Zjc2OWZkYjFjYzg5OGIiLCJzaWduaW5nS2V5Ijp7InB1YmxpY0tleSI6Ik1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRXY0L3lYOVRLbEpVSlcwWXJLT2pUUzBrNGNVTEZDZWF0M1l0Y3AzNUl1cW1rb01sV0lzMTUyeVNicFFZZzBZb3lnOGxLdHdOL3U4MU1henZBeG1sM2dRPT0iLCJmb3JtYXQiOiJTdWJqZWN0UHVibGljS2V5SW5mbyIsImFsZ29yaXRobSI6IkVTMjU2In0sInNpZ25pbmdLZXlBdXRoIjp7ImFkZHJlc3MiOiIweGQzNzg1ZmNhNDk3NWQ1NzNjNzI1N2E5YjJkNjUzMTkyOTI4YTI2Y2IiLCJzaWduaW5nS2V5U2lnbmF0dXJlIjoiMHg0MDA4YTM3NzJkZjQ1ZTdjZjI0OWZiNWEyY2E5NjlmMWE1YmM2MDJlNGQxYTM2ZDI2MzZmMGM3OTJjODg0OTU2NzU1MDU1MWJlYmFjMDM2NGI1Y2FiMjBjOWEzNWQ1YmRlMWZhODRjYTViOThlMjBjOWUxNjZjODNmM2RiOWYwZjFiIiwic2lnbmluZ0tleU1lc3NhZ2UiOiJJIGF1dGhvcml6ZSBBdGVtUmV2aWV3IGZyb20gdGhpcyBkZXZpY2UgdXNpbmcgc2lnbmluZyBrZXk6XG5NRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUV2NC95WDlUS2xKVUpXMFlyS09qVFMwazRjVUxGQ2VhdDNZdGNwMzVJdXFta29NbFdJczE1MnlTYnBRWWcwWW95ZzhsS3R3Ti91ODFNYXp2QXhtbDNnUT09In19AQB8DaCbETQYlL4njto1gWedEMabsyaFvm5Iv5LijWq0Of-mG8ULPZzqPAx9yl8cXXbO0wHENgTK1FY1rI_9BxulXHGQPfbzXghzTyV0DGfrukKugNMZhuyoQxmTtIorxnl-DANa09EahkeCpC8J4iUMu6x4neCMhpXHNxNLvACyR95-uQC0Bca5xFRv8KGBbOA2VF_QxZYP1F3AB-7q62DuF1rnv8hQDJJ8e9tN3dW4QDxZHuu8kAP4I4jENe5apGf4qzeB5NRIIzRP4odgq8Gshqszpk1j4g8Vnl-bGCI8-KmyS9B7i88k_nCQg4akq_2nR2YS7Edw5vnAVCatK8nsuIPCeRPGYsLs8jGRQaD_cYZrYYriUEPN69ICZp4rPteD6dTRMXbMF5bzVDNeKHqZhfpGNA-6i6_4VEkAA4b5bC25nKU2yibo9aINbdcoDeNF3dP21jOd7bveknyGITAhxrpXUElAqSj8usVXw3WCGRUV73k8jOCE4EExHPdm50C0LyP8ALhzzNICoE3F0rCY7SAromVoJC2QpmIjV4lKBV69x5qjhmp-e6hheWvfJSUTqTp2Z4Zh9OUntYng3dpiEfh1KNuhWiP6C9zz8dgVh0434oadfGCZdGoKJbVUabGxA-JMdVR71m5vks7GTvykHZrr_Ix5vBbD9slQX4E2dpz4F-1slaE508RbcjB8yv4skPYyk7kzbz2Q76Sl8q2iLoze8XAuDbyd2ifM7LFCxUDYKoguXENqKWxToYNAOxiyAZFzcElcA-QQXxxwrIlfpsI46nbo5Zc8vqUeQQr71dhWeD5VQILMV_IQhEFDVaTuf4CEkhP0ni7kVl5YXUkUSOHRhTVpuxO-WSc3jp_wuYWQrkIyHYEv2vjv_-b9jKgUJSg1HbcOeKV54lJGQOFIT1zYHBsFb3QQ7MmwiXjP_2pFQ4Q1q2Op6hjqMx36yFEtVUfwnaOCz-ew5UpDzsH2_NTAwZGI8z7tR2DUyxFAnFojbcNPmFe4-Hg8f2uaenrDYiGSJ1ytwyRsNmuDWu3vRckS1s0jT7XeeGLNKo3BmE1cCSb5eHuqBO2zD1ykqbQInojt44QpwxUTpeFptzV9mtSBOA2WH5NYUY4YuO6fU4G2ZgZMPP9cua7p3gG-GZjsjtY4jsUOpkAgTvgEKaKB52nDZULYIctOZUUeZKnSbAxHGWbkqaeJ7kCU-35AY5kTm8NZTqp6cgwcKxBSkP93LddraDyyjeo303WFO52jmNMXvTfw7lq1Zc1mQ475LnIi2duT-lSOCOK60WybsFQJOUVwT1eEXF7h_vEmT5bopUOrX8oCwxFUHhfJbZa0TMRJo6FDfRipD435smc7HpZpAAAHAAAAAAAAABQBAAAAAAAADaAEGENvbnRlbnQtVHlwZSBhcHBsaWNhdGlvbi9qc29uFkFwcGxpY2F0aW9uGEN5YmVyQ29ubmVjdBRDb250ZW50LUlkgAFlODRlMDI5NmJjMzYzOWY4YjdjODA2NDI4MDk4OTMwODgzMGU1YjZmYmE2NWIxMzFlYmQ1OGRkM2Y0NmRjN2RkHENvbnRlbnQtRGlnZXN0gAFlODRlMDI5NmJjMzYzOWY4YjdjODA2NDI4MDk4OTMwODgzMGU1YjZmYmE2NWIxMzFlYmQ1OGRkM2Y0NmRjN2RkHENvbnRlbnQtQXV0aG9yHnNzcmxnZWt1YXdybnQ5NQ5DaGFpbklkBDU2DFNvdXJjZRJjeWJlcnR1bmUAeyJjb250ZW50Ijoie1wib3BcIjpcInBvc3RcIixcImFkZHJlc3NcIjpcIjB4MzNkZjFjYTdhZGQ5NWM4OWJiOTNjNTRjMWJiNGNmZDYyNGNmM2ZlZlwiLFwidHNcIjoxNjkxNDYwNjIxODU0LFwiY2hhaW5JZFwiOjU2LFwiaGFuZGxlXCI6XCJzc3JsZ2VrdWF3cm50OTVcIixcInRpdGxlXCI6XCJUaGUgSW1wb3J0YW5jZSBvZiBQaGlsb3NvcGh5XCIsXCJib2R5XCI6XCJEZXNpcmFibGUgSXQgbG9va3MgbGlrZSB5b3UndmUgcHV0IGEgbG90IG9mIHdvcmsgaW50byB0aGlzLlwifSIsImRpZ2VzdCI6ImU4NGUwMjk2YmMzNjM5ZjhiN2M4MDY0MjgwOTg5MzA4ODMwZTViNmZiYTY1YjEzMWViZDU4ZGQzZjQ2ZGM3ZGQiLCJzaWduYXR1cmUiOiIweGZiZmRmM2Y5YmEzODUzNDMxNTdhM2JlYjVjNzNhZmFjMzgwYWIyZmQ1NjcyYTBhOGNiMDUxOTI0NjgyMmVlYWJiZjgzODcxZDIzZjFlYjNiNTNmZDRjZTJhZDNlZjc5YmNlZmE2MGVlOWZhZjM2NmRlZTdiOWIyNTRjOWNkYjNhIiwic2lnbmluZ0tleSI6eyJwdWJsaWNLZXkiOiJNRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUVPNmFVeGlMQjdGME1EWngyb3cwWlZ1MUc1aEpaS1c1aW1JUXJZWitrUlBaZU5YUWpZNVowaTJrK1FVTGp1Q3l6bFArZHAwZytvTitCaU0vamtCSWxLdz09IiwiZm9ybWF0IjoiU3ViamVjdFB1YmxpY0tleUluZm8iLCJhbGdvcml0aG0iOiJFUzI1NiJ9LCJzaWduaW5nS2V5QXV0aCI6eyJhZGRyZXNzIjoiMHgzM2RmMWNhN2FkZDk1Yzg5YmI5M2M1NGMxYmI0Y2ZkNjI0Y2YzZmVmIiwic2lnbmluZ0tleVNpZ25hdHVyZSI6IjB4MGJhZmQ4NTczOTJiMTBlZDhjOWQxMzY2MzFmMWVhMjE1NTA0MjE1NGVkYWViY2MzOWFjNjZjNjhmZTY3MDgxYzU5N2M1ZDEwYTYwMWU2Y2Y1NWFkNmVhZDM5YWViZGI3ODliYzg2NGEyMGFlMGQzOGQ4OWQ0MDhkMGUyZDYwYjgxYyIsInNpZ25pbmdLZXlNZXNzYWdlIjoiSSBhdXRob3JpemUgSSBhdXRob3JpemUgQ3liZXJUdW5lLnh5eiBmcm9tIHRoaXMgZGV2aWNlIHVzaW5nIHNpZ25pbmcga2V5OlxuTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFTzZhVXhpTEI3RjBNRFp4Mm93MFpWdTFHNWhKWktXNWltSVFyWVora1JQWmVOWFFqWTVaMGkyaytRVUxqdUN5emxQK2RwMGcrb04rQmlNL2prQklsS3c9PSJ9fQEAY3XRz37xo66Wxb-PbuVK_IohtrxvPd1pTx1FCqKYT4h0peZk6Nrm4VCPjAsw5ahY7S0ffGflnDo4CX6ZxTL-CvClHwFpLmcFjnOF18YaANv2xOIS6FPJph745ck4RjxO2pSyTCKQEKsAJhueSOWo-anFPoFNDuOBYhrgWEeJRsRmpV3XbeWLnLT7En44e42jyf9eG1tJ_zNTrBlyk67dLgkaCvzA0sab6Q2WjI4GOuHBT8kMACEfisFK_qp18YA02IG9SKFr47vCA0kbF_IhgYJxRcnIR7t1cJz0ybJZ7aXwvWsKuBaG-hM0pCIIRy7nyY7RxxITyeE8M8uh3nPXoej2-M3iXSJAh3OMUYEdjgCn_zJQhqzNcS2MdWeOkehqPrmDJJddssm5aUUE1WqkX5U1WNajNXkAmiDjQHy0TMr6Tcv2TRzm9Kj8nn89tdMYdOM8QCwi71jTMMnSeuT-C40Z_fEkZ8tDdLTAMf-Aq6aCNrlSQ6PCDH5ekw5an7HPrHen_bLUBi22VydQeaGDGTM0-0CTxRWa4FpWhO9frB6iSk2mLOdRCVm0wUijTlH_mK5HQsJZhoMG9Q72vRAN_FpKBkZfQuvjmU9v7BCoHpe7KcNHdS_sk_DLT03O_qqMZxFz0HB1iW0kXt8IXpCBdkzxh3UNYLC-rNPMjpwZIyWc-BftbJWhOdPEW3IwfMr-LJD2MpO5M289kO-kpfKtoi6M3vFwLg28ndonzOyxQsVA2CqILlxDailsU6GDQDsYsgGRc3BJXAPkEF8ccKyJX6bCOOp26OWXPL6lHkEK-9XYVng-VUCCzFfyEIRBQ1Wk7n-AhJIT9J4u5FZeWF1JFEjh0YU1absTvlknN46f8LmFkK5CMh2BL9r47__m_YyoFCUoNR23DnileeJSRkDhSE9c2BwbBW90EOzJsIl4z_9qRUOENatjqeoY6jMd-shRLVVH8J2jgs_nsOVKQ87B9vzUwMGRiPM-7Udg1MsRQJxaI23DT5hXuPh4PH9rmnp6w2IhkidcrcMkbDZrg1rt70XJEtbNI0-13nhizSqNwZhNXAkm-Xh7qgTtsw9cpKm0CJ6I7eOEKcMVE6Xhabc1fZrUgTgNlh-TWFGOGLjun1OBtmYGTDz_XLmu6d4BvhmY7I7WOI7FDqZAIE74BCmigedpw2VC2CHLTmVFHmSp0mwMRxlm5Kmnie5AlPt-QGOZE5vDWU6qenIMHCsQUpD_dy3Xa2g8so3qN9N1hTudo5jTF7038O5atWXNZkOO-S5yItnbk_pUjgjiutFsm7BUCTlFcE9XhFxe4f7xJk-W6KVDq1_KAsMRVB4XyW2WtEzESaOhQ30YqQ-N-bJnOx6WaQAABwAAAAAAAAAMAQAAAAAAAA2QBBhDb250ZW50LVR5cGUgYXBwbGljYXRpb24vanNvbhZBcHBsaWNhdGlvbhhDeWJlckNvbm5lY3QOQ2hhaW5JZAQ1NgxTb3VyY2UIYXRlbRRDb250ZW50LUlkgAE1ZTI3YzAwNTdlMjljODlmYzI3YWZlOGRiZDZmYTdjYWY4NTU4ODIxM2QzMGYwZDUwZTEzNTc2ODM5Yjk3NzAzHENvbnRlbnQtRGlnZXN0gAE1ZTI3YzAwNTdlMjljODlmYzI3YWZlOGRiZDZmYTdjYWY4NTU4ODIxM2QzMGYwZDUwZTEzNTc2ODM5Yjk3NzAzHENvbnRlbnQtQXV0aG9yGG1hd212czFyaXdscQB7ImNvbnRlbnQiOiJ7XCJvcFwiOlwicG9zdFwiLFwiYWRkcmVzc1wiOlwiMHg2MTMwODEyMjVhMTRiNDhmMzFhZmZiMzczYWEwNGEwZWQ5OWMwMTQ3XCIsXCJ0c1wiOjE2OTE0NjA2MjE2NzUsXCJjaGFpbklkXCI6NTYsXCJoYW5kbGVcIjpcIm1hd212czFyaXdscVwiLFwidGl0bGVcIjpcIjExMTEyXCIsXCJib2R5XCI6XCIyMjIyMjIyMjIyMjIyMjIyMjJcIn0iLCJkaWdlc3QiOiI1ZTI3YzAwNTdlMjljODlmYzI3YWZlOGRiZDZmYTdjYWY4NTU4ODIxM2QzMGYwZDUwZTEzNTc2ODM5Yjk3NzAzIiwic2lnbmF0dXJlIjoiMHhiMGQ4YTgwMDY3ODM4MTViYzM5N2ViMzJlZDdiZjQxYWJhNDIwNTE1ZmMxZjRjYTUxMzU4ZmI2NjlhZGYyZTEwZTY0ZmZlZDBkMmUzNTViN2UyYTRkODgyZGYzYzc4ODQ2MDlhYTVmYWQwMzU0NWU4YWJhOWVmYWQ2Nzg1ZDBkOSIsInNpZ25pbmdLZXkiOnsicHVibGljS2V5IjoiTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFZFNaOHNvdmRuQWcvWmJkeVkySlZEK1IwYXg0OXdZSWc3Rk5mZ2FaNElRdlR4b01QT0lEWjVpRG1LTVd2TjFiazQyU3k5Sm53d0VUUTBGYjJqQyt3V2c9PSIsImZvcm1hdCI6IlN1YmplY3RQdWJsaWNLZXlJbmZvIiwiYWxnb3JpdGhtIjoiRVMyNTYifSwic2lnbmluZ0tleUF1dGgiOnsiYWRkcmVzcyI6IjB4NjEzMDgxMjI1YTE0YjQ4ZjMxYWZmYjM3M2FhMDRhMGVkOTljMDE0NyIsInNpZ25pbmdLZXlTaWduYXR1cmUiOiIweDUxNDkwMTFlYzcyMTRlNzYzZWE3Njg2ZmNjMWZiZjgyZjkyN2Q5MGNiNzU0MzgwMWRlZjNiOGZlNDk2NjY5NGUxYzM2OGQxOTI1YWZlYzZiZTAxMTI2YTM3YmIzNTRjYzA2MzM2ZDFiNzZjN2M4MWZiYmE3YTFkYzQ2YTVlMjQ2MWMiLCJzaWduaW5nS2V5TWVzc2FnZSI6IkkgYXV0aG9yaXplIEF0ZW1SZXZpZXcgZnJvbSB0aGlzIGRldmljZSB1c2luZyBzaWduaW5nIGtleTpcbk1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRWRTWjhzb3ZkbkFnL1piZHlZMkpWRCtSMGF4NDl3WUlnN0ZOZmdhWjRJUXZUeG9NUE9JRFo1aURtS01Xdk4xYms0MlN5OUpud3dFVFEwRmIyakMrd1dnPT0ifX0BAD82HT2KAijAa1SfS8oPyOhKNYoW_tE5nHWu4jn_6PvCDfq3P21k5ol34rA3b7sYDy35r1Z8jhzmYJiZiMMKtjr9hXwZAIc0miD7Kq92xXmGCsi7sdmkYiWANyeKE81wjicaeH0BPVh6nDaKZg_Kz7Z7dO-sTjMLu2o3BETxIN7G_mY1AqVu8WbQJAWMI1Xl4jLofUtnD9RcYQc4v1oBqD00r6fiIeYRjdopY6ayG0GCruccywkkmr7xh5wf-ofKHwMliP2R7FveohG63QdkENwBvzCEMocx6R5Hinu2G_d01Gw49ZjY9_nKnC2dFveW8ugaTqlwoTNg6mNXlYHamOXlyDVa8TJ6RCEkpRME8RFJWam4S215VPym-g4Yfe8nDWTvfLI2CNqv4aPKj6r23seWdQCfVU7_owBX1SutzT17ZdTG5SiinJwdga6TQ27ZX6fOcG8bdgUmPMoetxtOtUcFn4JDzYGPLcYUt8A_H4XblnpMaAS-5ULmrxNFs1MdbNL3snZsluk92JyD44dvqbMl-_NexgjHkwfN4uOKcuYWlMR5HAe4R_UK3wVBpT6G8JgZdyl50JKPQtcrJp8zPW4VXtrd-zJSBpdd9z3WkY1bAfypxTbe8Q0ydyA9WuoYBL0bR4Xwbwa_jYXixdLABfHAkNsmQHF4vnbbnHx7lVyPnPgX7WyVoTnTxFtyMHzK_iyQ9jKTuTNvPZDvpKXyraIujN7xcC4NvJ3aJ8zssULFQNgqiC5cQ2opbFOhg0A7GLIBkXNwSVwD5BBfHHCsiV-mwjjqdujllzy-pR5BCvvV2FZ4PlVAgsxX8hCEQUNVpO5_gISSE_SeLuRWXlhdSRRI4dGFNWm7E75ZJzeOn_C5hZCuQjIdgS_a-O__5v2MqBQlKDUdtw54pXniUkZA4UhPXNgcGwVvdBDsybCJeM__akVDhDWrY6nqGOozHfrIUS1VR_Cdo4LP57DlSkPOwfb81MDBkYjzPu1HYNTLEUCcWiNtw0-YV7j4eDx_a5p6esNiIZInXK3DJGw2a4Na7e9FyRLWzSNPtd54Ys0qjcGYTVwJJvl4e6oE7bMPXKSptAieiO3jhCnDFROl4Wm3NX2a1IE4DZYfk1hRjhi47p9TgbZmBkw8_1y5runeAb4ZmOyO1jiOxQ6mQCBO-AQpooHnacNlQtghy05lRR5kqdJsDEcZZuSpp4nuQJT7fkBjmRObw1lOqnpyDBwrEFKQ_3ct12toPLKN6jfTdYU7naOY0xe9N_DuWrVlzWZDjvkuciLZ25P6VI4I4rrRbJuwVAk5RXBPV4RcXuH-8SZPluilQ6tfygLDEVQeF8ltlrRMxEmjoUN9GKkPjfmyZzselmkAAAcAAAAAAAAAGAEAAAAAAAANqAQYQ29udGVudC1UeXBlIGFwcGxpY2F0aW9uL2pzb24WQXBwbGljYXRpb24YQ3liZXJDb25uZWN0HENvbnRlbnQtQXV0aG9yJnF1aWRlbXhvZG9sb3JfY3liZXIOQ2hhaW5JZAQ1NgxTb3VyY2USY3liZXJ0dW5lFENvbnRlbnQtSWSAAWE2N2E5MmQ4YTA1ZGJkZTcwMWU3NjlkMDc1MGI3OWY5OGIyNjkxYjBhMjc0ZDlmOGM4NTQyNWJjYjA2ZTEzMWYcQ29udGVudC1EaWdlc3SAAWE2N2E5MmQ4YTA1ZGJkZTcwMWU3NjlkMDc1MGI3OWY5OGIyNjkxYjBhMjc0ZDlmOGM4NTQyNWJjYjA2ZTEzMWYAeyJjb250ZW50Ijoie1wib3BcIjpcInBvc3RcIixcImFkZHJlc3NcIjpcIjB4NjVlY2VmMWM2ZDEzM2E1YjUwOTAxYjZlMDgyMTZiNjlhNWM4YTFlMVwiLFwidHNcIjoxNjkxNDYwNjIxMDc4LFwiY2hhaW5JZFwiOjU2LFwiaGFuZGxlXCI6XCJxdWlkZW14b2RvbG9yX2N5YmVyXCIsXCJ0aXRsZVwiOlwiVGhlIFNlY3JldHMgb2YgdGhlIE1lcm1haWQncyBMYWdvb25cIixcImJvZHlcIjpcIlRoYXQncyBjb21pbmcgYWxvbmcgbmljZWx5LiBZb3UgcmVhbGx5IHNjb3JlZCBoZXJlLlwifSIsImRpZ2VzdCI6ImE2N2E5MmQ4YTA1ZGJkZTcwMWU3NjlkMDc1MGI3OWY5OGIyNjkxYjBhMjc0ZDlmOGM4NTQyNWJjYjA2ZTEzMWYiLCJzaWduYXR1cmUiOiIweDM2YmQ5YWNjNjY3ZTQ5NDhkY2FiZWNlNGEzNDUzMTc0N2YzZjNhZDM1Y2Q0MzU4NGVmY2M5NDJiMDcxODdhYjIyYjc4YjM3ZTliZTk3YjQ3NzkxMzUyOTRiYmI0MmFmYjIzOWRmYTUzMWYxNjgxZDQyODM4ZWI4ODYyNTE0MmYyIiwic2lnbmluZ0tleSI6eyJwdWJsaWNLZXkiOiJNRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUVja0hRUm5vZ2p3L3VhbjM4eDBRQTNDdk1vMXM0aSt5ZTJjNHpPR1BNSDQxSTUwWVZMREZkblo0TUxOVURGZjVSSThLVllGK3czbGVBVFZpdldWLzlpZz09IiwiZm9ybWF0IjoiU3ViamVjdFB1YmxpY0tleUluZm8iLCJhbGdvcml0aG0iOiJFUzI1NiJ9LCJzaWduaW5nS2V5QXV0aCI6eyJhZGRyZXNzIjoiMHg2NWVjZWYxYzZkMTMzYTViNTA5MDFiNmUwODIxNmI2OWE1YzhhMWUxIiwic2lnbmluZ0tleVNpZ25hdHVyZSI6IjB4OTI3NDY3MzVmNTI0YjBhZTZjOTY2MWZhYjVjMDI1MWQ1NzA1Zjg2NWNkYTY4YmJiZGQ3OTI3ZTE4NmQ0NTkxYzU3ZGEzM2MzNjM0MWMzYzM2NTM4N2Y0M2EwZjNiM2FmMzkyM2QwY2E3NTNlYzg2NjZkNjIyZjRhNzUwOGMyOTQxYiIsInNpZ25pbmdLZXlNZXNzYWdlIjoiSSBhdXRob3JpemUgSSBhdXRob3JpemUgQ3liZXJUdW5lLnh5eiBmcm9tIHRoaXMgZGV2aWNlIHVzaW5nIHNpZ25pbmcga2V5OlxuTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFY2tIUVJub2dqdy91YW4zOHgwUUEzQ3ZNbzFzNGkreWUyYzR6T0dQTUg0MUk1MFlWTERGZG5aNE1MTlVERmY1Ukk4S1ZZRit3M2xlQVRWaXZXVi85aWc9PSJ9fQEAYspOfE7CcqKHz_UTVqmBeAtZqYuri0oTJsd6kD7Zo7cFvSYD_Q8CfFZnPF9evtirvvW3zU-RFsOG6ZAVEm7tJYvWSjKoI-0PuE8aR_qx892ZZUkuPPFcU9MND8PYbSuhneS6NiyRQpvlbZr879JRurJ1wvY6dU4lqjqOx-4n9OtLxmqiDAEwrZF3xhfvj65VEZThWvMuS6wwTAo8TCROkBacW6usK9n889hgkUVuZWCM-Hu3kuK0kbOC1CMwMTfTtYkV6lg2nHjU4P8ALYs39sHAtzMYO1B3ixgBR7jAOGYX4ZnM9z6bqUyyLWpGxnykPRSiLtqKFu20miu_RC3voqWrZGgPg8-5eUISJH-PPqkwecHHvsr0aqGQsAFkxp1e7NpvUSnfJa23m2EyTE6OzOnF2Q9abXGVP4H7EBBYzCWXm8bdox0rYIzEClAzzDryBvA4paVQgvjGhUgJRue6KYNBC8p-R8ZHfMiem015V_HUpDlHadRe4PJjXvPlejzx9pzbBcgFPX7OssQ3bDqSViIfK8z81q8fDUIFqKxtwD9bshg-9YGnT1BxPjmBSAsS2CgDGRP7YbhHZkFUSaPBN57buli7x4eL85wSLkQKnvBrwm7gueYrMzsQLCaBl05eLwlLxpE-eMslsaaSfqUWzjzdEXTxYMx1yUs3q_ybAuGc-BftbJWhOdPEW3IwfMr-LJD2MpO5M289kO-kpfKtoi6M3vFwLg28ndonzOyxQsVA2CqILlxDailsU6GDQDsYsgGRc3BJXAPkEF8ccKyJX6bCOOp26OWXPL6lHkEK-9XYVng-VUCCzFfyEIRBQ1Wk7n-AhJIT9J4u5FZeWF1JFEjh0YU1absTvlknN46f8LmFkK5CMh2BL9r47__m_YyoFCUoNR23DnileeJSRkDhSE9c2BwbBW90EOzJsIl4z_9qRUOENatjqeoY6jMd-shRLVVH8J2jgs_nsOVKQ87B9vzUwMGRiPM-7Udg1MsRQJxaI23DT5hXuPh4PH9rmnp6w2IhkidcrcMkbDZrg1rt70XJEtbNI0-13nhizSqNwZhNXAkm-Xh7qgTtsw9cpKm0CJ6I7eOEKcMVE6Xhabc1fZrUgTgNlh-TWFGOGLjun1OBtmYGTDz_XLmu6d4BvhmY7I7WOI7FDqZAIE74BCmigedpw2VC2CHLTmVFHmSp0mwMRxlm5Kmnie5AlPt-QGOZE5vDWU6qenIMHCsQUpD_dy3Xa2g8so3qN9N1hTudo5jTF7038O5atWXNZkOO-S5yItnbk_pUjgjiutFsm7BUCTlFcE9XhFxe4f7xJk-W6KVDq1_KAsMRVB4XyW2WtEzESaOhQ30YqQ-N-bJnOx6WaQAABwAAAAAAAAANAQAAAAAAAA2SBBhDb250ZW50LVR5cGUgYXBwbGljYXRpb24vanNvbhZBcHBsaWNhdGlvbhhDeWJlckNvbm5lY3QMU291cmNlCGF0ZW0UQ29udGVudC1JZIABMWU5OTFlMzI5YWMxMmZkMTk3YTJhOThjNzU0MzI5M2UzMmQ5NGYxY2YyMzhhMzJjMzI5ZmI4MzZjZDdmZjJiZhxDb250ZW50LURpZ2VzdIABMWU5OTFlMzI5YWMxMmZkMTk3YTJhOThjNzU0MzI5M2UzMmQ5NGYxY2YyMzhhMzJjMzI5ZmI4MzZjZDdmZjJiZhxDb250ZW50LUF1dGhvchowMDY2MTA1NTk2NzMxDkNoYWluSWQENTYAeyJjb250ZW50Ijoie1wib3BcIjpcInBvc3RcIixcImFkZHJlc3NcIjpcIjB4MGYwMTIzMGYwNjVkYjljMzQ4ZDNmZTZjNThlODZkNGRlMjk1MDhlZlwiLFwidHNcIjoxNjkxNDYwNjIxOTg2LFwiY2hhaW5JZFwiOjU2LFwiaGFuZGxlXCI6XCIwMDY2MTA1NTk2NzMxXCIsXCJ0aXRsZVwiOlwiMTExMTJcIixcImJvZHlcIjpcIjIyMjIyMjIyMjIyMjIyMjIyMlwifSIsImRpZ2VzdCI6IjFlOTkxZTMyOWFjMTJmZDE5N2EyYTk4Yzc1NDMyOTNlMzJkOTRmMWNmMjM4YTMyYzMyOWZiODM2Y2Q3ZmYyYmYiLCJzaWduYXR1cmUiOiIweDc3YmJlNTc1OGZiYmU3N2E1NmUyYjIxYzdmMzRlMDUzZjZiYzBjNjk1ZDkxMmExMjU0OTI0MjNjNzdlMmM4OGE4NjA0NWY3MmMzM2YzNDMxZTFhMTIyMTBjOGU2ZDc5MDE0YjcwYzYxZTA5NDY3YTg3MDFiNjg5ZTdkNGQ5MWM4Iiwic2lnbmluZ0tleSI6eyJwdWJsaWNLZXkiOiJNRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUVnMGtPSjRIYW5OdENzZlhLOUFQVUdLUFhrdmg2NzJZMVhvb0krcEVRSDB2RXJLVTNrYlphcSt1bWc4bFJyZWVrNWo1bUg5ZkZKWkFmT3FLRk94c1Y2dz09IiwiZm9ybWF0IjoiU3ViamVjdFB1YmxpY0tleUluZm8iLCJhbGdvcml0aG0iOiJFUzI1NiJ9LCJzaWduaW5nS2V5QXV0aCI6eyJhZGRyZXNzIjoiMHgwZjAxMjMwZjA2NWRiOWMzNDhkM2ZlNmM1OGU4NmQ0ZGUyOTUwOGVmIiwic2lnbmluZ0tleVNpZ25hdHVyZSI6IjB4OWIxYWQ2Y2Q4OTEwYjBkZTZhOTkyZjMzYzE1ZGI3YjBkOTA5OTYwOWI1ODE5MzU4NWU0NzhjZWExZjYyYzQzMTYzYTg3Y2UwMTM3NTcyN2I5YzEyZmUwZGY4Mjg1Yzk0OTY4MGJjZTRmYmIyYjU1MWE0YzVmMDJjOTBiZjFkMTYxYiIsInNpZ25pbmdLZXlNZXNzYWdlIjoiSSBhdXRob3JpemUgQXRlbVJldmlldyBmcm9tIHRoaXMgZGV2aWNlIHVzaW5nIHNpZ25pbmcga2V5OlxuTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFZzBrT0o0SGFuTnRDc2ZYSzlBUFVHS1BYa3ZoNjcyWTFYb29JK3BFUUgwdkVyS1Uza2JaYXErdW1nOGxScmVlazVqNW1IOWZGSlpBZk9xS0ZPeHNWNnc9PSJ9fQEAG9S9LRUuqzj37mmPTFH4_qvQxFWlsBkFwcvL4VTHwMCEzItEsR4BPVioxzam5z0un7rB_5RwS-Lzk_DHyqVF2WsEIRhhcGrV2TPFjOuFwEN71NP20cwXlwonZPmRUt6jhrqjZ3LiBGpZO-uUW-ZIo2foYIcdyaysiqTNm7jn08tPwWo1rkh7u4Lt3BmfMU-D7uLHW888akT-gXrx3l2Gj8M9HPmdhK8Nk164HBhl7CaiAqXxPK0b6KVCFT6kgBckDOl-WnOD3siP7GLYke5mZorowoooElbcq_e6vUIkrSYRexFylRpTqrRMWI4Si9mpZrF_6q3KxmTUY02bLZ0waP5OcYXomryv162FBkx_PDaNObtoNxZb065mroIfiSwTlYivbfLz1CW_4GX-c2EQ1VVSkOU7gVFlzr1dr1L2b7mnQNvfXx30FOzfcp_xNK99I4WI8MCSjc3D5sXEAjiwnTvJgyy39N2vPdnEiLpV_TTg4Z_9NRhSRxDsNYVK4fOXr3Z9-evTVsRzzheN5oct0I9nl_osEMy-kSujlVd5_x473KrhP80kw2Mjmd77gyggBhH8Rvu6BC9NjQz8mkxFKmITStblugQ8gTGZQwaeOzJV1QA3Pi-wcN24aXYBfxCoDmtzhImKiY2KlI-c2pNQh62sU74o7stOE_21Cl8KR36c-BftbJWhOdPEW3IwfMr-LJD2MpO5M289kO-kpfKtoi6M3vFwLg28ndonzOyxQsVA2CqILlxDailsU6GDQDsYsgGRc3BJXAPkEF8ccKyJX6bCOOp26OWXPL6lHkEK-9XYVng-VUCCzFfyEIRBQ1Wk7n-AhJIT9J4u5FZeWF1JFEjh0YU1absTvlknN46f8LmFkK5CMh2BL9r47__m_YyoFCUoNR23DnileeJSRkDhSE9c2BwbBW90EOzJsIl4z_9qRUOENatjqeoY6jMd-shRLVVH8J2jgs_nsOVKQ87B9vzUwMGRiPM-7Udg1MsRQJxaI23DT5hXuPh4PH9rmnp6w2IhkidcrcMkbDZrg1rt70XJEtbNI0-13nhizSqNwZhNXAkm-Xh7qgTtsw9cpKm0CJ6I7eOEKcMVE6Xhabc1fZrUgTgNlh-TWFGOGLjun1OBtmYGTDz_XLmu6d4BvhmY7I7WOI7FDqZAIE74BCmigedpw2VC2CHLTmVFHmSp0mwMRxlm5Kmnie5AlPt-QGOZE5vDWU6qenIMHCsQUpD_dy3Xa2g8so3qN9N1hTudo5jTF7038O5atWXNZkOO-S5yItnbk_pUjgjiutFsm7BUCTlFcE9XhFxe4f7xJk-W6KVDq1_KAsMRVB4XyW2WtEzESaOhQ30YqQ-N-bJnOx6WaQAABwAAAAAAAAAMAQAAAAAAAA2QBBhDb250ZW50LVR5cGUgYXBwbGljYXRpb24vanNvbhZBcHBsaWNhdGlvbhhDeWJlckNvbm5lY3QcQ29udGVudC1EaWdlc3SAATg2ZWZkZWMxNWMzNDQzZTQ5MTQyMGQ1YzE0ZjkxYWQ2ZGE1NTE0ZWYzOGNiYjMyMDgxOTJhMDViOGZiMmJiMzccQ29udGVudC1BdXRob3IYZjQwMTE2NTMxMjJ5DkNoYWluSWQENTYMU291cmNlCGF0ZW0UQ29udGVudC1JZIABODZlZmRlYzE1YzM0NDNlNDkxNDIwZDVjMTRmOTFhZDZkYTU1MTRlZjM4Y2JiMzIwODE5MmEwNWI4ZmIyYmIzNwB7ImNvbnRlbnQiOiJ7XCJvcFwiOlwicG9zdFwiLFwiYWRkcmVzc1wiOlwiMHg2ZGIyMjY1ZWNiYjRmNDYxNDNiNmEyNjZiNWUxNDZkMWUyOGM4MjAyXCIsXCJ0c1wiOjE2OTE0NjA2MjIxMDcsXCJjaGFpbklkXCI6NTYsXCJoYW5kbGVcIjpcImY0MDExNjUzMTIyeVwiLFwidGl0bGVcIjpcIjExMTEyXCIsXCJib2R5XCI6XCIyMjIyMjIyMjIyMjIyMjIyMjJcIn0iLCJkaWdlc3QiOiI4NmVmZGVjMTVjMzQ0M2U0OTE0MjBkNWMxNGY5MWFkNmRhNTUxNGVmMzhjYmIzMjA4MTkyYTA1YjhmYjJiYjM3Iiwic2lnbmF0dXJlIjoiMHhmYWY4OGRiODM0MTBhNjk0YzkyZjQ4NGFjMjgwMmJkMjA5MzQ0NjRjYzUyMmQxMmFhNDZkMDI1MmYxMjhiYjI0NzExOGJhNjg3ODk2ODY3NDhjMzFhODZkZDg3MDBjY2RlMDJhZDE4OTRhOTM5NjMxYTE1NzkwM2VmOGY4Y2JjMSIsInNpZ25pbmdLZXkiOnsicHVibGljS2V5IjoiTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFSkU2dXlXYUZuZE5KK3FGZmhFVHBxMGNuWUZYTmJPaW01SlB1dGFsY3RLc2RJWEpmRk9QVFdPckF6NlU1ajNVbFdkQytucm9Ed1FTdFRkMWw5dC9OeGc9PSIsImZvcm1hdCI6IlN1YmplY3RQdWJsaWNLZXlJbmZvIiwiYWxnb3JpdGhtIjoiRVMyNTYifSwic2lnbmluZ0tleUF1dGgiOnsiYWRkcmVzcyI6IjB4NmRiMjI2NWVjYmI0ZjQ2MTQzYjZhMjY2YjVlMTQ2ZDFlMjhjODIwMiIsInNpZ25pbmdLZXlTaWduYXR1cmUiOiIweDM3NTdiNjkwNjRkM2M0YWQ1MjZhNzc5YjQ5YTI5OTMwYjRmNDljN2E0MWI3YWI0ZTA3NzU2M2FmNTU5NGI3NDI3YTRmMDEwYjNmMjc2NjNhYWIyNTFlNTc4YjE4MTE3YzIzNzI5YjljODU5Mjc2ZjBiMDU2NzcwNDZkOTM4NTFlMWIiLCJzaWduaW5nS2V5TWVzc2FnZSI6IkkgYXV0aG9yaXplIEF0ZW1SZXZpZXcgZnJvbSB0aGlzIGRldmljZSB1c2luZyBzaWduaW5nIGtleTpcbk1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRUpFNnV5V2FGbmROSitxRmZoRVRwcTBjbllGWE5iT2ltNUpQdXRhbGN0S3NkSVhKZkZPUFRXT3JBejZVNWozVWxXZEMrbnJvRHdRU3RUZDFsOXQvTnhnPT0ifX0BADGpbIdM_2-30REI_Xk9lvYn7ACiaFkgX-nqBv67y_P3n_rhuIpNJztlgdtGCL3QMwoo4kFtWhbTqrKYQVePLItt99PznP32z7DwIdDt_fcpT9VxDjB_Eh3VXZrjyKgEA7nA8901NEI0P-_SWbZIX9s5plxyp-CYGzMiU3D84NGnSo19xZGqZfCVUN63y_VSFrx9tGfgUyaWibT-ywCb67CYxiHdY2b5wjBxt9kbCui_A8Qe_mbrfi_ioy5G7fARNVuHWRWGlL1hrJHgognuuq5kzCBF-N_KR50WMEM7aZIV4MXbESlmucYOz8rGS2OefU_N2ihPhBx05OrVWVqVorIeiL_a3B4dFr_KW5A1jew6Z2c6Wa4tGgYK4B3DixbwG2LfHaMNYxBbP0pF_J39yRkzBQNMYcwYmicWpCZ1mLq0NbCYk2yCZqj-UBLSPTELs5PZthAXClZSuM2YpjOCJzwQf51SKUm4Y0ziYfBmKbXZ7SdtQAMIhtCY3nnoQAxq0VybAGJOu7lIYEUYgE0niiw7pM3xv_YTMOFmOIiEMq2921o6hBvzf1Z_gcdFSlAUXIkusOUCyVEIQ2M1ezPeHCij3DFfWOV6wDdDkQJD4CHyhNNNRC4mr-5N3Dce-zjF5SIozklsVo0p_pbZxlO59vMY5WmMKecCHmeTvF-yW0TtnPgX7WyVoTnTxFtyMHzK_iyQ9jKTuTNvPZDvpKXyraIujN7xcC4NvJ3aJ8zssULFQNgqiC5cQ2opbFOhg0A7GLIBkXNwSVwD5BBfHHCsiV-mwjjqdujllzy-pR5BCvvV2FZ4PlVAgsxX8hCEQUNVpO5_gISSE_SeLuRWXlhdSRRI4dGFNWm7E75ZJzeOn_C5hZCuQjIdgS_a-O__5v2MqBQlKDUdtw54pXniUkZA4UhPXNgcGwVvdBDsybCJeM__akVDhDWrY6nqGOozHfrIUS1VR_Cdo4LP57DlSkPOwfb81MDBkYjzPu1HYNTLEUCcWiNtw0-YV7j4eDx_a5p6esNiIZInXK3DJGw2a4Na7e9FyRLWzSNPtd54Ys0qjcGYTVwJJvl4e6oE7bMPXKSptAieiO3jhCnDFROl4Wm3NX2a1IE4DZYfk1hRjhi47p9TgbZmBkw8_1y5runeAb4ZmOyO1jiOxQ6mQCBO-AQpooHnacNlQtghy05lRR5kqdJsDEcZZuSpp4nuQJT7fkBjmRObw1lOqnpyDBwrEFKQ_3ct12toPLKN6jfTdYU7naOY0xe9N_DuWrVlzWZDjvkuciLZ25P6VI4I4rrRbJuwVAk5RXBPV4RcXuH-8SZPluilQ6tfygLDEVQeF8ltlrRMxEmjoUN9GKkPjfmyZzselmkAAAcAAAAAAAAADAEAAAAAAAANkAQYQ29udGVudC1UeXBlIGFwcGxpY2F0aW9uL2pzb24WQXBwbGljYXRpb24YQ3liZXJDb25uZWN0HENvbnRlbnQtQXV0aG9yGGRuNjNhN2RhN28zYg5DaGFpbklkBDU2DFNvdXJjZQhhdGVtFENvbnRlbnQtSWSAAWZhMGMzMGMwMDdlNGMzNzY3ZjI1M2Q4MDM3NWIzYjVkMWEwZTE0N2JkZDJmMTc4ZmQxNWRjYWE1ZmJjODVlMGEcQ29udGVudC1EaWdlc3SAAWZhMGMzMGMwMDdlNGMzNzY3ZjI1M2Q4MDM3NWIzYjVkMWEwZTE0N2JkZDJmMTc4ZmQxNWRjYWE1ZmJjODVlMGEAeyJjb250ZW50Ijoie1wib3BcIjpcInBvc3RcIixcImFkZHJlc3NcIjpcIjB4ZDVkOTExNzZkYjFiMjIyOThhMzM0YjljMzMyZmJhMmYzYzNkZjAyYlwiLFwidHNcIjoxNjkxNDYwNjIxMjg5LFwiY2hhaW5JZFwiOjU2LFwiaGFuZGxlXCI6XCJkbjYzYTdkYTdvM2JcIixcInRpdGxlXCI6XCIxMTExMlwiLFwiYm9keVwiOlwiMjIyMjIyMjIyMjIyMjIyMjIyXCJ9IiwiZGlnZXN0IjoiZmEwYzMwYzAwN2U0YzM3NjdmMjUzZDgwMzc1YjNiNWQxYTBlMTQ3YmRkMmYxNzhmZDE1ZGNhYTVmYmM4NWUwYSIsInNpZ25hdHVyZSI6IjB4YzkxYWNmMzU0OTcxYTRkYTEzNjVlY2MzMThhMzIyOTUyMmUyOTI0YmJmZDA5NjRkZWE3OTRlOTdhODUxMzFkODA2NTc4OWYwZjE1Y2QzNzg2ZTIwODBjMGFkZDQyZDA0NjQ1YzM1MTY2YmYyY2UwMjUzZGIwNGYyZmY0ZjM5NDEiLCJzaWduaW5nS2V5Ijp7InB1YmxpY0tleSI6Ik1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRUZxY2FaYW5vcDVnQU5yODRVVlU3ZTZueGRoaHQyNTdoa21qT0hvSE5IOWVvVmltdHRjTVl1VCtsNzJNZDVHNkhlT0ZsNkpmVEJ1bHdHakhSSjNZUklBPT0iLCJmb3JtYXQiOiJTdWJqZWN0UHVibGljS2V5SW5mbyIsImFsZ29yaXRobSI6IkVTMjU2In0sInNpZ25pbmdLZXlBdXRoIjp7ImFkZHJlc3MiOiIweGQ1ZDkxMTc2ZGIxYjIyMjk4YTMzNGI5YzMzMmZiYTJmM2MzZGYwMmIiLCJzaWduaW5nS2V5U2lnbmF0dXJlIjoiMHg3ZjViZmUyZTY4YjFlMTkzMDg4NzA3YjEzYzgwZjdiNTE5YjYwNTMxN2NhYzY0YWU1OGI5ODM0NjU4MzkyOTg0MGQ5ZTA2Y2UzZjFiOTQ2MzlhYjhiZWU2MDE0OTIxZjM1NGM5Zjg0NGM1MjBhNmM2M2ZkYTQ4YTZhYzRjODkyODFiIiwic2lnbmluZ0tleU1lc3NhZ2UiOiJJIGF1dGhvcml6ZSBBdGVtUmV2aWV3IGZyb20gdGhpcyBkZXZpY2UgdXNpbmcgc2lnbmluZyBrZXk6XG5NRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUVGcWNhWmFub3A1Z0FOcjg0VVZVN2U2bnhkaGh0MjU3aGttak9Ib0hOSDllb1ZpbXR0Y01ZdVQrbDcyTWQ1RzZIZU9GbDZKZlRCdWx3R2pIUkozWVJJQT09In19AQA04IhtCpwcsr9NDv3QPpwBsRv645gV4bt2UJA5kyTmJ3DxgllCk2wgGWGaNQ7iyaKVpDSnFH5f4PjGiamumA8Hdq32K5f3nW4NGmSHJEOtWMc-2szcTRHn7Txb4JWQ5TmjCximvjBTjbPdgUF0gds5ntd4tYG_kk86fiYkqbW1gxhdXvUSD3g3tKfWE5cVMBg-HG3eAJTMqz_KPGeL1CiLqGp28709FURVQWgGLcARrsN0mxU31O2SLg6izpdIRUE5MJvPxpPFVtUhJ3HwnNZOEanRV9jXrV6tYCONGouMhEwQAKycQDnDI416tH-SnMGXplG-iDr6POEIFXulmfygbuTzwO8MJVynRO0DviXAAbtx_tXjj84FyF74W_7fCuu0aM6N9CH9RriJ_UOlpRw8uFrqRddQs37611P-xwYViRQF5KQLjceZWqpdLqu48K7lH04GdJe-YkPvJQ3atqkqmwwVfe70mbh1GYOrFLdJIGk4zZNMCfeiAnJpApyW3V6xtgTVZ8tkP0b6dhsqbC--cWNwiGbt_wMIB--mkRwb-BAQDXOBQINYqxiJyCMwk_lGAlCKFwQ2QTH8JW468OB3bVZ9g2tbPqgxX4UJDrQW81L6QTrw99nb3tHmMoNkTePCK6gWdcXlAC1snhd75932gcsIe4bgKVXQfkubnGbjI5z4F-1slaE508RbcjB8yv4skPYyk7kzbz2Q76Sl8q2iLoze8XAuDbyd2ifM7LFCxUDYKoguXENqKWxToYNAOxiyAZFzcElcA-QQXxxwrIlfpsI46nbo5Zc8vqUeQQr71dhWeD5VQILMV_IQhEFDVaTuf4CEkhP0ni7kVl5YXUkUSOHRhTVpuxO-WSc3jp_wuYWQrkIyHYEv2vjv_-b9jKgUJSg1HbcOeKV54lJGQOFIT1zYHBsFb3QQ7MmwiXjP_2pFQ4Q1q2Op6hjqMx36yFEtVUfwnaOCz-ew5UpDzsH2_NTAwZGI8z7tR2DUyxFAnFojbcNPmFe4-Hg8f2uaenrDYiGSJ1ytwyRsNmuDWu3vRckS1s0jT7XeeGLNKo3BmE1cCSb5eHuqBO2zD1ykqbQInojt44QpwxUTpeFptzV9mtSBOA2WH5NYUY4YuO6fU4G2ZgZMPP9cua7p3gG-GZjsjtY4jsUOpkAgTvgEKaKB52nDZULYIctOZUUeZKnSbAxHGWbkqaeJ7kCU-35AY5kTm8NZTqp6cgwcKxBSkP93LddraDyyjeo303WFO52jmNMXvTfw7lq1Zc1mQ475LnIi2duT-lSOCOK60WybsFQJOUVwT1eEXF7h_vEmT5bopUOrX8oCwxFUHhfJbZa0TMRJo6FDfRipD435smc7HpZpAAAIAAAAAAAAAH0BAAAAAAAAD_IFGENvbnRlbnQtVHlwZSBhcHBsaWNhdGlvbi9qc29uFkFwcGxpY2F0aW9uGEN5YmVyQ29ubmVjdBxDb250ZW50LUF1dGhvchh6dXVwbWtibmVwbnUOQ2hhaW5JZAQ1NhxDb250ZW50LVRhcmdldIABMzlmMDIxODgxZTczODZmOGQ3M2Q2ZWYyNTUzM2U2MDkxZjJhMDI1NmU0MjJiNGIzYzRlM2QzMzVjY2FlMTQ3ZQxTb3VyY2VIMTU1MzFmYTItMTIwNS00ZjYxLWI2ZTQtYzlmNjhlY2Y4MWY3FENvbnRlbnQtSWSAAWMxMWMzYWExMmE2N2MyMjQzNDRiMjRjZDdkYTZkNzRmNDFjYjQ3MzIxNTBjMTM5ODg3NzNhNTU3YmEzNDUzOGEcQ29udGVudC1EaWdlc3SAAWMxMWMzYWExMmE2N2MyMjQzNDRiMjRjZDdkYTZkNzRmNDFjYjQ3MzIxNTBjMTM5ODg3NzNhNTU3YmEzNDUzOGEAeyJjb250ZW50Ijoie1wib3BcIjpcImNvbW1lbnRcIixcImFkZHJlc3NcIjpcIjB4MmQ3ZDhjOWYzMWE4OWQ5MjQ4ZjY2MjkzOTM2N2M4OTY1NzBmZTg0OFwiLFwidHNcIjoxNjkxNDYwNjIxODMwLFwiY2hhaW5JZFwiOjU2LFwiaGFuZGxlXCI6XCJ6dXVwbWtibmVwbnVcIixcInRhcmdldFwiOlwiMzlmMDIxODgxZTczODZmOGQ3M2Q2ZWYyNTUzM2U2MDkxZjJhMDI1NmU0MjJiNGIzYzRlM2QzMzVjY2FlMTQ3ZVwiLFwidGl0bGVcIjpcIkZsYXBweU1vb25iaXJkXCIsXCJib2R5XCI6XCJTbyBmdW4gdG8gcGxheSBpbiBteSBzcGFyZSB0aW1lLlwifSIsImRpZ2VzdCI6ImMxMWMzYWExMmE2N2MyMjQzNDRiMjRjZDdkYTZkNzRmNDFjYjQ3MzIxNTBjMTM5ODg3NzNhNTU3YmEzNDUzOGEiLCJzaWduYXR1cmUiOiIweDBiNWVlYjc1YTFmZGY4N2MyOWMzOGY4YzM3OTlmYzFkMDk4YmY3NWVkMzU1M2E0NDYxOGJhNjFhNTE5NTU2MzFhYzExZTdjNjgxZWZiMTY0YmFhZjRkYWE0OTU0OTEzOGQyYTIyYmMxNTkzZmFkNmVmNjMyNWM2NzE0OTcwODFhIiwic2lnbmluZ0tleSI6eyJwdWJsaWNLZXkiOiJNRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUVpazhnRHRHZkdvdXdNbjhIOEZRNDhWSjliQVdnZWd2dmZrZWM1ckJFMFh3cjNJWTR0RGF4U0thUzRQVUpUeUUzYWFlZmVGTm4yVVhaOXBma1luU3cyZz09IiwiZm9ybWF0IjoiU3ViamVjdFB1YmxpY0tleUluZm8iLCJhbGdvcml0aG0iOiJFUzI1NiJ9LCJzaWduaW5nS2V5QXV0aCI6eyJhZGRyZXNzIjoiMHgyZDdkOGM5ZjMxYTg5ZDkyNDhmNjYyOTM5MzY3Yzg5NjU3MGZlODQ4Iiwic2lnbmluZ0tleVNpZ25hdHVyZSI6IjB4MzQ1MGNkZjdmNTIxZDA1ZDk0YTJjY2U1OTA5YTVlNTNjZjI3ZTlhMTBkZDdmNzIyOTcyMjkwZjJjNWY2ODU5ZTBhNmJiNDJlODM5YzBhNzMzNjYzODczNjE0NDUzZmRjNDNhZmVlMTRjZDliYzlkZDlhMTNmNmUxM2VhMTc2NzkxYiIsInNpZ25pbmdLZXlNZXNzYWdlIjoiSSBhdXRob3JpemUgQ3liZXJDb25uZWN0IGZyb20gdGhpcyBkZXZpY2UgdXNpbmcgc2lnbmluZyBrZXk6XG5NRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUVpazhnRHRHZkdvdXdNbjhIOEZRNDhWSjliQVdnZWd2dmZrZWM1ckJFMFh3cjNJWTR0RGF4U0thUzRQVUpUeUUzYWFlZmVGTm4yVVhaOXBma1luU3cyZz09In19AQBvQmzrBVUPj7955BKIJLeBn2q_DF-fDqv-nVSWmMp5y1KVyPJWkZ07cbci9f4GHvb-YT1xZPCsNKaldhTTKdupKXVQHKqsc_yiaci-unCRqUSUplqp7dP1Vn8tHxtAXgAd1cKUBRndOguJVBZfyS8tHX7ABgybkxETH-hBL_i7he5UMwC8oiXt20WbChKdjyuMXz_EzAc6sFyTxQhDIfIBUYEXbagVk5Fg2JCGkU-dv4u5rO_VBCEMJaW89NIO66VUsgqgJWMDRG6cIEN7RKzP9thVH0Xo3AYPaa2TyaOD3j4d3oXIH7naTYx-uMLBpRsa_faoyFY4vzrzbWBJ4ARhPctQ_xZEe7H3lzHe4UgihrNDLaMN58s20_6UCV458GjhCtLDc0qguOzMuv5rdyJaynQuG6YyDgYdSqVIFL0TmqLytoEGodDbaxl-nBx9-1aXqkv6lVPN9JFWMNCWFtk-kV2JmnmERoFCXFoCBXCPvou5Z8MbUFX_zAyrRoTjfWipCSdDjb9glWsC5IDYDtltxEGT74CQXGjRZEjsTMqYrFi-DFPBc0pYjtfsaMuHiYYhvUqB94dmIi-umumcxxxBiwm0qVtbW2h18B4a_aP9qWPWAMjIS2UpuhLc4ZqZaesUdIxgMU7H8AM31ivqLjBn_uEKjIY7hJ4L6l5VM33Knpz4F-1slaE508RbcjB8yv4skPYyk7kzbz2Q76Sl8q2iLoze8XAuDbyd2ifM7LFCxUDYKoguXENqKWxToYNAOxiyAZFzcElcA-QQXxxwrIlfpsI46nbo5Zc8vqUeQQr71dhWeD5VQILMV_IQhEFDVaTuf4CEkhP0ni7kVl5YXUkUSOHRhTVpuxO-WSc3jp_wuYWQrkIyHYEv2vjv_-b9jKgUJSg1HbcOeKV54lJGQOFIT1zYHBsFb3QQ7MmwiXjP_2pFQ4Q1q2Op6hjqMx36yFEtVUfwnaOCz-ew5UpDzsH2_NTAwZGI8z7tR2DUyxFAnFojbcNPmFe4-Hg8f2uaenrDYiGSJ1ytwyRsNmuDWu3vRckS1s0jT7XeeGLNKo3BmE1cCSb5eHuqBO2zD1ykqbQInojt44QpwxUTpeFptzV9mtSBOA2WH5NYUY4YuO6fU4G2ZgZMPP9cua7p3gG-GZjsjtY4jsUOpkAgTvgEKaKB52nDZULYIctOZUUeZKnSbAxHGWbkqaeJ7kCU-35AY5kTm8NZTqp6cgwcKxBSkP93LddraDyyjeo303WFO52jmNMXvTfw7lq1Zc1mQ475LnIi2duT-lSOCOK60WybsFQJOUVwT1eEXF7h_vEmT5bopUOrX8oCwxFUHhfJbZa0TMRJo6FDfRipD435smc7HpZpAAAHAAAAAAAAAAwBAAAAAAAADZAEGENvbnRlbnQtVHlwZSBhcHBsaWNhdGlvbi9qc29uFkFwcGxpY2F0aW9uGEN5YmVyQ29ubmVjdBRDb250ZW50LUlkgAExYmIxNDFmMTIxNTYxNjkxYTZkMjFlZGIxZmMxMDhkY2U2OTYwZjFiODQ4MTczZTIxZTU1MmI2ODVmYTA4NGRkHENvbnRlbnQtRGlnZXN0gAExYmIxNDFmMTIxNTYxNjkxYTZkMjFlZGIxZmMxMDhkY2U2OTYwZjFiODQ4MTczZTIxZTU1MmI2ODVmYTA4NGRkHENvbnRlbnQtQXV0aG9yGDkxaWRvcm54dmZnMw5DaGFpbklkBDU2DFNvdXJjZQhhdGVtAHsiY29udGVudCI6IntcIm9wXCI6XCJwb3N0XCIsXCJhZGRyZXNzXCI6XCIweDZmNGE5Mjk5OWJhZDc0OWY5MWZlMzJhNjIyYjhlM2VmNDE2MzY3MDVcIixcInRzXCI6MTY5MTQ2MDYyMTE4MSxcImNoYWluSWRcIjo1NixcImhhbmRsZVwiOlwiOTFpZG9ybnh2ZmczXCIsXCJ0aXRsZVwiOlwiMTExMTJcIixcImJvZHlcIjpcIjIyMjIyMjIyMjIyMjIyMjIyMlwifSIsImRpZ2VzdCI6IjFiYjE0MWYxMjE1NjE2OTFhNmQyMWVkYjFmYzEwOGRjZTY5NjBmMWI4NDgxNzNlMjFlNTUyYjY4NWZhMDg0ZGQiLCJzaWduYXR1cmUiOiIweGYxOWEzOGVhNjdjNDkyNGIyMmNjNGI5NzZmNmM2N2YxNzkzOWU4OTJkZDZlMTg1NzhmNGQwMDNhMDgxYWEwMWY4MjE0ZmNiOTdmZDYyOGNmNGViY2RlYTY2ZDAwNzAxNjcwZTE1YjVjZWM3NzhlODg5MzcwMmQ0MTRiNTliNGMzIiwic2lnbmluZ0tleSI6eyJwdWJsaWNLZXkiOiJNRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUVPSHRZYnQrSlEwUEJRTHN6UXR6Sy8yd1d6UVVLZU15K3Q1YjV0eDExZ2RaMmFYOWY5VmVGdTU3YThXT2prblo0V21lNWpLUnpvUEVsZkNPNXJYamVUZz09IiwiZm9ybWF0IjoiU3ViamVjdFB1YmxpY0tleUluZm8iLCJhbGdvcml0aG0iOiJFUzI1NiJ9LCJzaWduaW5nS2V5QXV0aCI6eyJhZGRyZXNzIjoiMHg2ZjRhOTI5OTliYWQ3NDlmOTFmZTMyYTYyMmI4ZTNlZjQxNjM2NzA1Iiwic2lnbmluZ0tleVNpZ25hdHVyZSI6IjB4MTZlMTk2ZDZjYTMzMTIzNjRlNmJmYWQ5ODE3YWJjN2QzNGNkZGZmZTExZTgyZTI4NWI2ZWIxYzY0Y2Q4ZmQ5ZDA5NjdjNmU5YTA5YWNjZTI1NjJmZWJkOTMzOTdlNjkwN2E2MTJjODhlOTlhNzhmOTVmMDJjNTMzYzhkOTVhMDYxYyIsInNpZ25pbmdLZXlNZXNzYWdlIjoiSSBhdXRob3JpemUgQXRlbVJldmlldyBmcm9tIHRoaXMgZGV2aWNlIHVzaW5nIHNpZ25pbmcga2V5OlxuTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFT0h0WWJ0K0pRMFBCUUxzelF0eksvMndXelFVS2VNeSt0NWI1dHgxMWdkWjJhWDlmOVZlRnU1N2E4V09qa25aNFdtZTVqS1J6b1BFbGZDTzVyWGplVGc9PSJ9fQEAWmE1dz2m44BrQVKODIvQ3Dg0u7gN7UshnsvDcMoJYNzoO7f9Kijk28TcgpZNTpYxR1F64KE6UApvRfMJ4PAjhSuK-ajCq27yzRyx1BBiYMsy1Da9dOKjy9-n4t7Q5EjGaKp_ukfzsgT_BCWJVpy6PkitBIwbUza9ofdg3HyUDZExxGitFzBf1CpO98xOwp0PddglKMDFijzdPbaYVkg-lCKnSEVWKrPFbqNswusS6OkwPi8aFEy3nJM52445HWmB2jtCfnNaX4e_fD1v8ObXZaX8-iobqNrKVKWIwH_413M9vhc-HP1rguFYy9g9yU2mZA-bCAqYJCVXa705u8qkey-6ZvJTqhhGBW9SrE7ahvL6TEzTqVK_zrfDCWY4Y5WFFOM_TLo5ot-kzp2Cxx-ZRmrK-sW5Hi5RgJpZ0lHbkhPLbqtyX5DFM03Ri5JGmRs3LCGAc9tB2Npk3haOteqLhND_JYeFPgEuYbSxj3YuhtNrglIixSboWLK3Ch-XKxU_cyDrfn5s79_QdHtjyoz-TVW_0RAeqw2Ckcu_TY_iL-h5c_MVSMBgXuvZVPMe8BP395D7OzkjRdZ-IBWkmIvUaItvNf19iVxmxqayt6tDAO1oSEzj0WZKNWcQkDRHAVHWeLLhlmHTVA02SrJojTtnhREMJvkiYy8dHF51XHorFn-c-BftbJWhOdPEW3IwfMr-LJD2MpO5M289kO-kpfKtoi6M3vFwLg28ndonzOyxQsVA2CqILlxDailsU6GDQDsYsgGRc3BJXAPkEF8ccKyJX6bCOOp26OWXPL6lHkEK-9XYVng-VUCCzFfyEIRBQ1Wk7n-AhJIT9J4u5FZeWF1JFEjh0YU1absTvlknN46f8LmFkK5CMh2BL9r47__m_YyoFCUoNR23DnileeJSRkDhSE9c2BwbBW90EOzJsIl4z_9qRUOENatjqeoY6jMd-shRLVVH8J2jgs_nsOVKQ87B9vzUwMGRiPM-7Udg1MsRQJxaI23DT5hXuPh4PH9rmnp6w2IhkidcrcMkbDZrg1rt70XJEtbNI0-13nhizSqNwZhNXAkm-Xh7qgTtsw9cpKm0CJ6I7eOEKcMVE6Xhabc1fZrUgTgNlh-TWFGOGLjun1OBtmYGTDz_XLmu6d4BvhmY7I7WOI7FDqZAIE74BCmigedpw2VC2CHLTmVFHmSp0mwMRxlm5Kmnie5AlPt-QGOZE5vDWU6qenIMHCsQUpD_dy3Xa2g8so3qN9N1hTudo5jTF7038O5atWXNZkOO-S5yItnbk_pUjgjiutFsm7BUCTlFcE9XhFxe4f7xJk-W6KVDq1_KAsMRVB4XyW2WtEzESaOhQ30YqQ-N-bJnOx6WaQAABwAAAAAAAAANAQAAAAAAAA2SBBhDb250ZW50LVR5cGUgYXBwbGljYXRpb24vanNvbhZBcHBsaWNhdGlvbhhDeWJlckNvbm5lY3QUQ29udGVudC1JZIABOWEzNTc5ZTA4MTZmNmNiOTczNGY5ODEzZWRlZTIyN2VmYzE0YmE5NTNkYWE0NDNjZTJhYjdlOTcwMmYxMjY3OBxDb250ZW50LURpZ2VzdIABOWEzNTc5ZTA4MTZmNmNiOTczNGY5ODEzZWRlZTIyN2VmYzE0YmE5NTNkYWE0NDNjZTJhYjdlOTcwMmYxMjY3OBxDb250ZW50LUF1dGhvchoxMTMyODYzMDEzOTYxDkNoYWluSWQENTYMU291cmNlCGF0ZW0AeyJjb250ZW50Ijoie1wib3BcIjpcInBvc3RcIixcImFkZHJlc3NcIjpcIjB4NWFmMWRmMGNhMTA3OGI5MmJjYTA3NDg1NjEwNjE4YTcwYTI5NzRlMFwiLFwidHNcIjoxNjkxNDYwNjIyMzAzLFwiY2hhaW5JZFwiOjU2LFwiaGFuZGxlXCI6XCIxMTMyODYzMDEzOTYxXCIsXCJ0aXRsZVwiOlwiMTExMTJcIixcImJvZHlcIjpcIjIyMjIyMjIyMjIyMjIyMjIyMlwifSIsImRpZ2VzdCI6IjlhMzU3OWUwODE2ZjZjYjk3MzRmOTgxM2VkZWUyMjdlZmMxNGJhOTUzZGFhNDQzY2UyYWI3ZTk3MDJmMTI2NzgiLCJzaWduYXR1cmUiOiIweGU4OTgwODIwYWQ4NzJhYWMwMmE0MGJmNjY2OWIxZWE0NjMzYmZiY2VlZGM5ZTFlZjlmN2QwZTIwMzZjZjVhNDUyNWVjZTY4Mjg1NDQ1ZWU4ODFiZGQxODQ0OGQyY2FhODRlZTAwMjA5Y2Y1ZjMwZjQ3MmViMTQyNmRhOWE1MWEwIiwic2lnbmluZ0tleSI6eyJwdWJsaWNLZXkiOiJNRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUU1bFZkZU90N1o1VVlQaXY3QkJwVVZtMXExS0pVZUd1aVZBOWpKZTRWTzBhYUUwV3dSNDhNRHlyWWxKUjJsTWpJT1A2V1JOdzR5Wlc0dHBvaFBqcnVCQT09IiwiZm9ybWF0IjoiU3ViamVjdFB1YmxpY0tleUluZm8iLCJhbGdvcml0aG0iOiJFUzI1NiJ9LCJzaWduaW5nS2V5QXV0aCI6eyJhZGRyZXNzIjoiMHg1YWYxZGYwY2ExMDc4YjkyYmNhMDc0ODU2MTA2MThhNzBhMjk3NGUwIiwic2lnbmluZ0tleVNpZ25hdHVyZSI6IjB4MGU2YzhiMWM3YThkYWNjY2Q5OTU1YzkyODg3MzlmM2JmZDRmNDJlZTBlMGExMGRlOTFhYjllZGNjMTQzMTg4NTNmZTQ3N2MxZGNiZWM2MDM2NTQwMmRlZjUwOTMyZGJjMmE4MWFmNDg0YWQ2NDJkNWFkODRkMGU0MjRmNDUyYmExYyIsInNpZ25pbmdLZXlNZXNzYWdlIjoiSSBhdXRob3JpemUgQXRlbVJldmlldyBmcm9tIHRoaXMgZGV2aWNlIHVzaW5nIHNpZ25pbmcga2V5OlxuTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFNWxWZGVPdDdaNVVZUGl2N0JCcFVWbTFxMUtKVWVHdWlWQTlqSmU0Vk8wYWFFMFd3UjQ4TUR5cllsSlIybE1qSU9QNldSTnc0eVpXNHRwb2hQanJ1QkE9PSJ9fQEAAreUb4_33w2BnhKS4WGiaAQTaki3RzwB_TKJ8hrPXD3GM6JbHTQtqEacgmaaYmA2HyU5TzpYF-K10WQLXoOUVFTNmr09cIlcJV4ztKaVf0rvbT6dGUgukCuEC_qmgoHAWdYukmgscsOgG3_D8_zRgeVoa-p6MA_E5L1bsS_08RqyxMM79LZtDpTWMIhB_YUOh_d6iXnf1odDgJIB7X9AK_irRdOQ-N-RcQ1ZNpQ9zoODWcdzOTdL_t502ckExEaZXAtPk0WqoD7P6ikF88THg9MJXnPOjSvS4XGBi9UHethJJ7uaAXVg6G9qY6yyhfBNZgUVPQF0OQ1JcSageG7HN3LsgEbNLsNbnw9eRtflhFtxn8T-5UXDh-TJyq4DQepDLCDF6NbhVSsWK6x8O_Jv9G0XUyaf70Cq5aIg5J-QFbLUPAq_q1akP_DSMloSDldrB6fd033bVEyxzXJBqEaGR-Du2Xchhd4tC9orlDFQ73YBgeKZZJ359VzB7gk_F8_dN-XiaquouJY1M0M9akUxS02JQKn3zbvK47X5HWXW53goSKxLIw62lVH_LKckez0cJWTqAcyzsW4T0YAp3yEzYV5qEEXnN0qfIbWy6Q5phaQmfsMCckMC1UR_uecislRkZPg04jZlGbvnrS0PmCKZreXNwVcB7BdGxWmqdd1WaDuc-BftbJWhOdPEW3IwfMr-LJD2MpO5M289kO-kpfKtoi6M3vFwLg28ndonzOyxQsVA2CqILlxDailsU6GDQDsYsgGRc3BJXAPkEF8ccKyJX6bCOOp26OWXPL6lHkEK-9XYVng-VUCCzFfyEIRBQ1Wk7n-AhJIT9J4u5FZeWF1JFEjh0YU1absTvlknN46f8LmFkK5CMh2BL9r47__m_YyoFCUoNR23DnileeJSRkDhSE9c2BwbBW90EOzJsIl4z_9qRUOENatjqeoY6jMd-shRLVVH8J2jgs_nsOVKQ87B9vzUwMGRiPM-7Udg1MsRQJxaI23DT5hXuPh4PH9rmnp6w2IhkidcrcMkbDZrg1rt70XJEtbNI0-13nhizSqNwZhNXAkm-Xh7qgTtsw9cpKm0CJ6I7eOEKcMVE6Xhabc1fZrUgTgNlh-TWFGOGLjun1OBtmYGTDz_XLmu6d4BvhmY7I7WOI7FDqZAIE74BCmigedpw2VC2CHLTmVFHmSp0mwMRxlm5Kmnie5AlPt-QGOZE5vDWU6qenIMHCsQUpD_dy3Xa2g8so3qN9N1hTudo5jTF7038O5atWXNZkOO-S5yItnbk_pUjgjiutFsm7BUCTlFcE9XhFxe4f7xJk-W6KVDq1_KAsMRVB4XyW2WtEzESaOhQ30YqQ-N-bJnOx6WaQAABwAAAAAAAAAMAQAAAAAAAA2QBBhDb250ZW50LVR5cGUgYXBwbGljYXRpb24vanNvbhZBcHBsaWNhdGlvbhhDeWJlckNvbm5lY3QcQ29udGVudC1EaWdlc3SAAWRlZDc0ZTFkNjlmZDAyMjc5YWQzYjdiZGJhZGNiNDhlMWVkY2ExYWE2OGE4ZjBiOWM2ZTBhOGRhYzZhZGJlY2EcQ29udGVudC1BdXRob3IYNWkzYTU2c2Y2OTY0DkNoYWluSWQENTYMU291cmNlCGF0ZW0UQ29udGVudC1JZIABZGVkNzRlMWQ2OWZkMDIyNzlhZDNiN2JkYmFkY2I0OGUxZWRjYTFhYTY4YThmMGI5YzZlMGE4ZGFjNmFkYmVjYQB7ImNvbnRlbnQiOiJ7XCJvcFwiOlwicG9zdFwiLFwiYWRkcmVzc1wiOlwiMHg2NzczNmIyOTBhYWViNWYzNTc2ZjlhMmRlYWM2MGE1ZTZmOGVkZTYwXCIsXCJ0c1wiOjE2OTE0NjA2MjEzMjUsXCJjaGFpbklkXCI6NTYsXCJoYW5kbGVcIjpcIjVpM2E1NnNmNjk2NFwiLFwidGl0bGVcIjpcIjExMTEyXCIsXCJib2R5XCI6XCIyMjIyMjIyMjIyMjIyMjIyMjJcIn0iLCJkaWdlc3QiOiJkZWQ3NGUxZDY5ZmQwMjI3OWFkM2I3YmRiYWRjYjQ4ZTFlZGNhMWFhNjhhOGYwYjljNmUwYThkYWM2YWRiZWNhIiwic2lnbmF0dXJlIjoiMHgzYzFiMWVmNjVmYWFjYWU2MzczYWUzMzU4YzA0MTAyYTJmOTU3NTViM2VkOWI2MWFkMmVlNDUyNWVkMTc5YWJkYmZiOTJkMTE0ZWVhNmJlYzY2N2Q2OTdiMGYxNjc3ZThlZjBlZThmMTI2N2UxODBiMzA3YzUzNDE3YTM2YjBiMyIsInNpZ25pbmdLZXkiOnsicHVibGljS2V5IjoiTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFRTVMdDdHSCtmOUFlVmlaSmZTZzM0U2NLREpmL0FQWGE1amtkZmxGU3l0VGRPeWJnVWRNUC9lcnEvZnlmTXBrL1BsTzBqTWtBVkFZTjhjazR6UWxweGc9PSIsImZvcm1hdCI6IlN1YmplY3RQdWJsaWNLZXlJbmZvIiwiYWxnb3JpdGhtIjoiRVMyNTYifSwic2lnbmluZ0tleUF1dGgiOnsiYWRkcmVzcyI6IjB4Njc3MzZiMjkwYWFlYjVmMzU3NmY5YTJkZWFjNjBhNWU2ZjhlZGU2MCIsInNpZ25pbmdLZXlTaWduYXR1cmUiOiIweDdiNWIzMTM1ZjRkOWY1NWJiN2NjNzZkZGZjN2JjYThlZTk3MGYzZDUwNzRmMmFlNjBhZTBhZjcxNmE4NWNhZTU1MDllMzEzOTk3NTYxOTNjNjQ5NDI5ZGYzZjA1YTAzODNjZDY1ODA1MDk1MDcwZDkxM2Q2NDAxMTRjMTk2ZTg1MWMiLCJzaWduaW5nS2V5TWVzc2FnZSI6IkkgYXV0aG9yaXplIEF0ZW1SZXZpZXcgZnJvbSB0aGlzIGRldmljZSB1c2luZyBzaWduaW5nIGtleTpcbk1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRUU1THQ3R0grZjlBZVZpWkpmU2czNFNjS0RKZi9BUFhhNWprZGZsRlN5dFRkT3liZ1VkTVAvZXJxL2Z5Zk1way9QbE8wak1rQVZBWU44Y2s0elFscHhnPT0ifX0BAJuDE8ohPRYf22tot4js92LN2wHw7-UmDeyHerzQbVrBKAGwqrvcLGwEEw1L_5p8FN39a3qt_J2pZ_4qCqA6vPZ7rHRqVlQXVvql3Gp2fPc5x0pDOPanzI8mtwMckII5Szfz18byyUwd9zNvhl7IY8_CEE34sBzKhGXw3j_Zz6T1QGa16ZLsgBMVMyETqxW1v_2gQjFRUzdKfLVUjHb9KE5mgnIXPBRqBe3mcZ37DuhoJpM2Spp2DeDVvdQc3LwfBap8tvfGuJY2X8bjNImUq4gYcMILU9-JRMvYlobuJJeDal7SnUhZHu_3u18P8CkmxMb7BrhEUs25g4IJsffZhPwLnh6UFo3Z1QkKvZsTC6eGqYi5WhAlLhNuezYpExHeyXFf1hz6Tu0VTw47BHarIcmzWvJLq_DXqRdYtM15L5Mf7I-sKOK1FRck5QYno_Is_j-lv09lsiSn8LOeN-vXJD-vgd-8DCRpDMVfrzLxnc677q2y_ghIZiJ0h6hAo6ALAeEU1hqF0tFd0vbz5YnnzShljhtHuf-NBgWW6_KmhPmUXv4gausxAfI5AeiqwKHgUK9NQgIzi1k252BjE88_q8NJeDetpAf7pOLgHPteMFQ2AtqsPpKb3WSV2UyqICTFxXmovpDMHSjWhCuPflFt4Ctlc-HBBMwnVZB3-l0t3k1lnPgX7WyVoTnTxFtyMHzK_iyQ9jKTuTNvPZDvpKXyraIujN7xcC4NvJ3aJ8zssULFQNgqiC5cQ2opbFOhg0A7GLIBkXNwSVwD5BBfHHCsiV-mwjjqdujllzy-pR5BCvvV2FZ4PlVAgsxX8hCEQUNVpO5_gISSE_SeLuRWXlhdSRRI4dGFNWm7E75ZJzeOn_C5hZCuQjIdgS_a-O__5v2MqBQlKDUdtw54pXniUkZA4UhPXNgcGwVvdBDsybCJeM__akVDhDWrY6nqGOozHfrIUS1VR_Cdo4LP57DlSkPOwfb81MDBkYjzPu1HYNTLEUCcWiNtw0-YV7j4eDx_a5p6esNiIZInXK3DJGw2a4Na7e9FyRLWzSNPtd54Ys0qjcGYTVwJJvl4e6oE7bMPXKSptAieiO3jhCnDFROl4Wm3NX2a1IE4DZYfk1hRjhi47p9TgbZmBkw8_1y5runeAb4ZmOyO1jiOxQ6mQCBO-AQpooHnacNlQtghy05lRR5kqdJsDEcZZuSpp4nuQJT7fkBjmRObw1lOqnpyDBwrEFKQ_3ct12toPLKN6jfTdYU7naOY0xe9N_DuWrVlzWZDjvkuciLZ25P6VI4I4rrRbJuwVAk5RXBPV4RcXuH-8SZPluilQ6tfygLDEVQeF8ltlrRMxEmjoUN9GKkPjfmyZzselmkAAAgAAAAAAAAAgwEAAAAAAAAP_gUYQ29udGVudC1UeXBlIGFwcGxpY2F0aW9uL2pzb24WQXBwbGljYXRpb24YQ3liZXJDb25uZWN0HENvbnRlbnQtRGlnZXN0gAE2YWZlNmVjY2MxOTQ3OWRlZmY5YzAyNDdhMDdhMzRhMmQwM2NiYWRlNWRmZWRkZmE0YjgxYTU3ZDZkYTg0NzU2HENvbnRlbnQtQXV0aG9yJGdvbGRpZWFtZXRoeXN0eGJweg5DaGFpbklkBDU2HENvbnRlbnQtVGFyZ2V0gAEzOWYwMjE4ODFlNzM4NmY4ZDczZDZlZjI1NTMzZTYwOTFmMmEwMjU2ZTQyMmI0YjNjNGUzZDMzNWNjYWUxNDdlDFNvdXJjZUgxNTUzMWZhMi0xMjA1LTRmNjEtYjZlNC1jOWY2OGVjZjgxZjcUQ29udGVudC1JZIABNmFmZTZlY2NjMTk0NzlkZWZmOWMwMjQ3YTA3YTM0YTJkMDNjYmFkZTVkZmVkZGZhNGI4MWE1N2Q2ZGE4NDc1NgB7ImNvbnRlbnQiOiJ7XCJvcFwiOlwiY29tbWVudFwiLFwiYWRkcmVzc1wiOlwiMHg4NDY0MzE1YzliNjYwMDM2NGM4YWZlNjE0NTY0ZGJiOTBiMDdiM2VmXCIsXCJ0c1wiOjE2OTE0NjA2MjIwMTEsXCJjaGFpbklkXCI6NTYsXCJoYW5kbGVcIjpcImdvbGRpZWFtZXRoeXN0eGJwelwiLFwidGFyZ2V0XCI6XCIzOWYwMjE4ODFlNzM4NmY4ZDczZDZlZjI1NTMzZTYwOTFmMmEwMjU2ZTQyMmI0YjNjNGUzZDMzNWNjYWUxNDdlXCIsXCJ0aXRsZVwiOlwiRmxhcHB5TW9vbmJpcmRcIixcImJvZHlcIjpcIkFoYSBzbyBwcm91bmQgb2YgbXlzZWxmLiBJIGdvdCAxMDMgcG9pbnRzLlwifSIsImRpZ2VzdCI6IjZhZmU2ZWNjYzE5NDc5ZGVmZjljMDI0N2EwN2EzNGEyZDAzY2JhZGU1ZGZlZGRmYTRiODFhNTdkNmRhODQ3NTYiLCJzaWduYXR1cmUiOiIweDc5OTQwOGI1YTk1YjBjZTZhOWYxNWVmMjE2NDJmYmQxZjFjMjMxNzhhOGMzNjk5YzM0NmM0NzY4ZTE4YTBhY2RjNGNhZmEwOWZkMGQ4MTczNmY0MmY5ZGEwNGFhNTJjYWQzZDI0YzlmNjA1MzE2ZmEwNDBiMTZiMmE4ZGRhZGY2Iiwic2lnbmluZ0tleSI6eyJwdWJsaWNLZXkiOiJNRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUUwZEQ2Y0t0Q2Mrb2xYWDZRTVIwZEltNWtzcHkrVjFTME5wYUtQdEFvYWRSdWNiV1RDa2p4aUpJcTR1MWdyams1ODFQcnRsQldST1FYUk5oVnZzakJhQT09IiwiZm9ybWF0IjoiU3ViamVjdFB1YmxpY0tleUluZm8iLCJhbGdvcml0aG0iOiJFUzI1NiJ9LCJzaWduaW5nS2V5QXV0aCI6eyJhZGRyZXNzIjoiMHg4NDY0MzE1YzliNjYwMDM2NGM4YWZlNjE0NTY0ZGJiOTBiMDdiM2VmIiwic2lnbmluZ0tleVNpZ25hdHVyZSI6IjB4MTFkOWNhYTU4YWFhMGE3ZTI3NjZjMTE3ODNiZGFhZDdkYTY5MjMxNjMxY2E0MzI0YjRkNjEyMzc5OThhZjE2NjNlYmViZTU1MTA3ZThhYzg3MjUyNWQ0N2I3MzEzZGI5ZTA4NjNkYjgwODdkODA1ZjFkNWI2ZDA3ZTNjYzQxOWMxYyIsInNpZ25pbmdLZXlNZXNzYWdlIjoiSSBhdXRob3JpemUgQ3liZXJDb25uZWN0IGZyb20gdGhpcyBkZXZpY2UgdXNpbmcgc2lnbmluZyBrZXk6XG5NRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUUwZEQ2Y0t0Q2Mrb2xYWDZRTVIwZEltNWtzcHkrVjFTME5wYUtQdEFvYWRSdWNiV1RDa2p4aUpJcTR1MWdyams1ODFQcnRsQldST1FYUk5oVnZzakJhQT09In19AQBS_H_OqleNQKN_2ngp1IDmPY2_gqjJxfVqhxJW-hIkT1vQgb2IkLCgm8bY-7RhnMIbHA0AI65MrIt5keAEvEHwdtpT-daICN8jaHck4j-2QsXZC9TyzwewPBYbiCmazudbXkmF2sqeSqBnlFZ9SgWqxRohTscpgASMDzVXeQjAm7_tIV0ZXlI_bN7PmCG0ReH3BaooRC5fW2B-Aw8nThXwZzBwti6kT1epnPPYvJ5tNaJw0eOq41BbP5DOitGKg9702wzDcKOpuA39qEqEZ0d5mHwgT3L4fVnskCw1W4_VK-i7mVww6Gft5Au-_oz0xEO8urb_yEMaFiQBSlksVF6uAqux_dqLG4fL8g7S8CCvDNpuF4yTvPiCfjQ7VZzmuMkZ11Tt_xe8n_3ptvFubGHzeUdrZXmSbk8y_75xmuYZPn2XS6z6GyG1CqrOIolCStwzGyC8UJlOq_l-ERyeWB4aS4EDx6IEljJjlqugb4X76DtqhnWb52UEVzInKJHZayxOo_3UaGUfPOYQUPgsvRBJZfaS6A9ArO1kSYhVnVMMQGxriIpfmqOQ4-hkVphrJRMC5soqRJrGLCtk_RGPeMag1tiHMUr45-2hett3L61fUuxeycp6XcVgmOF8a47scfqlhlOTPlT99pqJ3T9W0g3BwCeWLkXPx-aRPXLiBwqyHJz4F-1slaE508RbcjB8yv4skPYyk7kzbz2Q76Sl8q2iLoze8XAuDbyd2ifM7LFCxUDYKoguXENqKWxToYNAOxiyAZFzcElcA-QQXxxwrIlfpsI46nbo5Zc8vqUeQQr71dhWeD5VQILMV_IQhEFDVaTuf4CEkhP0ni7kVl5YXUkUSOHRhTVpuxO-WSc3jp_wuYWQrkIyHYEv2vjv_-b9jKgUJSg1HbcOeKV54lJGQOFIT1zYHBsFb3QQ7MmwiXjP_2pFQ4Q1q2Op6hjqMx36yFEtVUfwnaOCz-ew5UpDzsH2_NTAwZGI8z7tR2DUyxFAnFojbcNPmFe4-Hg8f2uaenrDYiGSJ1ytwyRsNmuDWu3vRckS1s0jT7XeeGLNKo3BmE1cCSb5eHuqBO2zD1ykqbQInojt44QpwxUTpeFptzV9mtSBOA2WH5NYUY4YuO6fU4G2ZgZMPP9cua7p3gG-GZjsjtY4jsUOpkAgTvgEKaKB52nDZULYIctOZUUeZKnSbAxHGWbkqaeJ7kCU-35AY5kTm8NZTqp6cgwcKxBSkP93LddraDyyjeo303WFO52jmNMXvTfw7lq1Zc1mQ475LnIi2duT-lSOCOK60WybsFQJOUVwT1eEXF7h_vEmT5bopUOrX8oCwxFUHhfJbZa0TMRJo6FDfRipD435smc7HpZpAAAHAAAAAAAAAAwBAAAAAAAADZAEGENvbnRlbnQtVHlwZSBhcHBsaWNhdGlvbi9qc29uFkFwcGxpY2F0aW9uGEN5YmVyQ29ubmVjdBRDb250ZW50LUlkgAFhZmZjNjNhZDQ4MjQxNDc2MThkODRlYzJlMTI1YTE4ZDAwN2JmNjQ4NWQ4ZjZjMGFlZDcyYTczM2U1MGYzMDE0HENvbnRlbnQtRGlnZXN0gAFhZmZjNjNhZDQ4MjQxNDc2MThkODRlYzJlMTI1YTE4ZDAwN2JmNjQ4NWQ4ZjZjMGFlZDcyYTczM2U1MGYzMDE0HENvbnRlbnQtQXV0aG9yGHcwODg4NTE2MDYzdA5DaGFpbklkBDU2DFNvdXJjZQhhdGVtAHsiY29udGVudCI6IntcIm9wXCI6XCJwb3N0XCIsXCJhZGRyZXNzXCI6XCIweGM1ZWRkOWJiNjQ3ZmQ2NjI0OWZlZWEwNjYwZjUwZmUzOGIxOWUzYmVcIixcInRzXCI6MTY5MTQ2MDYyMjM5OSxcImNoYWluSWRcIjo1NixcImhhbmRsZVwiOlwidzA4ODg1MTYwNjN0XCIsXCJ0aXRsZVwiOlwiMTExMTJcIixcImJvZHlcIjpcIjIyMjIyMjIyMjIyMjIyMjIyMlwifSIsImRpZ2VzdCI6ImFmZmM2M2FkNDgyNDE0NzYxOGQ4NGVjMmUxMjVhMThkMDA3YmY2NDg1ZDhmNmMwYWVkNzJhNzMzZTUwZjMwMTQiLCJzaWduYXR1cmUiOiIweDI1NTUxNTg3MjFjODQwNDBjNjA0N2Q1NjEzMTI2NjlmMDYxYzk3NjhiMzY0YWMxMjE2NzY0MDNlMDAyODY4M2IyYTlkYjJjOTJhZGNlNDYwMzc3NjU5YmMxMDg2ODg2ZDNkZjM3YWU5OTY4OTFlNjBhYjgwN2U2NGQyMjU0YzJmIiwic2lnbmluZ0tleSI6eyJwdWJsaWNLZXkiOiJNRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUVDbkJqQXEzam9wd1NmMDVUNFdOaitiaE9aTnJFUVh3ZWF3S2xsYlZTcmhKZmtXL1NwbERob0FzSzZkMnl1aUo0dlA4QVBWc3FkcnM0QXRlYXhrUEdaZz09IiwiZm9ybWF0IjoiU3ViamVjdFB1YmxpY0tleUluZm8iLCJhbGdvcml0aG0iOiJFUzI1NiJ9LCJzaWduaW5nS2V5QXV0aCI6eyJhZGRyZXNzIjoiMHhjNWVkZDliYjY0N2ZkNjYyNDlmZWVhMDY2MGY1MGZlMzhiMTllM2JlIiwic2lnbmluZ0tleVNpZ25hdHVyZSI6IjB4MmY1MTFhMTcyYjMyMjE2OGQyZTFjNTA0MjhjNWEwODEzMmRkM2NlMjExMDIxNTllMGEwNWZkZjA1Y2JiM2ZjODQxZDVlMDdhNjg0ZDhhYTU3ZDM5NGYxY2U2ZWRlYTE1MzBhOTg3MWQ1YmRhMWQyNmIyNTliZDNkZDU2ZDU2NDgxYyIsInNpZ25pbmdLZXlNZXNzYWdlIjoiSSBhdXRob3JpemUgQXRlbVJldmlldyBmcm9tIHRoaXMgZGV2aWNlIHVzaW5nIHNpZ25pbmcga2V5OlxuTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFQ25CakFxM2pvcHdTZjA1VDRXTmorYmhPWk5yRVFYd2Vhd0tsbGJWU3JoSmZrVy9TcGxEaG9Bc0s2ZDJ5dWlKNHZQOEFQVnNxZHJzNEF0ZWF4a1BHWmc9PSJ9fQEAfgBkiH5vPdZ0r65E2Oi7kDKq9LDY7sRJ0NNDQnKor7df0WPnjpRcpkzMJKOn9jiPLn46lD6Se4C2bgsxPvDtohUpZ0Aszwwog11vaJkW7cCggd3idbT9xCT3vBXDR_fRA1rWc7hE_TOxYnaldJhgxZrcP5zJdO2TN6LPBoOiSqN51RAzj1-5r_GhynU_GdYt2FB2aojvklQSqUJKFR8DjUR7XjrACtTmQLPhBtavmJRB04jPktskCuhEApwJXAidVmwtB36fHgeKfdqkD3jyxkS0s0ZHPtcoozn9K7wt3isYgN22QEg_KwOqTaBCMFHB_d3Q6xmK0Hj7ZE9YxF9ql0rrf5fyp_u6JO3Q4iG-9WBKxG2sa4L4Gf9ImrlQNEjb_W0eqbBAxPKVo0yj7yxXfepp2RPu2hbBJJ1AICuUoZcjOmqRLM4aSfOMn-3LnnmiTBAX95kZbIwdw-C3rha2jRXmt9EAM1TXy-jbAb0j3kvVAfNP_6lYxIpHqZYb1bI90X2763WmWmmWGTbRdt4nlwWsFX0F0owZE7_ppGANwsLqLWcw0_K5w0zIrTcPFCh6CcqHgeeLoPz9ERIO1-zex28kw5JNS_LQ844sS0UlWvb95-cxnfN2CZAR-xKp9M_9GXDStYwqNXhGs6HFos26-GFmx8N4ju0goid2QGjto8ic-BftbJWhOdPEW3IwfMr-LJD2MpO5M289kO-kpfKtoi6M3vFwLg28ndonzOyxQsVA2CqILlxDailsU6GDQDsYsgGRc3BJXAPkEF8ccKyJX6bCOOp26OWXPL6lHkEK-9XYVng-VUCCzFfyEIRBQ1Wk7n-AhJIT9J4u5FZeWF1JFEjh0YU1absTvlknN46f8LmFkK5CMh2BL9r47__m_YyoFCUoNR23DnileeJSRkDhSE9c2BwbBW90EOzJsIl4z_9qRUOENatjqeoY6jMd-shRLVVH8J2jgs_nsOVKQ87B9vzUwMGRiPM-7Udg1MsRQJxaI23DT5hXuPh4PH9rmnp6w2IhkidcrcMkbDZrg1rt70XJEtbNI0-13nhizSqNwZhNXAkm-Xh7qgTtsw9cpKm0CJ6I7eOEKcMVE6Xhabc1fZrUgTgNlh-TWFGOGLjun1OBtmYGTDz_XLmu6d4BvhmY7I7WOI7FDqZAIE74BCmigedpw2VC2CHLTmVFHmSp0mwMRxlm5Kmnie5AlPt-QGOZE5vDWU6qenIMHCsQUpD_dy3Xa2g8so3qN9N1hTudo5jTF7038O5atWXNZkOO-S5yItnbk_pUjgjiutFsm7BUCTlFcE9XhFxe4f7xJk-W6KVDq1_KAsMRVB4XyW2WtEzESaOhQ30YqQ-N-bJnOx6WaQAABwAAAAAAAAAWAQAAAAAAAA2kBBhDb250ZW50LVR5cGUgYXBwbGljYXRpb24vanNvbhZBcHBsaWNhdGlvbhhDeWJlckNvbm5lY3QOQ2hhaW5JZAQ1NgxTb3VyY2USY3liZXJ0dW5lFENvbnRlbnQtSWSAATU2ZWRiZGIzNjU4ZTE4Y2VkMjM1OGMxZTUyZWRiOGQ2M2Q0NTRmODJmMTAyZDEyYmFiYTllYWMwNGQwMjUxYjEcQ29udGVudC1EaWdlc3SAATU2ZWRiZGIzNjU4ZTE4Y2VkMjM1OGMxZTUyZWRiOGQ2M2Q0NTRmODJmMTAyZDEyYmFiYTllYWMwNGQwMjUxYjEcQ29udGVudC1BdXRob3Iic290eXlheXhmd3Vua2drNDYAeyJjb250ZW50Ijoie1wib3BcIjpcInBvc3RcIixcImFkZHJlc3NcIjpcIjB4NjI1YTExNzFmZGMyOGM4MzY4YWEzYzlmMWVhNGYwNTQ5YzVjNDhlMlwiLFwidHNcIjoxNjkxNDYwNjIyNTQ5LFwiY2hhaW5JZFwiOjU2LFwiaGFuZGxlXCI6XCJzb3R5eWF5eGZ3dW5rZ2s0NlwiLFwidGl0bGVcIjpcIlRoZSBTZWNyZXQgb2YgdGhlIEZvcmJpZGRlbiBUb21iXCIsXCJib2R5XCI6XCJzdXBcIn0iLCJkaWdlc3QiOiI1NmVkYmRiMzY1OGUxOGNlZDIzNThjMWU1MmVkYjhkNjNkNDU0ZjgyZjEwMmQxMmJhYmE5ZWFjMDRkMDI1MWIxIiwic2lnbmF0dXJlIjoiMHhhODY4MGY2NzUxMGZkMWE3ZGE3YmRjNDAyM2E2M2EyNmY1MTA2YjI4NzcyYTUwZDEyN2IzZDI2OWMxN2JjZWY1ZjMxYzU1NTBiMDk0YTdjOGU4M2FhMGM3NTEzOGRhYWNkNTcwMjNiYzE0MjJiMTkzNjA1NDE4MTk3YWVlZjcxYSIsInNpZ25pbmdLZXkiOnsicHVibGljS2V5IjoiTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFYXRYKzE3NnJQN0hUZC9ncEx2Sk9tTmV4SHJXKys2TnoybXJFKy9oZW05Z3dmdDZWZU11N2pXY1FWMmpDVENaYkJTWDF4ZGxFNlYxVjdaY0ZwQ1hOTVE9PSIsImZvcm1hdCI6IlN1YmplY3RQdWJsaWNLZXlJbmZvIiwiYWxnb3JpdGhtIjoiRVMyNTYifSwic2lnbmluZ0tleUF1dGgiOnsiYWRkcmVzcyI6IjB4NjI1YTExNzFmZGMyOGM4MzY4YWEzYzlmMWVhNGYwNTQ5YzVjNDhlMiIsInNpZ25pbmdLZXlTaWduYXR1cmUiOiIweDBhNjk5OWIxMTY3OTBlZGE5YjIyNDQ2MzAxYmUwMDFmYWEzNmZmNzE1OGQ4ZDM4MTYxZmIxOGVlYzMxYTM4MTk0OTFmNWRlOTkyNzk0Yjg2Mjc2YjQ1NzE0ZDRmNDlhMDRjZjViZWIwMWY2NTE1OWJiNmUxYTQxYmRiZGVkNDY1MWMiLCJzaWduaW5nS2V5TWVzc2FnZSI6IkkgYXV0aG9yaXplIEkgYXV0aG9yaXplIEN5YmVyVHVuZS54eXogZnJvbSB0aGlzIGRldmljZSB1c2luZyBzaWduaW5nIGtleTpcbk1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRWF0WCsxNzZyUDdIVGQvZ3BMdkpPbU5leEhyVysrNk56Mm1yRSsvaGVtOWd3ZnQ2VmVNdTdqV2NRVjJqQ1RDWmJCU1gxeGRsRTZWMVY3WmNGcENYTk1RPT0ifX0BADTtF4JW4WWZVrUqxmaofJDVsxjpw509k_eqB28Zp8v4VUAkOBZ6bsN4WDOKYKWUlE2h1HQbm_YuSncTNONSeKxmLAH-4ywoMgJcDemwb6iXL9PgXy_5NxUbN14geaqN2T5CWPo9Sim6mjO3NLwostccYjkvNKpfY-KfU7fLd8sFA9Y1WZKsohUMB-Exn-zYbMQYL5_A7ue34jVhHTzmXXbM2fa-2Aak0mgUpC-fNtTXf-5_vgmVOLPLgflm1yJgXj-XfzM4iWogpBhoX6l40fcmReMXCwmtGeHWEISETDAO5kDUav10EwGuMKZs6prVfRq7v1WSGXygbv1Yr7oFcAizfGqKcuniO1p5-kAm6NzeIFEFhDV4rUeMrZ5HXhoKdH9FdJ94eQvp2hiNDTVQ4mBvzfz70Zj_cYJ-s-dG9gYEis_PheHGxN9GY8BnL9824lELZTsVjHYdTjb2gQ6siV7rcIXBXp9V_jAMYLDD-lMBCPbmkkI3EK1wGCWf3cTtg5BbESQedxYW-GO3TyKnhYe-wN0crCLog_eDxW3CH_CMhqUnKLMMp7GKPz-IAiLJROYjHaPhIz-ceyb6BKr9PDTxVELYhGSevUn7ffna86MLhqlTvUm-lzaVmfZzlZY07-RiLICS1mPODIq1mCvTFXWEODpnbqzRm3ZqPyEYwA-cnPgX7WyVoTnTxFtyMHzK_iyQ9jKTuTNvPZDvpKXyraIujN7xcC4NvJ3aJ8zssULFQNgqiC5cQ2opbFOhg0A7GLIBkXNwSVwD5BBfHHCsiV-mwjjqdujllzy-pR5BCvvV2FZ4PlVAgsxX8hCEQUNVpO5_gISSE_SeLuRWXlhdSRRI4dGFNWm7E75ZJzeOn_C5hZCuQjIdgS_a-O__5v2MqBQlKDUdtw54pXniUkZA4UhPXNgcGwVvdBDsybCJeM__akVDhDWrY6nqGOozHfrIUS1VR_Cdo4LP57DlSkPOwfb81MDBkYjzPu1HYNTLEUCcWiNtw0-YV7j4eDx_a5p6esNiIZInXK3DJGw2a4Na7e9FyRLWzSNPtd54Ys0qjcGYTVwJJvl4e6oE7bMPXKSptAieiO3jhCnDFROl4Wm3NX2a1IE4DZYfk1hRjhi47p9TgbZmBkw8_1y5runeAb4ZmOyO1jiOxQ6mQCBO-AQpooHnacNlQtghy05lRR5kqdJsDEcZZuSpp4nuQJT7fkBjmRObw1lOqnpyDBwrEFKQ_3ct12toPLKN6jfTdYU7naOY0xe9N_DuWrVlzWZDjvkuciLZ25P6VI4I4rrRbJuwVAk5RXBPV4RcXuH-8SZPluilQ6tfygLDEVQeF8ltlrRMxEmjoUN9GKkPjfmyZzselmkAAAcAAAAAAAAADAEAAAAAAAANkAQYQ29udGVudC1UeXBlIGFwcGxpY2F0aW9uL2pzb24WQXBwbGljYXRpb24YQ3liZXJDb25uZWN0FENvbnRlbnQtSWSAAWNkYmMzZmU2ZTNlODFjZmI0OGNmZmJlODNlYTQ4MGRkOTU3NzllMDEyNGYwMTBmNTEzODg3NTlkYThjZDk3ZDccQ29udGVudC1EaWdlc3SAAWNkYmMzZmU2ZTNlODFjZmI0OGNmZmJlODNlYTQ4MGRkOTU3NzllMDEyNGYwMTBmNTEzODg3NTlkYThjZDk3ZDccQ29udGVudC1BdXRob3IYbWg4bHZramwzYjU2DkNoYWluSWQENTYMU291cmNlCGF0ZW0AeyJjb250ZW50Ijoie1wib3BcIjpcInBvc3RcIixcImFkZHJlc3NcIjpcIjB4MDBmYjdiY2Y0MWU5Yjc0NTBlNDFlMmIwMmQxNTNjNTA4MzNhYjkzOFwiLFwidHNcIjoxNjkxNDYwNjIxODAwLFwiY2hhaW5JZFwiOjU2LFwiaGFuZGxlXCI6XCJtaDhsdmtqbDNiNTZcIixcInRpdGxlXCI6XCIxMTExMlwiLFwiYm9keVwiOlwiMjIyMjIyMjIyMjIyMjIyMjIyXCJ9IiwiZGlnZXN0IjoiY2RiYzNmZTZlM2U4MWNmYjQ4Y2ZmYmU4M2VhNDgwZGQ5NTc3OWUwMTI0ZjAxMGY1MTM4ODc1OWRhOGNkOTdkNyIsInNpZ25hdHVyZSI6IjB4YWNmNTVkNzk5N2Q0MWVmYWI1ZTQ3MGJkYTZkOGExNjc2M2FjZDEwNmRlOWIyM2JhNmEzZTAwMTUxMTBiMTEzOWVmMDYzZDBlODEwNmYxZjMwNWViMDJlYjVlMGVmZDVmMTY0M2VhMDg5Mjg2MWU1M2IzMjZkYmEzM2QzMTA4NzciLCJzaWduaW5nS2V5Ijp7InB1YmxpY0tleSI6Ik1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRU1vZExzTy85cHUraytOb1lCYS81bnZGQlF5c2JBV2NvVVVPWXZpNGJHMlo5S2I5SjQrZmgxUGZPWjZYNFVlWFBCZ2svYVl1Q0JKUzNNOFVBbDEvNy9RPT0iLCJmb3JtYXQiOiJTdWJqZWN0UHVibGljS2V5SW5mbyIsImFsZ29yaXRobSI6IkVTMjU2In0sInNpZ25pbmdLZXlBdXRoIjp7ImFkZHJlc3MiOiIweDAwZmI3YmNmNDFlOWI3NDUwZTQxZTJiMDJkMTUzYzUwODMzYWI5MzgiLCJzaWduaW5nS2V5U2lnbmF0dXJlIjoiMHg2MGE1MmI4YmY2YjRkYTYwY2JmNjA2ODcyYWZhNDMwZGNjNDgwZmE2ZjFhMmYxMjdhZDMyYTcxN2U4M2ExNzUxMjYwZDI4MTExNjRhNGUzYzdjZjFkMDBjMWQ3Y2ZiZGU3NzJkMjk5NWUyMjFhNjMwOGFjMjBmY2JjOTllZWYzMzFiIiwic2lnbmluZ0tleU1lc3NhZ2UiOiJJIGF1dGhvcml6ZSBBdGVtUmV2aWV3IGZyb20gdGhpcyBkZXZpY2UgdXNpbmcgc2lnbmluZyBrZXk6XG5NRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUVNb2RMc08vOXB1K2srTm9ZQmEvNW52RkJReXNiQVdjb1VVT1l2aTRiRzJaOUtiOUo0K2ZoMVBmT1o2WDRVZVhQQmdrL2FZdUNCSlMzTThVQWwxLzcvUT09In19AQAS019IaA08jnUGMaEWPqnIBInz8ezT5YHuP1DBkZM8J0Jv-O3zRAQffVzHViIwVwgtofT3B1GRI_8rkdQ_NZQj6JA31863_MK9j2xTgNS4tXWt-d9mnb2VFtpCUkyDvuoHbyEItE8L281jvg2ZfPxnmuYjj5gT6zK9MRNKMsPgziUJA61e1_nDdoWiyTiESG6_RltrKhdx0X0hJggEj_LkhJ9ZYECtsDBVhbWrZiAiacbX7UJ0a08aUNDTIKYcXP6X_Qq4Hf318_pHFvxxb7izNeAwbCLP8-AnZQNdV1_sI7J3iol5EHujHeSet9RvNGF9s4QjDlipeGP0p4dZo1TFXlil7_ptobS6MSIG3WU1rnkdK37kuCVZglBnEtPz67f4w3koxKBUTjP0JU8RLMi1o5G_R5vFooYHPTT7PCfXLBhmRzAQTbB7R4Z5_BkjA5FHY_NzLZ3I7CMeIDc_W4nmUcshsqK2K2m9ONwGLIqyvtMH-op2dhLZUrtwl0Sq-3mKBXaXOhiH7yQlN9pfOwut2nBc5wAYN_fYDSH9cM7uFhoiB3kVWPT0TKSWn_QzBAhFHc7rFodk2jdSB6u1BKqAVUDkaM6k4Hq04NzfUerPIUsKeYPFUGSdCsJxGbvpGP86R_H26_xRK42hv24S73SPavAmQBI3FWtfC3cWd7mkapz4F-1slaE508RbcjB8yv4skPYyk7kzbz2Q76Sl8q2iLoze8XAuDbyd2ifM7LFCxUDYKoguXENqKWxToYNAOxiyAZFzcElcA-QQXxxwrIlfpsI46nbo5Zc8vqUeQQr71dhWeD5VQILMV_IQhEFDVaTuf4CEkhP0ni7kVl5YXUkUSOHRhTVpuxO-WSc3jp_wuYWQrkIyHYEv2vjv_-b9jKgUJSg1HbcOeKV54lJGQOFIT1zYHBsFb3QQ7MmwiXjP_2pFQ4Q1q2Op6hjqMx36yFEtVUfwnaOCz-ew5UpDzsH2_NTAwZGI8z7tR2DUyxFAnFojbcNPmFe4-Hg8f2uaenrDYiGSJ1ytwyRsNmuDWu3vRckS1s0jT7XeeGLNKo3BmE1cCSb5eHuqBO2zD1ykqbQInojt44QpwxUTpeFptzV9mtSBOA2WH5NYUY4YuO6fU4G2ZgZMPP9cua7p3gG-GZjsjtY4jsUOpkAgTvgEKaKB52nDZULYIctOZUUeZKnSbAxHGWbkqaeJ7kCU-35AY5kTm8NZTqp6cgwcKxBSkP93LddraDyyjeo303WFO52jmNMXvTfw7lq1Zc1mQ475LnIi2duT-lSOCOK60WybsFQJOUVwT1eEXF7h_vEmT5bopUOrX8oCwxFUHhfJbZa0TMRJo6FDfRipD435smc7HpZpAAAHAAAAAAAAABYBAAAAAAAADaQEGENvbnRlbnQtVHlwZSBhcHBsaWNhdGlvbi9qc29uFkFwcGxpY2F0aW9uGEN5YmVyQ29ubmVjdBRDb250ZW50LUlkgAE5MjI3ZjBhNzMxMWRhNTg0NjU5NmQwMjlmOThlZmVhODcyMTRjN2U3ZjcwMmMzOWJhN2FhZDVmODMyYTE1NWRjHENvbnRlbnQtRGlnZXN0gAE5MjI3ZjBhNzMxMWRhNTg0NjU5NmQwMjlmOThlZmVhODcyMTRjN2U3ZjcwMmMzOWJhN2FhZDVmODMyYTE1NWRjHENvbnRlbnQtQXV0aG9yImxtaWtycGhna3VtZHFhZjU2DkNoYWluSWQENTYMU291cmNlEmN5YmVydHVuZQB7ImNvbnRlbnQiOiJ7XCJvcFwiOlwicG9zdFwiLFwiYWRkcmVzc1wiOlwiMHhhNDQyMDg5YmM5YWM2NjEyOThkZmQ2ZWY3ZTQ1ZjExMWI2ZWQ3ODBiXCIsXCJ0c1wiOjE2OTE0NjA2MjI2NzcsXCJjaGFpbklkXCI6NTYsXCJoYW5kbGVcIjpcImxtaWtycGhna3VtZHFhZjU2XCIsXCJ0aXRsZVwiOlwiVGhlIEN1cnNlIG9mIHRoZSBNdW1teSdzIFRvbWJcIixcImJvZHlcIjpcIk5pY2VcIn0iLCJkaWdlc3QiOiI5MjI3ZjBhNzMxMWRhNTg0NjU5NmQwMjlmOThlZmVhODcyMTRjN2U3ZjcwMmMzOWJhN2FhZDVmODMyYTE1NWRjIiwic2lnbmF0dXJlIjoiMHhmNGE3OGJlOTkyODViOWNmNDAxZTQ4YTg3ODAzZTgzNmYxZWVkZjE3MTFjNzhkNTZkN2Y2Mjg1NjEyNTZhNTM3NmYxZDg3MjhlOTdiYmJmMzY4ZmJkYjU1OTY5ZDNmYmM2ZTlhZGJhNTA5YmM2YWEwNTE3ZTdiZDRjMzViZTE2YyIsInNpZ25pbmdLZXkiOnsicHVibGljS2V5IjoiTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFL2FvTnR1N3RyOGd6YnlJaEFHcEJSUUlIRHhPL0pSSGpzWWxON1R4NDRiWmhrekpSZGRJLzhRUW0vY3Z5eU5rOTJoTlhEUXNTRGJsckF6dUxLTEhRdlE9PSIsImZvcm1hdCI6IlN1YmplY3RQdWJsaWNLZXlJbmZvIiwiYWxnb3JpdGhtIjoiRVMyNTYifSwic2lnbmluZ0tleUF1dGgiOnsiYWRkcmVzcyI6IjB4YTQ0MjA4OWJjOWFjNjYxMjk4ZGZkNmVmN2U0NWYxMTFiNmVkNzgwYiIsInNpZ25pbmdLZXlTaWduYXR1cmUiOiIweDY4ZDRhNzYyMjA4Y2RhYTQxZmI3NmQ5YWU5ZjJmZmYyNzBhMzJjZjExZTE4YjA2OWI5NWQ5ZWQ5MzVkYmVjYzY1NDY5M2VlZmIyODFhNTg0YmYwZDk5ODRhMWQwN2FhOGY3YWRhNmU4MmQ2NzFkOWRkNmYwOGIyN2IyMWNjNmI1MWMiLCJzaWduaW5nS2V5TWVzc2FnZSI6IkkgYXV0aG9yaXplIEkgYXV0aG9yaXplIEN5YmVyVHVuZS54eXogZnJvbSB0aGlzIGRldmljZSB1c2luZyBzaWduaW5nIGtleTpcbk1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRS9hb050dTd0cjhnemJ5SWhBR3BCUlFJSER4Ty9KUkhqc1lsTjdUeDQ0Ylpoa3pKUmRkSS84UVFtL2N2eXlOazkyaE5YRFFzU0RibHJBenVMS0xIUXZRPT0ifX0BAJShKIe12HCpdswlJ8x2C6x-jmn4qjA6ERYc_ZfgXFhWKatqzqTjPJVJ85Zsegv3HNROp3PqP3TdftTSJkJmYn5HzTkc8S_Wpt68bU0gmT70WL1cXsVXvFSnVli-9lxk5AGIYVgOslicRAwAOQ3A1SKvL70Lx0qbKWeROPp16a3hRkzmaHjWpRRYI7qDqVsT4WEMtLUfoorvby5Llmz-cqHRgBCDhyzYiSTB2Sbh81i77sl058RdXsRtT6V-9OqfsqXqvu8Hx78LEEgSL1UBk51nh51lCP0I90q7zJezP_8Y6xarfQ53wDrX_MpLhyQ3QDoPxBHM1NUnwUKmUe96hlON7IvkI-kxYlY83BzNJED4T1IZx0QXFQGE6nxS173NzGmy33qT9EoEqoysvhXiVRe9FB1gL7V71VvpAXeXylE2mbrajrwhdi_vAc0IrYJSut5-BmFWBxBdtlwYN0oJPSntRi7T9NhHazKTbROdvpdUQTrc2Hw2yarkR-eg_a_9GnRp5kwtz-SusYRmKhJm636fk6qNcsj0Ep6DEeqNflqu1HjB3iVMriV-mBo2k0L9YA2UhS-41tCqIOlAGso_JzYVWrNTtAPUl-Z50txbQjx_ur1xHwgqhliMW42iFRl6OK-i9Y0L8bjp5YXR3EyS8UmzngA8P_G2_seLYiVwxt68nPgX7WyVoTnTxFtyMHzK_iyQ9jKTuTNvPZDvpKXyraIujN7xcC4NvJ3aJ8zssULFQNgqiC5cQ2opbFOhg0A7GLIBkXNwSVwD5BBfHHCsiV-mwjjqdujllzy-pR5BCvvV2FZ4PlVAgsxX8hCEQUNVpO5_gISSE_SeLuRWXlhdSRRI4dGFNWm7E75ZJzeOn_C5hZCuQjIdgS_a-O__5v2MqBQlKDUdtw54pXniUkZA4UhPXNgcGwVvdBDsybCJeM__akVDhDWrY6nqGOozHfrIUS1VR_Cdo4LP57DlSkPOwfb81MDBkYjzPu1HYNTLEUCcWiNtw0-YV7j4eDx_a5p6esNiIZInXK3DJGw2a4Na7e9FyRLWzSNPtd54Ys0qjcGYTVwJJvl4e6oE7bMPXKSptAieiO3jhCnDFROl4Wm3NX2a1IE4DZYfk1hRjhi47p9TgbZmBkw8_1y5runeAb4ZmOyO1jiOxQ6mQCBO-AQpooHnacNlQtghy05lRR5kqdJsDEcZZuSpp4nuQJT7fkBjmRObw1lOqnpyDBwrEFKQ_3ct12toPLKN6jfTdYU7naOY0xe9N_DuWrVlzWZDjvkuciLZ25P6VI4I4rrRbJuwVAk5RXBPV4RcXuH-8SZPluilQ6tfygLDEVQeF8ltlrRMxEmjoUN9GKkPjfmyZzselmkAAAgAAAAAAAAAfgEAAAAAAAAP9AUYQ29udGVudC1UeXBlIGFwcGxpY2F0aW9uL2pzb24WQXBwbGljYXRpb24YQ3liZXJDb25uZWN0FENvbnRlbnQtSWSAAWZlMjc4Y2MyMzkyNGM0M2NlMDIwYmUwOGViZmQ4OGEyOTIyMGQ2MjRhZDQzMTBlNTk2YmQ1Yjg3MDYxNmQyMTccQ29udGVudC1EaWdlc3SAAWZlMjc4Y2MyMzkyNGM0M2NlMDIwYmUwOGViZmQ4OGEyOTIyMGQ2MjRhZDQzMTBlNTk2YmQ1Yjg3MDYxNmQyMTccQ29udGVudC1BdXRob3IaOTI1Njc0MjYyNzI3MQ5DaGFpbklkBDU2HENvbnRlbnQtVGFyZ2V0gAEzOWYwMjE4ODFlNzM4NmY4ZDczZDZlZjI1NTMzZTYwOTFmMmEwMjU2ZTQyMmI0YjNjNGUzZDMzNWNjYWUxNDdlDFNvdXJjZUgxNTUzMWZhMi0xMjA1LTRmNjEtYjZlNC1jOWY2OGVjZjgxZjcAeyJjb250ZW50Ijoie1wib3BcIjpcImNvbW1lbnRcIixcImFkZHJlc3NcIjpcIjB4ZTNhZmZmNWZlYjBmYTdlNmUzMmY5NGQxZjcwMzE1M2U4NDAzMGNjNlwiLFwidHNcIjoxNjkxNDYwNjIyNjQ3LFwiY2hhaW5JZFwiOjU2LFwiaGFuZGxlXCI6XCI5MjU2NzQyNjI3MjcxXCIsXCJ0YXJnZXRcIjpcIjM5ZjAyMTg4MWU3Mzg2ZjhkNzNkNmVmMjU1MzNlNjA5MWYyYTAyNTZlNDIyYjRiM2M0ZTNkMzM1Y2NhZTE0N2VcIixcInRpdGxlXCI6XCJGbGFwcHlNb29uYmlyZFwiLFwiYm9keVwiOlwiU28gZnVuIHRvIHBsYXkgaW4gbXkgc3BhcmUgdGltZS5cIn0iLCJkaWdlc3QiOiJmZTI3OGNjMjM5MjRjNDNjZTAyMGJlMDhlYmZkODhhMjkyMjBkNjI0YWQ0MzEwZTU5NmJkNWI4NzA2MTZkMjE3Iiwic2lnbmF0dXJlIjoiMHg0ZThhMWIxZmFlYjNkMjJhNDQzNGY2NTExYTBhYzc4Y2RjZWQ0MDgyNGFiYWI0NmNmYjNhNzI2MjU5ZTZhNmQyNTZiNWQzMTdjNzNmN2NlYTIxZjNmZTljYTc3NWM0YzZlYzVhMTczZmQ1NjQ2MjJjNGFjZWNmNDZkZjNkZjJlOCIsInNpZ25pbmdLZXkiOnsicHVibGljS2V5IjoiTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFM3NQYWhoVHZMRHljYWZVRlg1TmYxSmEyK1lVK3VwUitsTlg2NTlrSmlQQk81bURrVmtKWXowYUpLRlVPemdxV1p6T1RtbE1yYXdpQ25JcHJCWlQralE9PSIsImZvcm1hdCI6IlN1YmplY3RQdWJsaWNLZXlJbmZvIiwiYWxnb3JpdGhtIjoiRVMyNTYifSwic2lnbmluZ0tleUF1dGgiOnsiYWRkcmVzcyI6IjB4ZTNhZmZmNWZlYjBmYTdlNmUzMmY5NGQxZjcwMzE1M2U4NDAzMGNjNiIsInNpZ25pbmdLZXlTaWduYXR1cmUiOiIweGJlNTc5NTI5Y2E4YTIwZmNkZjYyZjE5YzYwZmVhOTBhYTkwZDY1NjM0ZDI1ZWEwYzI5YTU0MGZjZWEwNjUxYTU2OTFlZGJhYTQ4YjBlNmY4Y2JlODY3OGE3YmFjZWMxNWJiYjM5YTliNmNlNjUzZmUwY2U5YTgxZDgzM2U4ZGY2MWIiLCJzaWduaW5nS2V5TWVzc2FnZSI6IkkgYXV0aG9yaXplIEN5YmVyQ29ubmVjdCBmcm9tIHRoaXMgZGV2aWNlIHVzaW5nIHNpZ25pbmcga2V5OlxuTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFM3NQYWhoVHZMRHljYWZVRlg1TmYxSmEyK1lVK3VwUitsTlg2NTlrSmlQQk81bURrVmtKWXowYUpLRlVPemdxV1p6T1RtbE1yYXdpQ25JcHJCWlQralE9PSJ9fQEAe9bg9ajoqevO6M42KlapmJo6YgLsz9UZW-0u14ox1yBDXilX_BRf8SHn3bAnfYDYkCxQKQQA1fdd10N9n2Ah3sGrDsgvBwF-l183gsjUjZPrJgsHcY1OQGsVMayD6RDcIksmgUCyMgUa5Cqj-4cxIk7Gmuj-q8aDZFcGL_2yycCUnLOPxxTf5oz-3bf2gY1ZknI_zxU_IS3CupycIrF0hO2ZhPZ2yyvsVFsNsXYQHY_vEJ38VHgSpJF6b-imUulHsVrDiFCOiTwGxFW1tlq6P7L56bzHY30ZrB1BXTYMzElHj1KddVFr_PxUwDP5BjhOzRyFXfGpvmm5K95CCEFofDXgsy51o4gAb4S6pnL7LcnbJFd7xSmSn1nyVnKykXB3XZXPHN1VPE9Wu8dg4ErltmQCyCeGcrVZ9ff2r0WB3gKRaHCfOwjtCPYYkjjHfJb8oGfnGqdzIt2ff-0YSSpgztmkTvWQpa9KqbZ9uDKxLqaSTjuR5XT1y8Rv5Yei6JbnXZdtCpJ0WQSGFb7dckM01ALxpAKSAdTkzyNvZQ-5YiginfUBWkEdwgXEZ_xvoTxhZ9Xf3Q7endl8G38JuZuweFQVUc6zEbnGNFshLNbIhK4tvmJi1KUI2hBwpTAOqK1f3BTbfoa-_XdXUu05UQATqGcW-0TGJeTX7WWcGeBBF5-c-BftbJWhOdPEW3IwfMr-LJD2MpO5M289kO-kpfKtoi6M3vFwLg28ndonzOyxQsVA2CqILlxDailsU6GDQDsYsgGRc3BJXAPkEF8ccKyJX6bCOOp26OWXPL6lHkEK-9XYVng-VUCCzFfyEIRBQ1Wk7n-AhJIT9J4u5FZeWF1JFEjh0YU1absTvlknN46f8LmFkK5CMh2BL9r47__m_YyoFCUoNR23DnileeJSRkDhSE9c2BwbBW90EOzJsIl4z_9qRUOENatjqeoY6jMd-shRLVVH8J2jgs_nsOVKQ87B9vzUwMGRiPM-7Udg1MsRQJxaI23DT5hXuPh4PH9rmnp6w2IhkidcrcMkbDZrg1rt70XJEtbNI0-13nhizSqNwZhNXAkm-Xh7qgTtsw9cpKm0CJ6I7eOEKcMVE6Xhabc1fZrUgTgNlh-TWFGOGLjun1OBtmYGTDz_XLmu6d4BvhmY7I7WOI7FDqZAIE74BCmigedpw2VC2CHLTmVFHmSp0mwMRxlm5Kmnie5AlPt-QGOZE5vDWU6qenIMHCsQUpD_dy3Xa2g8so3qN9N1hTudo5jTF7038O5atWXNZkOO-S5yItnbk_pUjgjiutFsm7BUCTlFcE9XhFxe4f7xJk-W6KVDq1_KAsMRVB4XyW2WtEzESaOhQ30YqQ-N-bJnOx6WaQAABwAAAAAAAAAMAQAAAAAAAA2QBBhDb250ZW50LVR5cGUgYXBwbGljYXRpb24vanNvbhZBcHBsaWNhdGlvbhhDeWJlckNvbm5lY3QUQ29udGVudC1JZIABNTU2ZWU3MmZjY2Y5ZjRhY2ZiNjBkNWZhYjFkNDIxMzMzZTk3N2FhNGRkNzg0OTgyYmJiZmIwZjUwYTA5Y2Y4YRxDb250ZW50LURpZ2VzdIABNTU2ZWU3MmZjY2Y5ZjRhY2ZiNjBkNWZhYjFkNDIxMzMzZTk3N2FhNGRkNzg0OTgyYmJiZmIwZjUwYTA5Y2Y4YRxDb250ZW50LUF1dGhvchhqdnBubWF6ZTFweGEOQ2hhaW5JZAQ1NgxTb3VyY2UIYXRlbQB7ImNvbnRlbnQiOiJ7XCJvcFwiOlwicG9zdFwiLFwiYWRkcmVzc1wiOlwiMHg1ZTliMTQ2OGIyMmFkNWM4OTM5YmRmOTJhNzI0Y2ZhZGY4NGFhOTJkXCIsXCJ0c1wiOjE2OTE0NjA2MjE2MjksXCJjaGFpbklkXCI6NTYsXCJoYW5kbGVcIjpcImp2cG5tYXplMXB4YVwiLFwidGl0bGVcIjpcIjExMTEyXCIsXCJib2R5XCI6XCIyMjIyMjIyMjIyMjIyMjIyMjJcIn0iLCJkaWdlc3QiOiI1NTZlZTcyZmNjZjlmNGFjZmI2MGQ1ZmFiMWQ0MjEzMzNlOTc3YWE0ZGQ3ODQ5ODJiYmJmYjBmNTBhMDljZjhhIiwic2lnbmF0dXJlIjoiMHgxZGE2MzBiNWQ0MThmOGJiYjIyNmQ2ZWU0Y2MwYjNiMjU0MWNiY2RkMzY0ZGI5NTNlMTdiZDk1YzA5NDQ3YTlmZjE1Y2JlMDIyYTFjOGQxYTFjMjI4ZTVjMWExYWIzYTRlZWE4MGIyYjdjNThkZGEyNzBjYjMyZjNkZTg1YWU4NCIsInNpZ25pbmdLZXkiOnsicHVibGljS2V5IjoiTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFaTU2NzhKRURnMjAzblFpSGZMaHdxS1lGeDNzQWFWMWo1cks2d0JROHR0RHBEdHMvRXBGTEVaMHEyVnVjakZaZGhXSm1wUnMrUXFZekg1eldLa0Y5bFE9PSIsImZvcm1hdCI6IlN1YmplY3RQdWJsaWNLZXlJbmZvIiwiYWxnb3JpdGhtIjoiRVMyNTYifSwic2lnbmluZ0tleUF1dGgiOnsiYWRkcmVzcyI6IjB4NWU5YjE0NjhiMjJhZDVjODkzOWJkZjkyYTcyNGNmYWRmODRhYTkyZCIsInNpZ25pbmdLZXlTaWduYXR1cmUiOiIweGIyM2YzN2E3NmY1NTI0NDhhMDU1ZDk5MGVhNTIzOTJhNzZhZjI4YzAyYTM3ZTgyMTdlNzhiMjlmOWM4MzljN2I2Njg4M2EwYjM1ZTE1OTA3OTVjMWQwYzYwMjliZGMzZTI1MjAxODZiNzUzNTFjMGM4ZjE0YmEwNzU2YzI0OTM5MWMiLCJzaWduaW5nS2V5TWVzc2FnZSI6IkkgYXV0aG9yaXplIEF0ZW1SZXZpZXcgZnJvbSB0aGlzIGRldmljZSB1c2luZyBzaWduaW5nIGtleTpcbk1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRWk1Njc4SkVEZzIwM25RaUhmTGh3cUtZRngzc0FhVjFqNXJLNndCUTh0dERwRHRzL0VwRkxFWjBxMlZ1Y2pGWmRoV0ptcFJzK1FxWXpINXpXS2tGOWxRPT0ifX0BAGdu_ZMjMN1CsUnrEw5wAn_z_p5nGwk_e45Ey2UzOfxjVzeeEV2A2o0-Mrz9YEgQiNbcBOrsTylnYgVCuMvSzMG8A0EK04eLhkqkgIoZc5FloN6Gk0SFLax9ZOyaQkZ3cvESmPjwYdDtiFMEBU3Umtl3eRfC0YJCNqhPxJxvntwDq9LcMC-1nFkHx7L9Gd_yaImcLurMoxPtJO028Oq_iTRRqs_bgxRFq0qL2lKCPmDud5WpKgD0hbnWUqONca2lINGOOoQvZ1su6P0eeC_I8jbPCrq8IXN3_rstaiygMHpsimhp4RAk5_41j0KhzLSN3g1xs0dQlHq-ZZ5N0mzpOc4Bhbv-51E88EymkTBomXG_R9fmdwITbfk1GtLXUtc3CBtMYghQ29UmdafdO7RMFXxB4O5TN7xkaPaovJwBG23sSZLRV2arTacyzrLqywUKWOmK-mb4rTjZqZ3v_1zbqsf1JZ5hXG7md1Muzbcvw1eYxiiPNQBiFlWhP9ZBtcVO8k-WH0jqMHi4Xa6GGT98cTI-XxgB4uoiVRn-HCR_uDfc9j1hJLyhNiV08iNs9OsvE_6K67mnrKVnJM8LmW5CEa9RGYNEQbUbxTn1Hoe2GzbZrUh1A9bUAHPycVN6-MdQOhArGOtRV-circ0Z6ooqyaOZfM-Op2D8Vu9R2dT3FyC3nPgX7WyVoTnTxFtyMHzK_iyQ9jKTuTNvPZDvpKXyraIujN7xcC4NvJ3aJ8zssULFQNgqiC5cQ2opbFOhg0A7GLIBkXNwSVwD5BBfHHCsiV-mwjjqdujllzy-pR5BCvvV2FZ4PlVAgsxX8hCEQUNVpO5_gISSE_SeLuRWXlhdSRRI4dGFNWm7E75ZJzeOn_C5hZCuQjIdgS_a-O__5v2MqBQlKDUdtw54pXniUkZA4UhPXNgcGwVvdBDsybCJeM__akVDhDWrY6nqGOozHfrIUS1VR_Cdo4LP57DlSkPOwfb81MDBkYjzPu1HYNTLEUCcWiNtw0-YV7j4eDx_a5p6esNiIZInXK3DJGw2a4Na7e9FyRLWzSNPtd54Ys0qjcGYTVwJJvl4e6oE7bMPXKSptAieiO3jhCnDFROl4Wm3NX2a1IE4DZYfk1hRjhi47p9TgbZmBkw8_1y5runeAb4ZmOyO1jiOxQ6mQCBO-AQpooHnacNlQtghy05lRR5kqdJsDEcZZuSpp4nuQJT7fkBjmRObw1lOqnpyDBwrEFKQ_3ct12toPLKN6jfTdYU7naOY0xe9N_DuWrVlzWZDjvkuciLZ25P6VI4I4rrRbJuwVAk5RXBPV4RcXuH-8SZPluilQ6tfygLDEVQeF8ltlrRMxEmjoUN9GKkPjfmyZzselmkAAAgAAAAAAAAAfQEAAAAAAAAP8gUYQ29udGVudC1UeXBlIGFwcGxpY2F0aW9uL2pzb24WQXBwbGljYXRpb24YQ3liZXJDb25uZWN0FENvbnRlbnQtSWSAATIwMmVjMTQ4ZDE3NWRjMTZmYWM4MTAxNzIyNzE2MjI5MmU5NTVjOGUzYTE0NmFhNTkzOGJjMmQ5MGZlYTE4ZGEcQ29udGVudC1EaWdlc3SAATIwMmVjMTQ4ZDE3NWRjMTZmYWM4MTAxNzIyNzE2MjI5MmU5NTVjOGUzYTE0NmFhNTkzOGJjMmQ5MGZlYTE4ZGEcQ29udGVudC1BdXRob3IYem53eHczNjF3eW1wDkNoYWluSWQENTYcQ29udGVudC1UYXJnZXSAATM5ZjAyMTg4MWU3Mzg2ZjhkNzNkNmVmMjU1MzNlNjA5MWYyYTAyNTZlNDIyYjRiM2M0ZTNkMzM1Y2NhZTE0N2UMU291cmNlSDE1NTMxZmEyLTEyMDUtNGY2MS1iNmU0LWM5ZjY4ZWNmODFmNwB7ImNvbnRlbnQiOiJ7XCJvcFwiOlwiY29tbWVudFwiLFwiYWRkcmVzc1wiOlwiMHhlMTVmYzUxMTYwZDI1YTYyMzQyZTdlZTdkNGVjMGExMDdlZDBmNWU0XCIsXCJ0c1wiOjE2OTE0NjA2MjI1NTMsXCJjaGFpbklkXCI6NTYsXCJoYW5kbGVcIjpcInpud3h3MzYxd3ltcFwiLFwidGFyZ2V0XCI6XCIzOWYwMjE4ODFlNzM4NmY4ZDczZDZlZjI1NTMzZTYwOTFmMmEwMjU2ZTQyMmI0YjNjNGUzZDMzNWNjYWUxNDdlXCIsXCJ0aXRsZVwiOlwiRmxhcHB5TW9vbmJpcmRcIixcImJvZHlcIjpcIlNvIGZ1biB0byBwbGF5IGluIG15IHNwYXJlIHRpbWUuXCJ9IiwiZGlnZXN0IjoiMjAyZWMxNDhkMTc1ZGMxNmZhYzgxMDE3MjI3MTYyMjkyZTk1NWM4ZTNhMTQ2YWE1OTM4YmMyZDkwZmVhMThkYSIsInNpZ25hdHVyZSI6IjB4MDViYTI0NDhmZGU3ZWYyZGIxZjlmN2NiMDczNzc0MmY1ZTU4N2M2M2Y3MDY4NWQyYTdkMjIwZjMwZmVjMGVmN2VmMjg2Y2RmZDQzM2FiZTc0YmY1ZjliNDY0NDNlYzFhNzY5NjkzZGQ4MTJlMGYyOGMxOGFiY2QxYTRmNGJlOGYiLCJzaWduaW5nS2V5Ijp7InB1YmxpY0tleSI6Ik1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRXora0h6MHNYTTY0RHBlVGp0RXpvSE9KU2xqLzZoaFIrYWN2RUpVSlBZYXRyWTI1V0Q3c1BFdS9CcVdlUGt2dzY2MVVyUXNtMCt5QVFmOStxMm04Q21BPT0iLCJmb3JtYXQiOiJTdWJqZWN0UHVibGljS2V5SW5mbyIsImFsZ29yaXRobSI6IkVTMjU2In0sInNpZ25pbmdLZXlBdXRoIjp7ImFkZHJlc3MiOiIweGUxNWZjNTExNjBkMjVhNjIzNDJlN2VlN2Q0ZWMwYTEwN2VkMGY1ZTQiLCJzaWduaW5nS2V5U2lnbmF0dXJlIjoiMHg5ZDU3ZTU1ZTRiNTkzOGY5MGZjZTQ1NTZiMjk0OTRiNGY3OTFmOWE0NTgwMWFhMmE0YWUyMzMwZmMwN2ZkMTE1MWE4OGI3NGU2M2VlYmQ4Yjg5YTJhNmZjZDgwYjUwNDg0ZDg3NTFjMzg2MmZiMzg2ZTQwNjc1NTgzYTg0MjZkMTFiIiwic2lnbmluZ0tleU1lc3NhZ2UiOiJJIGF1dGhvcml6ZSBDeWJlckNvbm5lY3QgZnJvbSB0aGlzIGRldmljZSB1c2luZyBzaWduaW5nIGtleTpcbk1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRXora0h6MHNYTTY0RHBlVGp0RXpvSE9KU2xqLzZoaFIrYWN2RUpVSlBZYXRyWTI1V0Q3c1BFdS9CcVdlUGt2dzY2MVVyUXNtMCt5QVFmOStxMm04Q21BPT0ifX0BAAoNZJHqp-S-A_KX1CG2pOpRziJVbm8dQUbdBc0R_-RuKIaG1be4zziK5UFPxLdXVSlvv0CBRTePnsb8uPPY4l_0Jitn6GJUfvnfpn02Kz7HxRYVYHee-UoYTgNFMddxn2FYC2baaM1PR6DX13GLaN57icBlmqlwmR0gsp_twIgTTBdyb3DD-BZvPxjIIv87G7Z2JMXPmXrAUwKzbB8Wah4kgnDEdZIU0Vmugt6mdROPQ17GKUb6kRiOd0b86ihJxBY6skaspHz8Y7jVcSUSB5tqUnVv-p7bE3FgXrKDU__iIHlJ6xni2gQbnJvfHPvYiDQcE0K8LsjUJ7VYiSoJKXsuiem2pQHAHsrtnISxoRoNYpQCEpAIIgTfVHpjkSGyK3uQHnrpCAt14eHAaR4WgHTHEMRbOWpksQoFa3cn2j5Y8dGSff2B0_aMzRnDKpRcNO4ctHVJsbYqBlPWyTrYmgyMIoF9GVww4lvdtRmhFhTuTexOPljRdIYUCe8TSstMcoicrWsbBG5RHifKztLFhMQA-tqCQQUQV2foscL7VKrpjRyc2Swirn7UnjGcgRkmk6kJRk_2Ff83_Nf8GJz_6qfeq3UT-jsX5G9u1yM9iSB6FhgsJ3mhtrFSbrURlIZ_-7DlmdGxjUtPsAGkD4IO7bgSv-EvzKNdHXBC90kbvEC1nPgX7WyVoTnTxFtyMHzK_iyQ9jKTuTNvPZDvpKXyraIujN7xcC4NvJ3aJ8zssULFQNgqiC5cQ2opbFOhg0A7GLIBkXNwSVwD5BBfHHCsiV-mwjjqdujllzy-pR5BCvvV2FZ4PlVAgsxX8hCEQUNVpO5_gISSE_SeLuRWXlhdSRRI4dGFNWm7E75ZJzeOn_C5hZCuQjIdgS_a-O__5v2MqBQlKDUdtw54pXniUkZA4UhPXNgcGwVvdBDsybCJeM__akVDhDWrY6nqGOozHfrIUS1VR_Cdo4LP57DlSkPOwfb81MDBkYjzPu1HYNTLEUCcWiNtw0-YV7j4eDx_a5p6esNiIZInXK3DJGw2a4Na7e9FyRLWzSNPtd54Ys0qjcGYTVwJJvl4e6oE7bMPXKSptAieiO3jhCnDFROl4Wm3NX2a1IE4DZYfk1hRjhi47p9TgbZmBkw8_1y5runeAb4ZmOyO1jiOxQ6mQCBO-AQpooHnacNlQtghy05lRR5kqdJsDEcZZuSpp4nuQJT7fkBjmRObw1lOqnpyDBwrEFKQ_3ct12toPLKN6jfTdYU7naOY0xe9N_DuWrVlzWZDjvkuciLZ25P6VI4I4rrRbJuwVAk5RXBPV4RcXuH-8SZPluilQ6tfygLDEVQeF8ltlrRMxEmjoUN9GKkPjfmyZzselmkAAAcAAAAAAAAAEgEAAAAAAAANnAQYQ29udGVudC1UeXBlIGFwcGxpY2F0aW9uL2pzb24WQXBwbGljYXRpb24YQ3liZXJDb25uZWN0HENvbnRlbnQtQXV0aG9yJGRvbm5pZWFubmV0dGVhbTRhNA5DaGFpbklkBDU2DFNvdXJjZQhhdGVtFENvbnRlbnQtSWSAAWIyYmI3MGM1OTI4ZDdlNjgzNzNkZGY4Mzc3Yzc4YmZlMzA1ZTg3YzRhOTE1NzNkOTMzNzFkYjE3OTU0YWFjMzkcQ29udGVudC1EaWdlc3SAAWIyYmI3MGM1OTI4ZDdlNjgzNzNkZGY4Mzc3Yzc4YmZlMzA1ZTg3YzRhOTE1NzNkOTMzNzFkYjE3OTU0YWFjMzkAeyJjb250ZW50Ijoie1wib3BcIjpcInBvc3RcIixcImFkZHJlc3NcIjpcIjB4NzMwOWU4NDU3Nzg3MWY4YThhMDZjNTI0ODg0ODZjYjhmY2ZhNjk4ZVwiLFwidHNcIjoxNjkxNDYwNjIyNjcxLFwiY2hhaW5JZFwiOjU2LFwiaGFuZGxlXCI6XCJkb25uaWVhbm5ldHRlYW00YTRcIixcInRpdGxlXCI6XCJUaGUgS2luZ2RvbSBvZiB0aGUgQ3J5c3RhbCBTa3VsbHNcIixcImJvZHlcIjpcIndvd1wifSIsImRpZ2VzdCI6ImIyYmI3MGM1OTI4ZDdlNjgzNzNkZGY4Mzc3Yzc4YmZlMzA1ZTg3YzRhOTE1NzNkOTMzNzFkYjE3OTU0YWFjMzkiLCJzaWduYXR1cmUiOiIweGVmOGVmODhlMjRhNjhlNTI1ODRmNjljNTg0OTUwNjNkODdiYmYwMzUwYzJjOWRhYzgyNzM0YjNkNzJmYzU1ZjY4ZmIyYjgzZDFmM2MzMmM4ZGI3YTg4ZWU2ZjExYmE4NGE2YmQ4OTRkMDEzYzdhNmYxZjkwZjg5ZGY5ZmU2ZWIyIiwic2lnbmluZ0tleSI6eyJwdWJsaWNLZXkiOiJNRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUVucnZZNDk0ZVk1NWFha1k5ZmNJZ3FVbm4xdlEzdFBVTGFhZlZoaStyWGRVQ0RLVHVEdmJ3blZlc2VLT3drdWh2Q3hQVi9yMWlCUlZkejRQWlgrNEhCdz09IiwiZm9ybWF0IjoiU3ViamVjdFB1YmxpY0tleUluZm8iLCJhbGdvcml0aG0iOiJFUzI1NiJ9LCJzaWduaW5nS2V5QXV0aCI6eyJhZGRyZXNzIjoiMHg3MzA5ZTg0NTc3ODcxZjhhOGEwNmM1MjQ4ODQ4NmNiOGZjZmE2OThlIiwic2lnbmluZ0tleVNpZ25hdHVyZSI6IjB4YTQyYmQ2OGFmZjYyNTFhYTI3NjU3YjkzMWI0ZmE1YzFhMTYzOTdkMTM1NmFiODRhYWVlZTRmNzcwODU4YzJmYjM4NWJhZmM5YTNjOWE3OTk1NTZiNTllN2QzNmY0NDE4ZDE3MTM5ZjBiNjY5MDlmNWRhOGJjOWQzODZhYTM1YjYxYyIsInNpZ25pbmdLZXlNZXNzYWdlIjoiSSBhdXRob3JpemUgQXRlbVJldmlldyBmcm9tIHRoaXMgZGV2aWNlIHVzaW5nIHNpZ25pbmcga2V5OlxuTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFbnJ2WTQ5NGVZNTVhYWtZOWZjSWdxVW5uMXZRM3RQVUxhYWZWaGkrclhkVUNES1R1RHZid25WZXNlS093a3VodkN4UFYvcjFpQlJWZHo0UFpYKzRIQnc9PSJ9fQEAUeNJebaG1qVcK0L8VKqXsJjn-sb13PqwXrQVCMqcbt2USjHh-EXNYMDzElaBcid56shkVQwpybcR3LTUAaVpjET-P387anS7iVCZZCo2BGz7NrI-3rZE1ctb7xzkb1BoKRSu1ds4_zWouWDBlS4JmRDYj7jnX73ZG5nfJgjGGODSVHJYXj0wA58vF-U6iqxzC6yc33I5ZHX0tbbE_HzcflBV6LPlqV9Cw6lY2VGSesYr4rkBBbIuRTYTzOoQnCAA9-EtNy7HcetCT4b-6pGAI-nV2dqpTlcFdJqCxXNb-piw5mPLzZmTZ6bLQjBzjkH0pE2b0hx8LtVzdVSxe34fUoYA_zie4WJ_oPsjm8uYfpn94KVTcAds5wIrgPoaf60eGOBiWKIOLjDwSy6Mlfrhd7JkH8Xp8rX4V9J0jZ8JBdwkRcPdeTAt9jLZgUHXiZt8I-5-V3HXSf22i9n_TJ1oFqJG6cHrycf1n_BzMQo3EqiODInJupybU865KjU0JrnqVEHAmWJ5ypuC_BQL0IIpr19zF62eyfCGBNPsq0EH8FR8VbMJLLdc9E-4vMeCV1RzDJ9UuPYbnVLz7XCp---zCKkux7uY4tlqlOvgh0enaW7FabvGCdIfIxW1s5XYlBkQggNHR9l6GioZRIGofEY69sqacB6anKrczRSYHsEYvb2c-BftbJWhOdPEW3IwfMr-LJD2MpO5M289kO-kpfKtoi6M3vFwLg28ndonzOyxQsVA2CqILlxDailsU6GDQDsYsgGRc3BJXAPkEF8ccKyJX6bCOOp26OWXPL6lHkEK-9XYVng-VUCCzFfyEIRBQ1Wk7n-AhJIT9J4u5FZeWF1JFEjh0YU1absTvlknN46f8LmFkK5CMh2BL9r47__m_YyoFCUoNR23DnileeJSRkDhSE9c2BwbBW90EOzJsIl4z_9qRUOENatjqeoY6jMd-shRLVVH8J2jgs_nsOVKQ87B9vzUwMGRiPM-7Udg1MsRQJxaI23DT5hXuPh4PH9rmnp6w2IhkidcrcMkbDZrg1rt70XJEtbNI0-13nhizSqNwZhNXAkm-Xh7qgTtsw9cpKm0CJ6I7eOEKcMVE6Xhabc1fZrUgTgNlh-TWFGOGLjun1OBtmYGTDz_XLmu6d4BvhmY7I7WOI7FDqZAIE74BCmigedpw2VC2CHLTmVFHmSp0mwMRxlm5Kmnie5AlPt-QGOZE5vDWU6qenIMHCsQUpD_dy3Xa2g8so3qN9N1hTudo5jTF7038O5atWXNZkOO-S5yItnbk_pUjgjiutFsm7BUCTlFcE9XhFxe4f7xJk-W6KVDq1_KAsMRVB4XyW2WtEzESaOhQ30YqQ-N-bJnOx6WaQAACAAAAAAAAAB9AQAAAAAAAA_yBRhDb250ZW50LVR5cGUgYXBwbGljYXRpb24vanNvbhZBcHBsaWNhdGlvbhhDeWJlckNvbm5lY3QUQ29udGVudC1JZIABMTY4YTY5Y2QxZGRjMmQ2YzJlM2RhZmU2N2ViYWU4ZDIyZWJkYjY2YmQxNDJjODI5YTI1OWZjMWYxM2JhMWQ4ORxDb250ZW50LURpZ2VzdIABMTY4YTY5Y2QxZGRjMmQ2YzJlM2RhZmU2N2ViYWU4ZDIyZWJkYjY2YmQxNDJjODI5YTI1OWZjMWYxM2JhMWQ4ORxDb250ZW50LUF1dGhvchg5Y2ExeWZteXdvMmMOQ2hhaW5JZAQ1NhxDb250ZW50LVRhcmdldIABMzlmMDIxODgxZTczODZmOGQ3M2Q2ZWYyNTUzM2U2MDkxZjJhMDI1NmU0MjJiNGIzYzRlM2QzMzVjY2FlMTQ3ZQxTb3VyY2VIMTU1MzFmYTItMTIwNS00ZjYxLWI2ZTQtYzlmNjhlY2Y4MWY3AHsiY29udGVudCI6IntcIm9wXCI6XCJjb21tZW50XCIsXCJhZGRyZXNzXCI6XCIweDc4M2FkMDE4ZmNjOTk5OTA5ZjQ1N2U1YjcwMDJhYzQ3YTliZWZjZWVcIixcInRzXCI6MTY5MTQ2MDYyMTkzOCxcImNoYWluSWRcIjo1NixcImhhbmRsZVwiOlwiOWNhMXlmbXl3bzJjXCIsXCJ0YXJnZXRcIjpcIjM5ZjAyMTg4MWU3Mzg2ZjhkNzNkNmVmMjU1MzNlNjA5MWYyYTAyNTZlNDIyYjRiM2M0ZTNkMzM1Y2NhZTE0N2VcIixcInRpdGxlXCI6XCJGbGFwcHlNb29uYmlyZFwiLFwiYm9keVwiOlwiU28gZnVuIHRvIHBsYXkgaW4gbXkgc3BhcmUgdGltZS5cIn0iLCJkaWdlc3QiOiIxNjhhNjljZDFkZGMyZDZjMmUzZGFmZTY3ZWJhZThkMjJlYmRiNjZiZDE0MmM4MjlhMjU5ZmMxZjEzYmExZDg5Iiwic2lnbmF0dXJlIjoiMHhmMTM3MmVlZjExZGZkNTM1NDY0ZDdkNGRlOWVmNTM5NDkwODlmNDc5MDg5MmZiMmU4MDdkNDk3NzhkMGNjNmFjN2Q2ZWNhNTA4ZTM5ODNlNDJjMWQ4ZWIzZjM3YWQ2NTFkZWJkZDUwMjA4Yjc1YTk2NDgwNTVjNDUzZDM0OTlhMyIsInNpZ25pbmdLZXkiOnsicHVibGljS2V5IjoiTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFQ3FGK2ZyNjFUWU1tSlZVR1VOcitNNHMrRjhRQjF3cGNJdXk0d2ZzWG5GL2lnUjlhQkZCR2xvM2ZIOWNodlRZY0dycEZLcVBzeXlmd1B1eVExM1l5dEE9PSIsImZvcm1hdCI6IlN1YmplY3RQdWJsaWNLZXlJbmZvIiwiYWxnb3JpdGhtIjoiRVMyNTYifSwic2lnbmluZ0tleUF1dGgiOnsiYWRkcmVzcyI6IjB4NzgzYWQwMThmY2M5OTk5MDlmNDU3ZTViNzAwMmFjNDdhOWJlZmNlZSIsInNpZ25pbmdLZXlTaWduYXR1cmUiOiIweDI0MWE5NDNjNjdjNjFlN2UzNzUwMTNiYTAzMmJmZDUwM2NlMTEwMTcxZDIzN2NiZDg0YzkyZTczYjU1ZmE0Zjg1ZDViYTdkMDhjYjJkNGUzMTdhODcxNmEzYmQ0MTAyMTJmMTgyM2ZmOGRmNDFkMDRmNWMyNzMwMzA3ZjU5YjZlMWMiLCJzaWduaW5nS2V5TWVzc2FnZSI6IkkgYXV0aG9yaXplIEN5YmVyQ29ubmVjdCBmcm9tIHRoaXMgZGV2aWNlIHVzaW5nIHNpZ25pbmcga2V5OlxuTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFQ3FGK2ZyNjFUWU1tSlZVR1VOcitNNHMrRjhRQjF3cGNJdXk0d2ZzWG5GL2lnUjlhQkZCR2xvM2ZIOWNodlRZY0dycEZLcVBzeXlmd1B1eVExM1l5dEE9PSJ9fQEAbg_RpuReM3kHXs9OJec3ZF_AzJnrQVa-i3S_Zi8ye0sVll1W6Z__h9nDo_ggIRrd4lz5sd6ER026qAbhlmO8CKkOB0EjYZnz_0_Mo9AO878kWjyarDW1jnU-ajTCGUkE7o_oHJIPe68YN4EkvRrLfhjfIsI0C98YgKZZvt3SkMV--oVcBgP2KHYykIlrMUE4YJ7JeeUy22MJ3pvRv_yE_fUaIq96FBmCiPUuw5WqCFCPn2VKjz47FV1Fh5jyzKBGFB-uYBKtxypeh8uAQ3yGdqjXOhNU4yHce8GhpfnCyf1JIP6h89A8aSic4VrU91z0jQbJpuerz8v4iqCgw6ITJe_qynvx9Zk26PQ98R8u42ZB3aSQBaJXfjhn5XXZKcHroHEJDXUsp0k82L9k8n7Y_CZVSwBb4_InVEizApziT9u89Y83VDtdasGfa0LU_1jiLQqSfYrnkLdt6ONuBgAhgtB8kc16uDtVeqqs_ebGMr1qAdVx7dFXMlJo3Bgv_-n9BNSqyhfRWhFUGLQaxtDgmORbpoDpeATeGhc56ImuOYPCpSrl-09DOadwLkUjbb0NqtSiYEt3m54cXZRP3VLr_DY439f_mSnyeM4rYyOfEURTwHtLw4P90p7Y80PqgXQIPsSRRuAAqIUimwrxasAI0dmOleliO9UHx6SixnM_vQSc-BftbJWhOdPEW3IwfMr-LJD2MpO5M289kO-kpfKtoi6M3vFwLg28ndonzOyxQsVA2CqILlxDailsU6GDQDsYsgGRc3BJXAPkEF8ccKyJX6bCOOp26OWXPL6lHkEK-9XYVng-VUCCzFfyEIRBQ1Wk7n-AhJIT9J4u5FZeWF1JFEjh0YU1absTvlknN46f8LmFkK5CMh2BL9r47__m_YyoFCUoNR23DnileeJSRkDhSE9c2BwbBW90EOzJsIl4z_9qRUOENatjqeoY6jMd-shRLVVH8J2jgs_nsOVKQ87B9vzUwMGRiPM-7Udg1MsRQJxaI23DT5hXuPh4PH9rmnp6w2IhkidcrcMkbDZrg1rt70XJEtbNI0-13nhizSqNwZhNXAkm-Xh7qgTtsw9cpKm0CJ6I7eOEKcMVE6Xhabc1fZrUgTgNlh-TWFGOGLjun1OBtmYGTDz_XLmu6d4BvhmY7I7WOI7FDqZAIE74BCmigedpw2VC2CHLTmVFHmSp0mwMRxlm5Kmnie5AlPt-QGOZE5vDWU6qenIMHCsQUpD_dy3Xa2g8so3qN9N1hTudo5jTF7038O5atWXNZkOO-S5yItnbk_pUjgjiutFsm7BUCTlFcE9XhFxe4f7xJk-W6KVDq1_KAsMRVB4XyW2WtEzESaOhQ30YqQ-N-bJnOx6WaQAACAAAAAAAAAB9AQAAAAAAAA_yBRhDb250ZW50LVR5cGUgYXBwbGljYXRpb24vanNvbhZBcHBsaWNhdGlvbhhDeWJlckNvbm5lY3QcQ29udGVudC1UYXJnZXSAATM5ZjAyMTg4MWU3Mzg2ZjhkNzNkNmVmMjU1MzNlNjA5MWYyYTAyNTZlNDIyYjRiM2M0ZTNkMzM1Y2NhZTE0N2UMU291cmNlSDE1NTMxZmEyLTEyMDUtNGY2MS1iNmU0LWM5ZjY4ZWNmODFmNxRDb250ZW50LUlkgAE2ZDViYjM1M2ZiOWYyN2NmY2E5YzVjOTZkMGJmNjE3MzQ2ODhjNmU3YzZmYmM5Njc1NjI3MGVkNTliNWRmMDk4HENvbnRlbnQtRGlnZXN0gAE2ZDViYjM1M2ZiOWYyN2NmY2E5YzVjOTZkMGJmNjE3MzQ2ODhjNmU3YzZmYmM5Njc1NjI3MGVkNTliNWRmMDk4HENvbnRlbnQtQXV0aG9yGDF3ZWI4OXJrMTUwMQ5DaGFpbklkBDU2AHsiY29udGVudCI6IntcIm9wXCI6XCJjb21tZW50XCIsXCJhZGRyZXNzXCI6XCIweDEzOGM2NzQ5NmM0YTE1ZDQ5NzAxMDNlODZjZTdiNGU4YThhZjZiOGVcIixcInRzXCI6MTY5MTQ2MDYyMjA3NCxcImNoYWluSWRcIjo1NixcImhhbmRsZVwiOlwiMXdlYjg5cmsxNTAxXCIsXCJ0YXJnZXRcIjpcIjM5ZjAyMTg4MWU3Mzg2ZjhkNzNkNmVmMjU1MzNlNjA5MWYyYTAyNTZlNDIyYjRiM2M0ZTNkMzM1Y2NhZTE0N2VcIixcInRpdGxlXCI6XCJGbGFwcHlNb29uYmlyZFwiLFwiYm9keVwiOlwiU28gZnVuIHRvIHBsYXkgaW4gbXkgc3BhcmUgdGltZS5cIn0iLCJkaWdlc3QiOiI2ZDViYjM1M2ZiOWYyN2NmY2E5YzVjOTZkMGJmNjE3MzQ2ODhjNmU3YzZmYmM5Njc1NjI3MGVkNTliNWRmMDk4Iiwic2lnbmF0dXJlIjoiMHg1MDdiZmE4YzIxZmVhN2U0Njc5OTExOGQwMjNmMTdlYmZhN2M2OTIwNjE0NjZjYWY3YTc0ZGNkZjE4YjQyMDEwMmY2YjVhZWY2NTI2YmYwYmNmYmUxNTg3ZjJiY2U1NzQxZGUzNzliOTg0NTUxNTQ0YTk4OTUwYjZiZjZiMTRiNyIsInNpZ25pbmdLZXkiOnsicHVibGljS2V5IjoiTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFbFJyMnNaUnpuVEZ4U3FHTlUvcERJU1dMWWdHV0NmcWw5ZkRpY3hKakFjOVRKN1hOcEEyS1pTSnNMQXN4YUFMcnRIeGFXc1pqZHFIRHhhRkMrRnJTa2c9PSIsImZvcm1hdCI6IlN1YmplY3RQdWJsaWNLZXlJbmZvIiwiYWxnb3JpdGhtIjoiRVMyNTYifSwic2lnbmluZ0tleUF1dGgiOnsiYWRkcmVzcyI6IjB4MTM4YzY3NDk2YzRhMTVkNDk3MDEwM2U4NmNlN2I0ZThhOGFmNmI4ZSIsInNpZ25pbmdLZXlTaWduYXR1cmUiOiIweDI5YjhiMGE5ZWQ4MDYyNzNkNTE5MWY1ODk2NzhhNDIzYzViYjNlMjMwMjAwNzAyNjY3ZjY1YWNlMjY3NmMzY2Y1ZjMwM2RiZGFiMDNkOGZlZTkwYWE0NjVkMTJiZjczYTgzYzBhNzRlYzUzYTkxZjBiNjc1NjEzMzBhMDk0ZDU2MWIiLCJzaWduaW5nS2V5TWVzc2FnZSI6IkkgYXV0aG9yaXplIEN5YmVyQ29ubmVjdCBmcm9tIHRoaXMgZGV2aWNlIHVzaW5nIHNpZ25pbmcga2V5OlxuTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFbFJyMnNaUnpuVEZ4U3FHTlUvcERJU1dMWWdHV0NmcWw5ZkRpY3hKakFjOVRKN1hOcEEyS1pTSnNMQXN4YUFMcnRIeGFXc1pqZHFIRHhhRkMrRnJTa2c9PSJ9fQEATJOezfk-TLwWsmTOLW3O4AfGIscO8aLPJP-KXpOk1F3p1tGiVSVbtn_1SnEu0t6C9ppsPiHi5uFDv2_g_EKBYqNr6npAFWRVWkXsUFMZPH8ZHE8ot6uIN83Mb-EHnm-YiZyGwEHZk97xpD79B3LMj1pqMsMIJ3QZcIuGlYtLS3t0GSkUExYu49OaspF2wxtxu0Z_Ey485hYdG2rHL7rzi26DyQHroPYREgyuColw5T9eSCR4YygvVpy9h5Qk3vxSPxx_wmZdWJQVMeRp2kKidyrkKaKwuY8fAnCFPiJy7w0tje9kmD8duWu3eZnQvXs7vkECCCOo4w19X0gc45MXKaWGz4FtlrQvk5x5nqCzzhGXTOwdtEC6i6MWM-SzBJrhMpOp8c06_39eDBIP3Rn8WCWCyGtR_N346IlLsCOLapqU6dNYgfHxrd1xYucQKoDBBVhHeikKwYXXM9xiJaaeQZjLi8tAeMtvX3ssEfPxRN4J4XS5DHTgQt9e1FlzHvhIgVHAghim0o6yLFecgrwDkGzmV6Gu0ea6c2mIrjPhXf4B1SjEI6HbS_SiqpLGsQgnlORwOpRZmLPzXSW4y5Gp8izF0TcpedTkZL3z4Xs53xZWkrR-uj6T89msjZU5CoHU6BVyzw4PiCyua0p4hSjZz_5uNIRhQIMRd54cW_FrMrSc-BftbJWhOdPEW3IwfMr-LJD2MpO5M289kO-kpfKtoi6M3vFwLg28ndonzOyxQsVA2CqILlxDailsU6GDQDsYsgGRc3BJXAPkEF8ccKyJX6bCOOp26OWXPL6lHkEK-9XYVng-VUCCzFfyEIRBQ1Wk7n-AhJIT9J4u5FZeWF1JFEjh0YU1absTvlknN46f8LmFkK5CMh2BL9r47__m_YyoFCUoNR23DnileeJSRkDhSE9c2BwbBW90EOzJsIl4z_9qRUOENatjqeoY6jMd-shRLVVH8J2jgs_nsOVKQ87B9vzUwMGRiPM-7Udg1MsRQJxaI23DT5hXuPh4PH9rmnp6w2IhkidcrcMkbDZrg1rt70XJEtbNI0-13nhizSqNwZhNXAkm-Xh7qgTtsw9cpKm0CJ6I7eOEKcMVE6Xhabc1fZrUgTgNlh-TWFGOGLjun1OBtmYGTDz_XLmu6d4BvhmY7I7WOI7FDqZAIE74BCmigedpw2VC2CHLTmVFHmSp0mwMRxlm5Kmnie5AlPt-QGOZE5vDWU6qenIMHCsQUpD_dy3Xa2g8so3qN9N1hTudo5jTF7038O5atWXNZkOO-S5yItnbk_pUjgjiutFsm7BUCTlFcE9XhFxe4f7xJk-W6KVDq1_KAsMRVB4XyW2WtEzESaOhQ30YqQ-N-bJnOx6WaQAACAAAAAAAAAB9AQAAAAAAAA_yBRhDb250ZW50LVR5cGUgYXBwbGljYXRpb24vanNvbhZBcHBsaWNhdGlvbhhDeWJlckNvbm5lY3QcQ29udGVudC1UYXJnZXSAATM5ZjAyMTg4MWU3Mzg2ZjhkNzNkNmVmMjU1MzNlNjA5MWYyYTAyNTZlNDIyYjRiM2M0ZTNkMzM1Y2NhZTE0N2UMU291cmNlSDE1NTMxZmEyLTEyMDUtNGY2MS1iNmU0LWM5ZjY4ZWNmODFmNxRDb250ZW50LUlkgAE1NzRkYjgwNDYzMzgzNzZiY2ZmMzAxNmQ1ZDVhZmEyOTRlYmMwMmFhZTg5ZjQyZTMzODkxODFkMDgzMDgzM2RmHENvbnRlbnQtRGlnZXN0gAE1NzRkYjgwNDYzMzgzNzZiY2ZmMzAxNmQ1ZDVhZmEyOTRlYmMwMmFhZTg5ZjQyZTMzODkxODFkMDgzMDgzM2RmHENvbnRlbnQtQXV0aG9yGHEya3RmY2Ria3Rzbw5DaGFpbklkBDU2AHsiY29udGVudCI6IntcIm9wXCI6XCJjb21tZW50XCIsXCJhZGRyZXNzXCI6XCIweDFkNDIyNjJmODQ3YWQyZWU0Y2M3NjIyZjQxZDBhMTlhMzZhMDZhMmNcIixcInRzXCI6MTY5MTQ2MDYyMTk2MyxcImNoYWluSWRcIjo1NixcImhhbmRsZVwiOlwicTJrdGZjZGJrdHNvXCIsXCJ0YXJnZXRcIjpcIjM5ZjAyMTg4MWU3Mzg2ZjhkNzNkNmVmMjU1MzNlNjA5MWYyYTAyNTZlNDIyYjRiM2M0ZTNkMzM1Y2NhZTE0N2VcIixcInRpdGxlXCI6XCJGbGFwcHlNb29uYmlyZFwiLFwiYm9keVwiOlwiU28gZnVuIHRvIHBsYXkgaW4gbXkgc3BhcmUgdGltZS5cIn0iLCJkaWdlc3QiOiI1NzRkYjgwNDYzMzgzNzZiY2ZmMzAxNmQ1ZDVhZmEyOTRlYmMwMmFhZTg5ZjQyZTMzODkxODFkMDgzMDgzM2RmIiwic2lnbmF0dXJlIjoiMHhiYjE0MGMzNjdiNWMwNzYxMjIwNmI2ZTYwZmU5NTczZWJmYjI2ZDQ5ZjYyMWRlOGY0ZWQ1ZTkxZDk5YzJkOGVmNDQ0NmQ2YTZiODc3N2EzZThjMTczYTc5YWZjNDM4ODA1MDVlMGEwZGVhOWU5MzhiNmM5ZDE4Nzc1NjkzNzBkZSIsInNpZ25pbmdLZXkiOnsicHVibGljS2V5IjoiTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFV09sUVFOOHQwbWc1Yzk3a2kzMlhpUHhQNGFBQjJXTEhOV2hEWHU3TEI3TytHbGNLUTh4OHhhcW1WTEIrZGdna2V1VXVOekRSOUNoZ0ZPdXVvL2hmMmc9PSIsImZvcm1hdCI6IlN1YmplY3RQdWJsaWNLZXlJbmZvIiwiYWxnb3JpdGhtIjoiRVMyNTYifSwic2lnbmluZ0tleUF1dGgiOnsiYWRkcmVzcyI6IjB4MWQ0MjI2MmY4NDdhZDJlZTRjYzc2MjJmNDFkMGExOWEzNmEwNmEyYyIsInNpZ25pbmdLZXlTaWduYXR1cmUiOiIweDhhNGUzMTNhYWVjNGJlODhkYmNmZjE5MDc2OGIzZGQ1ZjQ5MGE4NTQwMzhiY2NiNTMzMjUyM2UxMDQyZjVkNDE3NzNmM2VkNWUzMDI2MzIxN2Y2Y2RhNjdhOWZmZGE0NzQwODFmNDIwMDcwY2JjZTY4Mzg3MDY2MzEwOWFjNGU2MWMiLCJzaWduaW5nS2V5TWVzc2FnZSI6IkkgYXV0aG9yaXplIEN5YmVyQ29ubmVjdCBmcm9tIHRoaXMgZGV2aWNlIHVzaW5nIHNpZ25pbmcga2V5OlxuTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFV09sUVFOOHQwbWc1Yzk3a2kzMlhpUHhQNGFBQjJXTEhOV2hEWHU3TEI3TytHbGNLUTh4OHhhcW1WTEIrZGdna2V1VXVOekRSOUNoZ0ZPdXVvL2hmMmc9PSJ9fQEAacb7OWaowzb99-8IB-aoF51qqEWK7yc1VYcfivj6hVeuv8N9XENwr3eiXLakQAds_rJSs2GxoHOop1byvbQr_fbaGqudiXA0cM1Uh8xnXL1BTk_9AShQm_A45qVzcIuGE2fsebBmSJLe2KpttI1pVcbFKnaBJug4lXqctZqjluQ7m9y3dOqgvdvNb7WoXDuf4nWZC1MqKkbLp1mn42z_bmVloPzzcfzXEVnjM_iBFLccwGQQ7HBhigd_FQ8ZwfKyU--7dmWwm1S7x6jN5wnrSRHRBt_u87571dHrd53J3zSXv7-f9WlU6ViRYwOHXzs2h35Nm7JrOOalY94clyphRnSCqMl-9R2tkhjMmaAMdKHH32gckS3PEQybbJnSGqqrWU43VxXoLDGpQMVGkpwZaYoAB8w000YAzlMBCIa8Zjc9fN3MIoX-Tlbs-DLEN0PGlEGcsixF_4UmYs6Tf6IwDD4-t_vwrcw8Sa2N6mRjhIWZKxCSewbgquSCpQZNZrIPA0deaCsqkureHCLSrehYRm9xa7Afw8nYaGc7Yy9Np6CAD7Dut0SlOT9f0ARI39ZAgrrXecam9MeIVESvLFcfakCeNppvX0hh6xOHH7bmP2FHUkJtwT8pYNxYG_p2JPjQfKFwwlkgw6U7_cT205JKA3QsfbOFfC-NO3ubLMWnQIqc-BftbJWhOdPEW3IwfMr-LJD2MpO5M289kO-kpfKtoi6M3vFwLg28ndonzOyxQsVA2CqILlxDailsU6GDQDsYsgGRc3BJXAPkEF8ccKyJX6bCOOp26OWXPL6lHkEK-9XYVng-VUCCzFfyEIRBQ1Wk7n-AhJIT9J4u5FZeWF1JFEjh0YU1absTvlknN46f8LmFkK5CMh2BL9r47__m_YyoFCUoNR23DnileeJSRkDhSE9c2BwbBW90EOzJsIl4z_9qRUOENatjqeoY6jMd-shRLVVH8J2jgs_nsOVKQ87B9vzUwMGRiPM-7Udg1MsRQJxaI23DT5hXuPh4PH9rmnp6w2IhkidcrcMkbDZrg1rt70XJEtbNI0-13nhizSqNwZhNXAkm-Xh7qgTtsw9cpKm0CJ6I7eOEKcMVE6Xhabc1fZrUgTgNlh-TWFGOGLjun1OBtmYGTDz_XLmu6d4BvhmY7I7WOI7FDqZAIE74BCmigedpw2VC2CHLTmVFHmSp0mwMRxlm5Kmnie5AlPt-QGOZE5vDWU6qenIMHCsQUpD_dy3Xa2g8so3qN9N1hTudo5jTF7038O5atWXNZkOO-S5yItnbk_pUjgjiutFsm7BUCTlFcE9XhFxe4f7xJk-W6KVDq1_KAsMRVB4XyW2WtEzESaOhQ30YqQ-N-bJnOx6WaQAACAAAAAAAAAB9AQAAAAAAAA_yBRhDb250ZW50LVR5cGUgYXBwbGljYXRpb24vanNvbhZBcHBsaWNhdGlvbhhDeWJlckNvbm5lY3QUQ29udGVudC1JZIABZjM5NGYxZTRhYzMyOGVjMjJmZWVmMTEzNzM1MjljM2Y4ODVkYjc5MDM5YWIzYWQ4NzIxNGRjZTgxMTgyMzg3ZBxDb250ZW50LURpZ2VzdIABZjM5NGYxZTRhYzMyOGVjMjJmZWVmMTEzNzM1MjljM2Y4ODVkYjc5MDM5YWIzYWQ4NzIxNGRjZTgxMTgyMzg3ZBxDb250ZW50LUF1dGhvchg5N3NsNjd4a2R6Y3MOQ2hhaW5JZAQ1NhxDb250ZW50LVRhcmdldIABMzlmMDIxODgxZTczODZmOGQ3M2Q2ZWYyNTUzM2U2MDkxZjJhMDI1NmU0MjJiNGIzYzRlM2QzMzVjY2FlMTQ3ZQxTb3VyY2VIMTU1MzFmYTItMTIwNS00ZjYxLWI2ZTQtYzlmNjhlY2Y4MWY3AHsiY29udGVudCI6IntcIm9wXCI6XCJjb21tZW50XCIsXCJhZGRyZXNzXCI6XCIweGM3MGU1NTY3NTAxYTZkMzNiZTVmY2ExY2IwZTAwMWEyYzIyN2MzODdcIixcInRzXCI6MTY5MTQ2MDYyMjI5MCxcImNoYWluSWRcIjo1NixcImhhbmRsZVwiOlwiOTdzbDY3eGtkemNzXCIsXCJ0YXJnZXRcIjpcIjM5ZjAyMTg4MWU3Mzg2ZjhkNzNkNmVmMjU1MzNlNjA5MWYyYTAyNTZlNDIyYjRiM2M0ZTNkMzM1Y2NhZTE0N2VcIixcInRpdGxlXCI6XCJGbGFwcHlNb29uYmlyZFwiLFwiYm9keVwiOlwiU28gZnVuIHRvIHBsYXkgaW4gbXkgc3BhcmUgdGltZS5cIn0iLCJkaWdlc3QiOiJmMzk0ZjFlNGFjMzI4ZWMyMmZlZWYxMTM3MzUyOWMzZjg4NWRiNzkwMzlhYjNhZDg3MjE0ZGNlODExODIzODdkIiwic2lnbmF0dXJlIjoiMHhmZTlmZDFkZDM2YzI1YjI4MWRkYzk2NDhjMDU2ZmFiNzFkNTRiNmRhY2Y0NjhhMWNkZTc0OWU4NTZhYjZkY2QwMTAxNTNlODM0MDgyOWUzMzlhMTA0MmJmY2MyZGJlNjQ3YWY4OTIyMjZmOTRhMjZkNzg4NmNhM2QxNjA4NWQ4ZCIsInNpZ25pbmdLZXkiOnsicHVibGljS2V5IjoiTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFeGF2YkgwTXdmb3BFajFZTFpJNHVaM1kvbGg5b3l4enZSdDdmb0c2Wk9Tc2w1UU82NmN5R0tCaW85WCtmMzNSd2hVaHZXdTJtcWY5UUU5eHExdlpQZmc9PSIsImZvcm1hdCI6IlN1YmplY3RQdWJsaWNLZXlJbmZvIiwiYWxnb3JpdGhtIjoiRVMyNTYifSwic2lnbmluZ0tleUF1dGgiOnsiYWRkcmVzcyI6IjB4YzcwZTU1Njc1MDFhNmQzM2JlNWZjYTFjYjBlMDAxYTJjMjI3YzM4NyIsInNpZ25pbmdLZXlTaWduYXR1cmUiOiIweGViN2FhM2UwMzY2NjNlYjk5YWM0M2E4YTkzMTI0MmQxOThhMjc4MzFiZWVlMzQwNzNjMDMxN2M2YmI3Mzg1Y2M2NGJjMmZjNWQzMTBlODIzMjM3ZDg1YzM2ZDhiNzIxNTJkZTM5MzdjZjQzY2Q4MGJjN2NlYmY4MjQ3YWQ0MzdjMWIiLCJzaWduaW5nS2V5TWVzc2FnZSI6IkkgYXV0aG9yaXplIEN5YmVyQ29ubmVjdCBmcm9tIHRoaXMgZGV2aWNlIHVzaW5nIHNpZ25pbmcga2V5OlxuTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFeGF2YkgwTXdmb3BFajFZTFpJNHVaM1kvbGg5b3l4enZSdDdmb0c2Wk9Tc2w1UU82NmN5R0tCaW85WCtmMzNSd2hVaHZXdTJtcWY5UUU5eHExdlpQZmc9PSJ9fQEAVyX7qCIDiovus38Eg_CJYnbQUat1wD8hZ5HlD9ciZTObT0AnHcP4LDnwqSdosRmIC2OKVNEAW94cdJ9gF0Png-Q6Ieh6nL-3_rv3FZPQsxS_l7kvQ-QjG3tJqsAyqGWnxC2pORrfoAN84cmixrs9bZXmlQS9UTxHR8xnNdlgPkiF_TdRSd2bZr3n1XChb6XRQjjasVZ5fix3KEbYfj28nttaerPqWSY8jivgCMwDboe7bBMopqlP7MrAdlZ9W7eJXwRmv8jJlWVE4dGwCoeIreQ-pMTrRrW7SKDslkuK4nEW5wRqUb44pen2LMfwnqNnHZ8EaWRG4rU9oDCLv7IdXv5uTwKmCDb51fdVobidYRL1nAvLDrbeMhYQwqd0h_YH25IcHtw4PO4wmilFZtSJSLjFn96J_Canr2jRBHpK5nabkXNoJq3MlK9UbZQNMxo99HEkwLexeDr3GmKarv9meZQBE1PDhp6Zbsh7GfyVWCjNpWQUlviYrR-gV25h3QqjuzjZU1WTr8QWK0AcQw7dW8IgITQWtJSfjavLgT1LKxvjzOlM6-HAa4D6jgC-RuLenTXc-TkfJECk1QfW2G-nf29Xm-14zwKQ7Wuozk9flEdpvi7nfaTH52sVU0dQwiJTPR_RtxDkavm3r92FNktOfV02AcEAf9ttNAD8_MpSsFSc-BftbJWhOdPEW3IwfMr-LJD2MpO5M289kO-kpfKtoi6M3vFwLg28ndonzOyxQsVA2CqILlxDailsU6GDQDsYsgGRc3BJXAPkEF8ccKyJX6bCOOp26OWXPL6lHkEK-9XYVng-VUCCzFfyEIRBQ1Wk7n-AhJIT9J4u5FZeWF1JFEjh0YU1absTvlknN46f8LmFkK5CMh2BL9r47__m_YyoFCUoNR23DnileeJSRkDhSE9c2BwbBW90EOzJsIl4z_9qRUOENatjqeoY6jMd-shRLVVH8J2jgs_nsOVKQ87B9vzUwMGRiPM-7Udg1MsRQJxaI23DT5hXuPh4PH9rmnp6w2IhkidcrcMkbDZrg1rt70XJEtbNI0-13nhizSqNwZhNXAkm-Xh7qgTtsw9cpKm0CJ6I7eOEKcMVE6Xhabc1fZrUgTgNlh-TWFGOGLjun1OBtmYGTDz_XLmu6d4BvhmY7I7WOI7FDqZAIE74BCmigedpw2VC2CHLTmVFHmSp0mwMRxlm5Kmnie5AlPt-QGOZE5vDWU6qenIMHCsQUpD_dy3Xa2g8so3qN9N1hTudo5jTF7038O5atWXNZkOO-S5yItnbk_pUjgjiutFsm7BUCTlFcE9XhFxe4f7xJk-W6KVDq1_KAsMRVB4XyW2WtEzESaOhQ30YqQ-N-bJnOx6WaQAABwAAAAAAAAAMAQAAAAAAAA2QBBhDb250ZW50LVR5cGUgYXBwbGljYXRpb24vanNvbhZBcHBsaWNhdGlvbhhDeWJlckNvbm5lY3QUQ29udGVudC1JZIABMGVmZjllYzMwMzJmZGY4NTU2N2FmZGQwYjAxOWJlNGY5NDc1N2Q5YmNmNTJmMTRiMDczOTUyZGE3Mjc3MTYyNRxDb250ZW50LURpZ2VzdIABMGVmZjllYzMwMzJmZGY4NTU2N2FmZGQwYjAxOWJlNGY5NDc1N2Q5YmNmNTJmMTRiMDczOTUyZGE3Mjc3MTYyNRxDb250ZW50LUF1dGhvchhrZXM2Z2M5ZWNjZWQOQ2hhaW5JZAQ1NgxTb3VyY2UIYXRlbQB7ImNvbnRlbnQiOiJ7XCJvcFwiOlwicG9zdFwiLFwiYWRkcmVzc1wiOlwiMHhiNDI5Njg0Y2Y0NGQzOGJhMDE5OTRkY2Y5ZjkzNDlhZGQ2ZTJkZmVlXCIsXCJ0c1wiOjE2OTE0NjA2MjI4OTUsXCJjaGFpbklkXCI6NTYsXCJoYW5kbGVcIjpcImtlczZnYzllY2NlZFwiLFwidGl0bGVcIjpcIjExMTEyXCIsXCJib2R5XCI6XCIyMjIyMjIyMjIyMjIyMjIyMjJcIn0iLCJkaWdlc3QiOiIwZWZmOWVjMzAzMmZkZjg1NTY3YWZkZDBiMDE5YmU0Zjk0NzU3ZDliY2Y1MmYxNGIwNzM5NTJkYTcyNzcxNjI1Iiwic2lnbmF0dXJlIjoiMHhjMjE0MGYzYjAzMmYyMmEwZTQ0NDFhYjU3YjJjYjkxZTc0OTQxY2Y0YjBlOGVlZWEyM2U3NmQ2MTg1YmM5ZmNhMzNhYjk1YTZhNTY2NTcxOWI4ZDcwM2VjOTM5YTdlOTVkMTk2MDdkOTk5MWNlNjhkN2MyNTI1NWVhMzQ5YTExZiIsInNpZ25pbmdLZXkiOnsicHVibGljS2V5IjoiTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFMEdjUEhRU29IZ1hHZEVwcm1vL0dWQWFGNnJaMGZibktGOTZYcEVES0V3TXlhSy9mWUJFZ1Z0TENXU25VUGFOckV1L3dUaitxeGhPSHRtMFdTWERiVGc9PSIsImZvcm1hdCI6IlN1YmplY3RQdWJsaWNLZXlJbmZvIiwiYWxnb3JpdGhtIjoiRVMyNTYifSwic2lnbmluZ0tleUF1dGgiOnsiYWRkcmVzcyI6IjB4YjQyOTY4NGNmNDRkMzhiYTAxOTk0ZGNmOWY5MzQ5YWRkNmUyZGZlZSIsInNpZ25pbmdLZXlTaWduYXR1cmUiOiIweDE3MDUwNWVkNTM5OWVjY2JhODRkYmMwMTBiNjQzYTQyZmNlYTc3NGQ1NTUzOWE1YTAyNDZkZmI3MjViOWJhZGE0MThjODFlNzlhZWQ1NzZhNTcwNTA5MWU2MmQ4ZWMxZDVjZmI5NGFiMzNhMWFkM2IxNmRiOWY5ZDc2ODY0ZmEzMWMiLCJzaWduaW5nS2V5TWVzc2FnZSI6IkkgYXV0aG9yaXplIEF0ZW1SZXZpZXcgZnJvbSB0aGlzIGRldmljZSB1c2luZyBzaWduaW5nIGtleTpcbk1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRTBHY1BIUVNvSGdYR2RFcHJtby9HVkFhRjZyWjBmYm5LRjk2WHBFREtFd015YUsvZllCRWdWdExDV1NuVVBhTnJFdS93VGorcXhoT0h0bTBXU1hEYlRnPT0ifX0BAFgnPBlnvkcbKzbaIlRg0B5vevcY3SEJeMIawUqgPerrAIkW1m6CJeb-Z_V6z-h_5JRMUBsQBWVShThD2aeB4Ro-Tuk10BBNzyFNl4U4ouU26pMTeXwSic1FjBrooShCR1Rd1c5AkVQgiWk5TZg0dGONyxJXIDROgmgG-bLDjjlzMEoosMA7V-2Ssu3Nxv7K5LmoVxuljKMJtWyJp82vgadX1dVzoXbhwRLWu7O38IC_LVvoU3g5dULz7HtV-usTXPXZzn6ZunEij0PVZ6EOIzrVvRBZcyaM--_MHkFf2ljU1FOUnP_wZpIckav6qqW2mZYbrbw63voXSB9AJg8vYU8OB4G1NAoyDDY3uDdBT110KLG9LhrE1guk1tIvqh9Fybq2n2Uu4-N6kaBBge-qHtTiAgmIU1IqJ9260HpiCqrfCDW4CVqQcot1QTScmjEYFBZ7W36uqe79MIZ6ZThUIcyYu6eyt8FiNy5FOIyFGwHiU3EcmIhpTX-lADrqzY2axekp-QFTFys4YP2dVDbRH8ME473NpV8SA_USdm_GEss0Y6UtSU3jZVUhFFD9jYTaJTL-e3kVB6vASwzryuK3uy_BYT_wk0acMOL2Aw6Yqg3qfkoz2KA9-3vt368lf1K-PjgUvMJCERtyxPpJvnf0-bMEXdZHtvR1xHLBzs1ZSDbDnPgX7WyVoTnTxFtyMHzK_iyQ9jKTuTNvPZDvpKXyraIujN7xcC4NvJ3aJ8zssULFQNgqiC5cQ2opbFOhg0A7GLIBkXNwSVwD5BBfHHCsiV-mwjjqdujllzy-pR5BCvvV2FZ4PlVAgsxX8hCEQUNVpO5_gISSE_SeLuRWXlhdSRRI4dGFNWm7E75ZJzeOn_C5hZCuQjIdgS_a-O__5v2MqBQlKDUdtw54pXniUkZA4UhPXNgcGwVvdBDsybCJeM__akVDhDWrY6nqGOozHfrIUS1VR_Cdo4LP57DlSkPOwfb81MDBkYjzPu1HYNTLEUCcWiNtw0-YV7j4eDx_a5p6esNiIZInXK3DJGw2a4Na7e9FyRLWzSNPtd54Ys0qjcGYTVwJJvl4e6oE7bMPXKSptAieiO3jhCnDFROl4Wm3NX2a1IE4DZYfk1hRjhi47p9TgbZmBkw8_1y5runeAb4ZmOyO1jiOxQ6mQCBO-AQpooHnacNlQtghy05lRR5kqdJsDEcZZuSpp4nuQJT7fkBjmRObw1lOqnpyDBwrEFKQ_3ct12toPLKN6jfTdYU7naOY0xe9N_DuWrVlzWZDjvkuciLZ25P6VI4I4rrRbJuwVAk5RXBPV4RcXuH-8SZPluilQ6tfygLDEVQeF8ltlrRMxEmjoUN9GKkPjfmyZzselmkAAAgAAAAAAAAAfQEAAAAAAAAP8gUYQ29udGVudC1UeXBlIGFwcGxpY2F0aW9uL2pzb24WQXBwbGljYXRpb24YQ3liZXJDb25uZWN0FENvbnRlbnQtSWSAATBkMjY1MWNiMTRkNzczMjRjNzRmZmMwODM1Yzk3ZTkyMTgyMzYwMjcyNDhkNGE5YWE3M2E3YTE0OTA5Njk2ZjkcQ29udGVudC1EaWdlc3SAATBkMjY1MWNiMTRkNzczMjRjNzRmZmMwODM1Yzk3ZTkyMTgyMzYwMjcyNDhkNGE5YWE3M2E3YTE0OTA5Njk2ZjkcQ29udGVudC1BdXRob3IYZzY2cHRobzZjaWg0DkNoYWluSWQENTYcQ29udGVudC1UYXJnZXSAATM5ZjAyMTg4MWU3Mzg2ZjhkNzNkNmVmMjU1MzNlNjA5MWYyYTAyNTZlNDIyYjRiM2M0ZTNkMzM1Y2NhZTE0N2UMU291cmNlSDE1NTMxZmEyLTEyMDUtNGY2MS1iNmU0LWM5ZjY4ZWNmODFmNwB7ImNvbnRlbnQiOiJ7XCJvcFwiOlwiY29tbWVudFwiLFwiYWRkcmVzc1wiOlwiMHg2NDc4MzhhOTY4ZGQ2YWQ5ZmRmN2EyMDdiNGYwMjU2ODA4MjhkZDNhXCIsXCJ0c1wiOjE2OTE0NjA2MjMwNDcsXCJjaGFpbklkXCI6NTYsXCJoYW5kbGVcIjpcImc2NnB0aG82Y2loNFwiLFwidGFyZ2V0XCI6XCIzOWYwMjE4ODFlNzM4NmY4ZDczZDZlZjI1NTMzZTYwOTFmMmEwMjU2ZTQyMmI0YjNjNGUzZDMzNWNjYWUxNDdlXCIsXCJ0aXRsZVwiOlwiRmxhcHB5TW9vbmJpcmRcIixcImJvZHlcIjpcIlNvIGZ1biB0byBwbGF5IGluIG15IHNwYXJlIHRpbWUuXCJ9IiwiZGlnZXN0IjoiMGQyNjUxY2IxNGQ3NzMyNGM3NGZmYzA4MzVjOTdlOTIxODIzNjAyNzI0OGQ0YTlhYTczYTdhMTQ5MDk2OTZmOSIsInNpZ25hdHVyZSI6IjB4ZTk2NjYwMjhmNjRjMWQ2MDdkNWYwZDNjYWY1Yzc5Y2RiMDYxNDI4YjU2MjIzMWQ1ZTU2NGE1NGIzMDMzNTVhZTUyZGJkYzFkNzgyNjU5NDFhNTEwZWE3NmY1NTYzMGZiOWZhZjYwM2RmNzhjNmE3ZWFjMTFkNWE3YjhmMDVjY2YiLCJzaWduaW5nS2V5Ijp7InB1YmxpY0tleSI6Ik1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRXArR3BxRForTmxkR3ptcnBhQWZHbGk1eGlFMTY3WTlzK3oxOTNtbHBteGRweGZQZkxHUE1GQTNRaEx5ZHlDaDVuQko2V3dNcW9zQVRrMWtUK2k5U2JRPT0iLCJmb3JtYXQiOiJTdWJqZWN0UHVibGljS2V5SW5mbyIsImFsZ29yaXRobSI6IkVTMjU2In0sInNpZ25pbmdLZXlBdXRoIjp7ImFkZHJlc3MiOiIweDY0NzgzOGE5NjhkZDZhZDlmZGY3YTIwN2I0ZjAyNTY4MDgyOGRkM2EiLCJzaWduaW5nS2V5U2lnbmF0dXJlIjoiMHg5MWYwNjU2ZjIzNDViNzljZjdkMjIzODY1MmIzNWE1ODRjYzIyZmViZjA5ZjliZTE5NzljZTgzMDRkNDQyOTU4MGZiNGIwYjg4NWQ3ZjMyZDU5OGIzNjdjYzRmY2IyNDdhZDg0NmMxNGI3ZGNhOGQxZmY3YTRjZWZhMWE4ZTk1NDFiIiwic2lnbmluZ0tleU1lc3NhZ2UiOiJJIGF1dGhvcml6ZSBDeWJlckNvbm5lY3QgZnJvbSB0aGlzIGRldmljZSB1c2luZyBzaWduaW5nIGtleTpcbk1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRXArR3BxRForTmxkR3ptcnBhQWZHbGk1eGlFMTY3WTlzK3oxOTNtbHBteGRweGZQZkxHUE1GQTNRaEx5ZHlDaDVuQko2V3dNcW9zQVRrMWtUK2k5U2JRPT0ifX0BAFTOfR3hPa5jeYmHy7-o9m9Hl8ONE_B_QDJpLUF7vSPkPw41r4qJULubDyDH1r_iOBjG9DEF2NMLOfGYtjxgRLJ2cXkoNlKr34G7s07jmMvEIMyIMOQOEG1LIXhkEnKK7CCj81Pt-wYvWzW_JPW3R5jMMQWAljIDtHMoxpgajEHJAMJiaXQ17VL_xHbe8Wh-Y_XDBDQyiZyrnjQ-cjS2vY78SaCRbUnTqgRMQ6YcdmQ9M7Nal3QRa0Qu_hiep90Q1U2XVesEBMXo7TlqKzps3BvjELb3aW1c6wTXGdm4SAiAo2L9qIeu8SM4WXb6Vs-WDGKj7wQI7vySMGDV6m8cKJOLY1cqbXAfCdqY53PxoJJmxc-809wWZtVmoQ2P4W4AK992lxf4WkuW0gdIa-45fB-SZO-k15k6jo6RCMbI3hMsf6hIp69l5-Y2O-ZFqfW12NN5XPwIONZ-lgqCV1GDkMh1fiteoV797V-eNm0gx6l0Sgho9MtJcwCgUmBSo6WXGJIXY6IIziyoJpEEIGQco2HRNUNwJLkk7Voiy1VoaY1PRBCg361JCjGbJ56BSrNhyGKkVXhGAsBAzm_z9OZVZrXir4UQ1HPcXZo0TsZLLr6o3c6q8YOwE4bLbLM2K1HxNCHa-pEJYFOO5lZG_HjRpr9CsIJV1oiK2uC58H_aFhllnPgX7WyVoTnTxFtyMHzK_iyQ9jKTuTNvPZDvpKXyraIujN7xcC4NvJ3aJ8zssULFQNgqiC5cQ2opbFOhg0A7GLIBkXNwSVwD5BBfHHCsiV-mwjjqdujllzy-pR5BCvvV2FZ4PlVAgsxX8hCEQUNVpO5_gISSE_SeLuRWXlhdSRRI4dGFNWm7E75ZJzeOn_C5hZCuQjIdgS_a-O__5v2MqBQlKDUdtw54pXniUkZA4UhPXNgcGwVvdBDsybCJeM__akVDhDWrY6nqGOozHfrIUS1VR_Cdo4LP57DlSkPOwfb81MDBkYjzPu1HYNTLEUCcWiNtw0-YV7j4eDx_a5p6esNiIZInXK3DJGw2a4Na7e9FyRLWzSNPtd54Ys0qjcGYTVwJJvl4e6oE7bMPXKSptAieiO3jhCnDFROl4Wm3NX2a1IE4DZYfk1hRjhi47p9TgbZmBkw8_1y5runeAb4ZmOyO1jiOxQ6mQCBO-AQpooHnacNlQtghy05lRR5kqdJsDEcZZuSpp4nuQJT7fkBjmRObw1lOqnpyDBwrEFKQ_3ct12toPLKN6jfTdYU7naOY0xe9N_DuWrVlzWZDjvkuciLZ25P6VI4I4rrRbJuwVAk5RXBPV4RcXuH-8SZPluilQ6tfygLDEVQeF8ltlrRMxEmjoUN9GKkPjfmyZzselmkAAAgAAAAAAAAAfQEAAAAAAAAP8gUYQ29udGVudC1UeXBlIGFwcGxpY2F0aW9uL2pzb24WQXBwbGljYXRpb24YQ3liZXJDb25uZWN0HENvbnRlbnQtVGFyZ2V0gAEzOWYwMjE4ODFlNzM4NmY4ZDczZDZlZjI1NTMzZTYwOTFmMmEwMjU2ZTQyMmI0YjNjNGUzZDMzNWNjYWUxNDdlDFNvdXJjZUgxNTUzMWZhMi0xMjA1LTRmNjEtYjZlNC1jOWY2OGVjZjgxZjcUQ29udGVudC1JZIABODMyZjllYTk5MWRjNTEzYTlhYmI5MTY5MmFlYjg2YWIxYmQ2MWYzNTE0NGQ5NTI3YjFlMTFlN2EwMjFkMTVmZhxDb250ZW50LURpZ2VzdIABODMyZjllYTk5MWRjNTEzYTlhYmI5MTY5MmFlYjg2YWIxYmQ2MWYzNTE0NGQ5NTI3YjFlMTFlN2EwMjFkMTVmZhxDb250ZW50LUF1dGhvchgxaWR1azc2Y3BmZnYOQ2hhaW5JZAQ1NgB7ImNvbnRlbnQiOiJ7XCJvcFwiOlwiY29tbWVudFwiLFwiYWRkcmVzc1wiOlwiMHgyMmFmZWE4YTM3NjIyZDljZmM1NDBmNmRjNzAyNjIwYmUzMzYyYTFiXCIsXCJ0c1wiOjE2OTE0NjA2MjIyNTQsXCJjaGFpbklkXCI6NTYsXCJoYW5kbGVcIjpcIjFpZHVrNzZjcGZmdlwiLFwidGFyZ2V0XCI6XCIzOWYwMjE4ODFlNzM4NmY4ZDczZDZlZjI1NTMzZTYwOTFmMmEwMjU2ZTQyMmI0YjNjNGUzZDMzNWNjYWUxNDdlXCIsXCJ0aXRsZVwiOlwiRmxhcHB5TW9vbmJpcmRcIixcImJvZHlcIjpcIlNvIGZ1biB0byBwbGF5IGluIG15IHNwYXJlIHRpbWUuXCJ9IiwiZGlnZXN0IjoiODMyZjllYTk5MWRjNTEzYTlhYmI5MTY5MmFlYjg2YWIxYmQ2MWYzNTE0NGQ5NTI3YjFlMTFlN2EwMjFkMTVmZiIsInNpZ25hdHVyZSI6IjB4NzUyNTZkZDlmNjgwZmQ1MDQ4ZjRjNzg4N2MyMjc5NjU2MDg1YTVhYzZhNDM4OGM0MTUyMjlmZjFiYWIyNzMwNDkwODA3OTczMDAxMTVhYWNhYWMyYjI1YjY0ZjRhNWUxMzMzZWQ2OThlOWNkMTA5MTM4MzFlNzBiMGE2YjdiM2IiLCJzaWduaW5nS2V5Ijp7InB1YmxpY0tleSI6Ik1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRWh6RjNjdVJwUG1aNDVINnZqMm5NR0hzaGttckhVSzNsSmJONVdsNnplbUx4eWlwelNseGZMRWxzSkszQ3FFMVgraWJxbjlZcVJiV3hVN1crdHIwR3V3PT0iLCJmb3JtYXQiOiJTdWJqZWN0UHVibGljS2V5SW5mbyIsImFsZ29yaXRobSI6IkVTMjU2In0sInNpZ25pbmdLZXlBdXRoIjp7ImFkZHJlc3MiOiIweDIyYWZlYThhMzc2MjJkOWNmYzU0MGY2ZGM3MDI2MjBiZTMzNjJhMWIiLCJzaWduaW5nS2V5U2lnbmF0dXJlIjoiMHgzYzQ1NDYwNzRiMjliYWY4NGNhYmY1YjVmZDk4MzlhOGM2NjQyMjUyY2UwMTllOTgyMWI4MDYyMGFhNzRkNTU1MmQ4ZjE2MTg3NGRmNWFjM2MwMWI3OWViYjczZjNhMjBkZGUzY2MxZDZjMzA5ZjQzY2NkODE1OTFhZmJiOGMyNTFjIiwic2lnbmluZ0tleU1lc3NhZ2UiOiJJIGF1dGhvcml6ZSBDeWJlckNvbm5lY3QgZnJvbSB0aGlzIGRldmljZSB1c2luZyBzaWduaW5nIGtleTpcbk1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRWh6RjNjdVJwUG1aNDVINnZqMm5NR0hzaGttckhVSzNsSmJONVdsNnplbUx4eWlwelNseGZMRWxzSkszQ3FFMVgraWJxbjlZcVJiV3hVN1crdHIwR3V3PT0ifX0BAJVUvQBsR5JGkfmmpkjRKmGx1CEQovuwixck1jwW6dwnC5YsDMARBjqpicv42DWEVMhcESy5uuGvt8CR7weVL2Twvt9sYhwZjrkGGRrFUbBABQ8h5FSmiLO1H21VlFU_zdLGfxmAVIytrxPN-an9vuSc2r8o8YetF1JAPtIHhcz5zkg99YTKNCQFRs4F3J3mBkZlzS7F7_ZATJkkYlE7avtHn-AWywkdRvgK9wiyo1bDUHt5k9Tx9isKrywifcPT8dkYvRO7NKgbjGPCx7O1c26v0zBqwbvyWqtpSMWMdB7i4R6pQwFfk4NHVTWfx48YhlPJf6u1acX4YxT1wWuaJ7bgfiQO8IAvwiEW5q979EczWDsrPsNln0A3C7E502DHFIwrx38aSoP8zGSgOiKZqUtyshJdXoWO-uCDE1UrXA6XnIM9EmAg3xlqhF2nliNpcd2Dzo9OuaT5QsRKKEVVfjAYgUyjSG-shzsiLnb7XDFLVJ9agk2Ya0fS-8lkASqi9xo3emvxut3x6zoT_Fsw3h1Efu_XWqI-lDezLTRs9xBxqsTPG3Colxkajr9T_seTlo14hmYIWIEgq0nYSRDfpNS_kNfLr_fXfWb5oKLi-hSoiCOcnbStrwoifzMuXmPcw3bjrCrFt5DPo3Z0I4Fc4VvOsqtfbMdKxEE4kyGO7X-onPgX7WyVoTnTxFtyMHzK_iyQ9jKTuTNvPZDvpKXyraIujN7xcC4NvJ3aJ8zssULFQNgqiC5cQ2opbFOhg0A7GLIBkXNwSVwD5BBfHHCsiV-mwjjqdujllzy-pR5BCvvV2FZ4PlVAgsxX8hCEQUNVpO5_gISSE_SeLuRWXlhdSRRI4dGFNWm7E75ZJzeOn_C5hZCuQjIdgS_a-O__5v2MqBQlKDUdtw54pXniUkZA4UhPXNgcGwVvdBDsybCJeM__akVDhDWrY6nqGOozHfrIUS1VR_Cdo4LP57DlSkPOwfb81MDBkYjzPu1HYNTLEUCcWiNtw0-YV7j4eDx_a5p6esNiIZInXK3DJGw2a4Na7e9FyRLWzSNPtd54Ys0qjcGYTVwJJvl4e6oE7bMPXKSptAieiO3jhCnDFROl4Wm3NX2a1IE4DZYfk1hRjhi47p9TgbZmBkw8_1y5runeAb4ZmOyO1jiOxQ6mQCBO-AQpooHnacNlQtghy05lRR5kqdJsDEcZZuSpp4nuQJT7fkBjmRObw1lOqnpyDBwrEFKQ_3ct12toPLKN6jfTdYU7naOY0xe9N_DuWrVlzWZDjvkuciLZ25P6VI4I4rrRbJuwVAk5RXBPV4RcXuH-8SZPluilQ6tfygLDEVQeF8ltlrRMxEmjoUN9GKkPjfmyZzselmkAAAcAAAAAAAAAEgEAAAAAAAANnAQYQ29udGVudC1UeXBlIGFwcGxpY2F0aW9uL2pzb24WQXBwbGljYXRpb24YQ3liZXJDb25uZWN0DkNoYWluSWQENTYMU291cmNlCGF0ZW0UQ29udGVudC1JZIABNmExNDkyNjk5Njc5YmZmNzBlOThhMDEwMDVjNDVjNDIyZDZhZjdiN2UwM2Q5OTc2YTU2YjMxN2VhZjgyZGRjYxxDb250ZW50LURpZ2VzdIABNmExNDkyNjk5Njc5YmZmNzBlOThhMDEwMDVjNDVjNDIyZDZhZjdiN2UwM2Q5OTc2YTU2YjMxN2VhZjgyZGRjYxxDb250ZW50LUF1dGhvciRmbG9yZW5jaWFhdWJyZXl3djkAeyJjb250ZW50Ijoie1wib3BcIjpcInBvc3RcIixcImFkZHJlc3NcIjpcIjB4N2Y5YTQ0OTE0YjFmYWFjMjY5MWIxMDg5ZDY2NjYwNzE3M2JiNjcxZVwiLFwidHNcIjoxNjkxNDYwNjIyNjQwLFwiY2hhaW5JZFwiOjU2LFwiaGFuZGxlXCI6XCJmbG9yZW5jaWFhdWJyZXl3djlcIixcInRpdGxlXCI6XCJUaGUgSW1wb3J0YW5jZSBvZiBQaGlsb3NvcGh5XCIsXCJib2R5XCI6XCJEZWRpY2F0ZWQgZWZmb3J0IEluIGZpbmUgc3R5bGVcIn0iLCJkaWdlc3QiOiI2YTE0OTI2OTk2NzliZmY3MGU5OGEwMTAwNWM0NWM0MjJkNmFmN2I3ZTAzZDk5NzZhNTZiMzE3ZWFmODJkZGNjIiwic2lnbmF0dXJlIjoiMHg5NzJmODNhMTQxYzMxNjJkMzY1NTM1NzYyNjhlYzFlYmVhZTYwNjllYTc1OGExODhlNGE2YTgyMjY2MThhNGY3NTE2NmQwZjM0MzRhZTAyNzcyYTMyNmM4MGZkYWY0MjUzYThiNTY1MmYyMzgxYjljYThhZDQxMWJjNzNhNGM0MyIsInNpZ25pbmdLZXkiOnsicHVibGljS2V5IjoiTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFaWVDR0FEK2IrNGNBelBZSE44WlAzUXRua01CbUQrYXJYblc1WFM1c2JFQ1hxSDNTZWhhZFJraTJicExjRjdLR1ZrZDFYMXZYRk5SRFE0NFprcEJEWUE9PSIsImZvcm1hdCI6IlN1YmplY3RQdWJsaWNLZXlJbmZvIiwiYWxnb3JpdGhtIjoiRVMyNTYifSwic2lnbmluZ0tleUF1dGgiOnsiYWRkcmVzcyI6IjB4N2Y5YTQ0OTE0YjFmYWFjMjY5MWIxMDg5ZDY2NjYwNzE3M2JiNjcxZSIsInNpZ25pbmdLZXlTaWduYXR1cmUiOiIweDBlYTAzM2YyOGRhZGZjYzhmZGUyZmVjY2EwYWQ2NDg0NWQyOTVjZTViNjhjOGNmZmJhYTM1YWFhMjFjZjU2OGYwZDM5NWNjNzEwYTZiMjA1MDAxNjI4ZDg0N2E1MTZiZWRjOWY0NzNiYjRjODcyZTIxZGM4Y2RmNjZhNTQwNTJmMWIiLCJzaWduaW5nS2V5TWVzc2FnZSI6IkkgYXV0aG9yaXplIEF0ZW1SZXZpZXcgZnJvbSB0aGlzIGRldmljZSB1c2luZyBzaWduaW5nIGtleTpcbk1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRWllQ0dBRCtiKzRjQXpQWUhOOFpQM1F0bmtNQm1EK2FyWG5XNVhTNXNiRUNYcUgzU2VoYWRSa2kyYnBMY0Y3S0dWa2QxWDF2WEZOUkRRNDRaa3BCRFlBPT0ifX0BAHhwab4RTCdYnb5NrB2DLmZdf6CQuMKgJ8Bvzo1eucmTy8IT9II8KABKKWWUWkvx6QuUHNKSLp6oH-HG-N8coh3fWdg0EfjVWzQ43lzpHE39eFgKpa5JSXVOb1LBrtJbMcsRvGHyfeCBxaPPGWMDCUovwHGV_hm64xDrQbbu3L80VB7VKVLaYya_SCWtSGczE1mJ0LITEvG1Jjg9alC9nOYOUao7nwjkj06c91TJiecQbPNj_2-CBovXbE4Fl_jXrCARtc26hVYxyTQjdi5kYwcugB65JNA7YVz5ix8BdUy4BHzlOqnuaVHu6Sz4EUhY3sOEeBxW2PG7XDyY2uZqZuOxPEQhskIjB4ff9zqtQJ2zkSgfQI0ak0G4ncssa1wWKLnR2WvC14yX40r8jFSXBP2qalP4rh4-It-LjiEdFqOoMSSYC1D5aOp0SpjeTdMQENEgaFzmvu53Xpz9yBLnk42VCVxmS-9niQEtHrmoOESzzmuy9XdCEx3Ki-2-MrhESMHt4MVpS2AwSXPfyvdArXh2SeM8aSiLJFFR__bz50_OdUdP5ebW8j2bZY92omNL_7Som7MTq7WERHHLcolwI_j4c9v3_80fHnbfj1TJ5DLankQhyzjWCdI5td5X6DCd__yAY7lC0QkpbMy1sJQObodiiIHL2SiuwULYemZDCnibnPgX7WyVoTnTxFtyMHzK_iyQ9jKTuTNvPZDvpKXyraIujN7xcC4NvJ3aJ8zssULFQNgqiC5cQ2opbFOhg0A7GLIBkXNwSVwD5BBfHHCsiV-mwjjqdujllzy-pR5BCvvV2FZ4PlVAgsxX8hCEQUNVpO5_gISSE_SeLuRWXlhdSRRI4dGFNWm7E75ZJzeOn_C5hZCuQjIdgS_a-O__5v2MqBQlKDUdtw54pXniUkZA4UhPXNgcGwVvdBDsybCJeM__akVDhDWrY6nqGOozHfrIUS1VR_Cdo4LP57DlSkPOwfb81MDBkYjzPu1HYNTLEUCcWiNtw0-YV7j4eDx_a5p6esNiIZInXK3DJGw2a4Na7e9FyRLWzSNPtd54Ys0qjcGYTVwJJvl4e6oE7bMPXKSptAieiO3jhCnDFROl4Wm3NX2a1IE4DZYfk1hRjhi47p9TgbZmBkw8_1y5runeAb4ZmOyO1jiOxQ6mQCBO-AQpooHnacNlQtghy05lRR5kqdJsDEcZZuSpp4nuQJT7fkBjmRObw1lOqnpyDBwrEFKQ_3ct12toPLKN6jfTdYU7naOY0xe9N_DuWrVlzWZDjvkuciLZ25P6VI4I4rrRbJuwVAk5RXBPV4RcXuH-8SZPluilQ6tfygLDEVQeF8ltlrRMxEmjoUN9GKkPjfmyZzselmkAAAgAAAAAAAAAfQEAAAAAAAAP8gUYQ29udGVudC1UeXBlIGFwcGxpY2F0aW9uL2pzb24WQXBwbGljYXRpb24YQ3liZXJDb25uZWN0HENvbnRlbnQtVGFyZ2V0gAEzOWYwMjE4ODFlNzM4NmY4ZDczZDZlZjI1NTMzZTYwOTFmMmEwMjU2ZTQyMmI0YjNjNGUzZDMzNWNjYWUxNDdlDFNvdXJjZUgxNTUzMWZhMi0xMjA1LTRmNjEtYjZlNC1jOWY2OGVjZjgxZjcUQ29udGVudC1JZIABYzYxZGI2ZGVhMzFlMzY5N2JlYTkwNGJhYmI5N2QyYTI4NTc3NDJlYTE1NWM4YWJhOWMyNzZlMDM5MjBkODI5NxxDb250ZW50LURpZ2VzdIABYzYxZGI2ZGVhMzFlMzY5N2JlYTkwNGJhYmI5N2QyYTI4NTc3NDJlYTE1NWM4YWJhOWMyNzZlMDM5MjBkODI5NxxDb250ZW50LUF1dGhvchhwdXJ4ZWd1dmFocGEOQ2hhaW5JZAQ1NgB7ImNvbnRlbnQiOiJ7XCJvcFwiOlwiY29tbWVudFwiLFwiYWRkcmVzc1wiOlwiMHg0Yjk2ZWQ5NTlkMGMxZjJiZTQzNWU2YjM2OWM3ZTMyYmM4MWViNzRiXCIsXCJ0c1wiOjE2OTE0NjA2MjIxNzAsXCJjaGFpbklkXCI6NTYsXCJoYW5kbGVcIjpcInB1cnhlZ3V2YWhwYVwiLFwidGFyZ2V0XCI6XCIzOWYwMjE4ODFlNzM4NmY4ZDczZDZlZjI1NTMzZTYwOTFmMmEwMjU2ZTQyMmI0YjNjNGUzZDMzNWNjYWUxNDdlXCIsXCJ0aXRsZVwiOlwiRmxhcHB5TW9vbmJpcmRcIixcImJvZHlcIjpcIlNvIGZ1biB0byBwbGF5IGluIG15IHNwYXJlIHRpbWUuXCJ9IiwiZGlnZXN0IjoiYzYxZGI2ZGVhMzFlMzY5N2JlYTkwNGJhYmI5N2QyYTI4NTc3NDJlYTE1NWM4YWJhOWMyNzZlMDM5MjBkODI5NyIsInNpZ25hdHVyZSI6IjB4ZGZlY2I1NTgzMzAzMDYyNmRlMzdkZjY3OGM2NzdhYjZmOWU4NzJhNjE1ZWQ0M2E3ODk1ZTM5MzFiMzQwMDJmOWRiYmRlOGUwNGQ0NWM1NWQzM2E4YjgyMDM0NzQwYjE0NjcwODIxNzcyOTMyN2UyNTA1MTFhNDlhNzU5NzBkNDciLCJzaWduaW5nS2V5Ijp7InB1YmxpY0tleSI6Ik1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRURBc1pQTFF6dUhHWFdKdmhabFkyN2NqMUs4RHpRMUZqMG9HT1BUTmMvV00raTMwT2hNREtZTVZDQzd0bG1uZ0R4RllWbGw2V0MxUzVwOVZ4NzMvZjl3PT0iLCJmb3JtYXQiOiJTdWJqZWN0UHVibGljS2V5SW5mbyIsImFsZ29yaXRobSI6IkVTMjU2In0sInNpZ25pbmdLZXlBdXRoIjp7ImFkZHJlc3MiOiIweDRiOTZlZDk1OWQwYzFmMmJlNDM1ZTZiMzY5YzdlMzJiYzgxZWI3NGIiLCJzaWduaW5nS2V5U2lnbmF0dXJlIjoiMHgzNzBiMWVhODcxZGIxYTQ5ZGIyY2NkNWE4MGExNTdjYWNlZTExNDc4ZDNjZTUzNjBkMTU2ZmM4OGVjNTU2Zjc0MTRjYWZkZjBmYWY3NmI2NjI3NDA4NDUzYmYzYjJjMmZkNzViODgxM2NmNDdiZTFhMDQ1ODVmOTk2ZWNmYTVlOTFiIiwic2lnbmluZ0tleU1lc3NhZ2UiOiJJIGF1dGhvcml6ZSBDeWJlckNvbm5lY3QgZnJvbSB0aGlzIGRldmljZSB1c2luZyBzaWduaW5nIGtleTpcbk1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRURBc1pQTFF6dUhHWFdKdmhabFkyN2NqMUs4RHpRMUZqMG9HT1BUTmMvV00raTMwT2hNREtZTVZDQzd0bG1uZ0R4RllWbGw2V0MxUzVwOVZ4NzMvZjl3PT0ifX0BAER-LYgedGTQzG5EBqXOQfAGhWyTGp1DbT-e0-C6fTWfhMR1KJ17PYDkXy7KYI5Tfxqf55IKNuFOFC9-lBELG7qNrfRQtZuY0GaephLrTJJyAl6fqRKDWcLwi_8ZoEG66Z5wYsYGPfQXBiY71U5XhdpA9RST0EhVC6wxf9gUCSj_I1buaxgRwOAtCjzWeQTHtFDgEqnO8FSheoqJxfVy0d_dSXoUUtn6A6sRW4FzxVEZUJz6uagmZNuWk4M3jHygIlWe6fEYrqI_O3JvufZX3hDEtkBdGCvK807dnqKyrtkpNxUQ8-_0ubTvOmVHf_PZiO1_NFTyK9fXI-qcNCzIMb63BRYZzaqrjV-IPQ4kgBVkV_Rd8zJmWtLQaC6vU4mZtR4vMQCuIyqWhKCU2My58UQGJ6TUVj-JLqNRTwYy6QOKl_MsDIXiP8H7_6AGBwM8x9FZvY2G00NBFTlrXU5MYaT6IcVaysRLNtMWtRT17PXb83xA1nojwEkbtZP4sCis99Vda-s0469Lie364AYYaRj7Juiyg-oSIbv4PbD0dJilDQBGdf450kV-Y-Orn_WO0n1i74yg4fv0lR1_FB0siQeihMqeKk4fsfTn0v6yg0frD-dIIOqqpEQ1alm0DuSQIAZDIInZfvbIqGwyY3Sc0swBqGcLV4EpYr_WaNYCCQ5ynPgX7WyVoTnTxFtyMHzK_iyQ9jKTuTNvPZDvpKXyraIujN7xcC4NvJ3aJ8zssULFQNgqiC5cQ2opbFOhg0A7GLIBkXNwSVwD5BBfHHCsiV-mwjjqdujllzy-pR5BCvvV2FZ4PlVAgsxX8hCEQUNVpO5_gISSE_SeLuRWXlhdSRRI4dGFNWm7E75ZJzeOn_C5hZCuQjIdgS_a-O__5v2MqBQlKDUdtw54pXniUkZA4UhPXNgcGwVvdBDsybCJeM__akVDhDWrY6nqGOozHfrIUS1VR_Cdo4LP57DlSkPOwfb81MDBkYjzPu1HYNTLEUCcWiNtw0-YV7j4eDx_a5p6esNiIZInXK3DJGw2a4Na7e9FyRLWzSNPtd54Ys0qjcGYTVwJJvl4e6oE7bMPXKSptAieiO3jhCnDFROl4Wm3NX2a1IE4DZYfk1hRjhi47p9TgbZmBkw8_1y5runeAb4ZmOyO1jiOxQ6mQCBO-AQpooHnacNlQtghy05lRR5kqdJsDEcZZuSpp4nuQJT7fkBjmRObw1lOqnpyDBwrEFKQ_3ct12toPLKN6jfTdYU7naOY0xe9N_DuWrVlzWZDjvkuciLZ25P6VI4I4rrRbJuwVAk5RXBPV4RcXuH-8SZPluilQ6tfygLDEVQeF8ltlrRMxEmjoUN9GKkPjfmyZzselmkAAAgAAAAAAAAAggEAAAAAAAAP_AUYQ29udGVudC1UeXBlIGFwcGxpY2F0aW9uL2pzb24WQXBwbGljYXRpb24YQ3liZXJDb25uZWN0FENvbnRlbnQtSWSAATg4ZTIwZDBkYmJiYzhiOGU4YjU2OTY2MDlkNTk4Nzk4Nzk3NWM3NTk5N2EzZTNiMzgyMTRhODMwNjM0ZDUwM2YcQ29udGVudC1EaWdlc3SAATg4ZTIwZDBkYmJiYzhiOGU4YjU2OTY2MDlkNTk4Nzk4Nzk3NWM3NTk5N2EzZTNiMzgyMTRhODMwNjM0ZDUwM2YcQ29udGVudC1BdXRob3Iicmp1aXpmZm9mdmlraWVhOTQOQ2hhaW5JZAQ1NhxDb250ZW50LVRhcmdldIABMzlmMDIxODgxZTczODZmOGQ3M2Q2ZWYyNTUzM2U2MDkxZjJhMDI1NmU0MjJiNGIzYzRlM2QzMzVjY2FlMTQ3ZQxTb3VyY2VIMTU1MzFmYTItMTIwNS00ZjYxLWI2ZTQtYzlmNjhlY2Y4MWY3AHsiY29udGVudCI6IntcIm9wXCI6XCJjb21tZW50XCIsXCJhZGRyZXNzXCI6XCIweDc4OTRmNWYyMWRmMjljZDlmOGVjYzhiZjRhNDMxZGM5NmY4NjMwM2JcIixcInRzXCI6MTY5MTQ2MDYyMzE4NyxcImNoYWluSWRcIjo1NixcImhhbmRsZVwiOlwicmp1aXpmZm9mdmlraWVhOTRcIixcInRhcmdldFwiOlwiMzlmMDIxODgxZTczODZmOGQ3M2Q2ZWYyNTUzM2U2MDkxZjJhMDI1NmU0MjJiNGIzYzRlM2QzMzVjY2FlMTQ3ZVwiLFwidGl0bGVcIjpcIkZsYXBweU1vb25iaXJkXCIsXCJib2R5XCI6XCJSZXdhcmRpbmcgZ2FtZS4gSSB3b24gc29tZXRoaW5nIG9mIHZhbHVlIGhlcmVcIn0iLCJkaWdlc3QiOiI4OGUyMGQwZGJiYmM4YjhlOGI1Njk2NjA5ZDU5ODc5ODc5NzVjNzU5OTdhM2UzYjM4MjE0YTgzMDYzNGQ1MDNmIiwic2lnbmF0dXJlIjoiMHhiYjBmMTJiNDE0ODE2ZWYyNWY4NzAxMDVlODc4MDc1MmE3ZGEwZjFjOGRmNmE1NjkxZTBlYjE5ZWM0NjYyZjYzOTA4MzJhODdhNzgzYzk4NzA3MTQzMzUyZmI3MDE5MzFkYWQ4ZmRjODA4OGM0YjY0MDdhY2M5NTIxM2VmNGEyMCIsInNpZ25pbmdLZXkiOnsicHVibGljS2V5IjoiTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFbWYwUXdFejBUemFkdnNKd0hxVm42RHhxWU0vcE00ZU9YWEJLOG95SW0wRDZBMHF5cGQ2SG9NWVNNTmJoYWtrUnRMYXJ5dWZhakMySEdXZnJEOExRTVE9PSIsImZvcm1hdCI6IlN1YmplY3RQdWJsaWNLZXlJbmZvIiwiYWxnb3JpdGhtIjoiRVMyNTYifSwic2lnbmluZ0tleUF1dGgiOnsiYWRkcmVzcyI6IjB4Nzg5NGY1ZjIxZGYyOWNkOWY4ZWNjOGJmNGE0MzFkYzk2Zjg2MzAzYiIsInNpZ25pbmdLZXlTaWduYXR1cmUiOiIweGEzODMxN2VjODBkNTc2MTVlNDMzM2E0ZjY3NDllY2NmMjRjNjhiMzQ4ZDNkOGU1MDg1MzU0MWZmYmJmY2M4NDM1ODY1MzA5YWFiMjFhMGQ1NmYzZmM4ZDQzOWNmMGJkN2Y2MDNmYmZmZTM2OThiZDMyMmI3OGM2ZDJmOWZkMTQyMWIiLCJzaWduaW5nS2V5TWVzc2FnZSI6IkkgYXV0aG9yaXplIEN5YmVyQ29ubmVjdCBmcm9tIHRoaXMgZGV2aWNlIHVzaW5nIHNpZ25pbmcga2V5OlxuTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFbWYwUXdFejBUemFkdnNKd0hxVm42RHhxWU0vcE00ZU9YWEJLOG95SW0wRDZBMHF5cGQ2SG9NWVNNTmJoYWtrUnRMYXJ5dWZhakMySEdXZnJEOExRTVE9PSJ9fQEAGixt6jqbfYhMDZuaEb-iQnO244jLCtg5ByP6kKS2gJzDS7kcKwwx9Kq1wnw8lU_mBlJbtALCsSjvroQKsmnHVR4CNtiBCiAJiBg_nVxLPNsh5aJm1nTHAil3eKeD0Sj6rBKwOAPgRcse-J3i4evxRZ5SoviWCBxdyW2LTD4yMCBqbyjX9b05xfXFWbRInsil5ODU49L3Cp2dN4dy0uWYS3xgvOv9dS7FcmGH_PtTMCAdn_EYJ0ToaBHnWLt_FCn1yQ3UeKyPXCao4tmLVsLCjZCCEsbZD5qZyXg_FNsEASyhsLS4pYS0aneJc2FRG4Iss0-efgLHDYphaLVALLSelXn-DTlGunwaHZO_bv23v4VG0ehkHOds4M6zZB6KVJFwCrmCTQJ-mGlw4I3UVCU7Dxu0xiN2LEfX0nb_Dqd8TVVnjXPLeyxrtUBdXXtVLjjB5rKdGz3F8pb_05AI0vHTUqSOwnCuu02QgKvMilLcshscmlvUfpTfmh-mHGBVFZGN-H6KvcOtcR6IuEOoUkavZ23jqwOUvhOGUiXwJqQFsDCtcMBNy8Btk8P3Nw11hHUSakrr3dA_6YgrLFhhP0DT72sXO6kByCZpWQ0sa65wLk1GPShAyuF3T9ei2jtlFBDghNAm-0-VXZXi6vvmEFx3GH4x4wQr-_eb2tZSAnyQ4HGc-BftbJWhOdPEW3IwfMr-LJD2MpO5M289kO-kpfKtoi6M3vFwLg28ndonzOyxQsVA2CqILlxDailsU6GDQDsYsgGRc3BJXAPkEF8ccKyJX6bCOOp26OWXPL6lHkEK-9XYVng-VUCCzFfyEIRBQ1Wk7n-AhJIT9J4u5FZeWF1JFEjh0YU1absTvlknN46f8LmFkK5CMh2BL9r47__m_YyoFCUoNR23DnileeJSRkDhSE9c2BwbBW90EOzJsIl4z_9qRUOENatjqeoY6jMd-shRLVVH8J2jgs_nsOVKQ87B9vzUwMGRiPM-7Udg1MsRQJxaI23DT5hXuPh4PH9rmnp6w2IhkidcrcMkbDZrg1rt70XJEtbNI0-13nhizSqNwZhNXAkm-Xh7qgTtsw9cpKm0CJ6I7eOEKcMVE6Xhabc1fZrUgTgNlh-TWFGOGLjun1OBtmYGTDz_XLmu6d4BvhmY7I7WOI7FDqZAIE74BCmigedpw2VC2CHLTmVFHmSp0mwMRxlm5Kmnie5AlPt-QGOZE5vDWU6qenIMHCsQUpD_dy3Xa2g8so3qN9N1hTudo5jTF7038O5atWXNZkOO-S5yItnbk_pUjgjiutFsm7BUCTlFcE9XhFxe4f7xJk-W6KVDq1_KAsMRVB4XyW2WtEzESaOhQ30YqQ-N-bJnOx6WaQAACAAAAAAAAACAAQAAAAAAAA_4BRhDb250ZW50LVR5cGUgYXBwbGljYXRpb24vanNvbhZBcHBsaWNhdGlvbhhDeWJlckNvbm5lY3QUQ29udGVudC1JZIABMDIwZWUyNjZkYjVmZmI1Zjg2ODMyMWU3NzVlNTA5NzJkOTA2MWM2OWI0NDRhMzZkNDg3NGI5MmNhZGE4ZDExMhxDb250ZW50LURpZ2VzdIABMDIwZWUyNjZkYjVmZmI1Zjg2ODMyMWU3NzVlNTA5NzJkOTA2MWM2OWI0NDRhMzZkNDg3NGI5MmNhZGE4ZDExMhxDb250ZW50LUF1dGhvch50Z3Zha3hnenJiZmhiMzkOQ2hhaW5JZAQ1NhxDb250ZW50LVRhcmdldIABMzlmMDIxODgxZTczODZmOGQ3M2Q2ZWYyNTUzM2U2MDkxZjJhMDI1NmU0MjJiNGIzYzRlM2QzMzVjY2FlMTQ3ZQxTb3VyY2VIMTU1MzFmYTItMTIwNS00ZjYxLWI2ZTQtYzlmNjhlY2Y4MWY3AHsiY29udGVudCI6IntcIm9wXCI6XCJjb21tZW50XCIsXCJhZGRyZXNzXCI6XCIweDMxMWI0OTBhOWFkYmZlMDkxZDYxYjkxNmQyYTA0ZTE5ZWI3NTM1MWJcIixcInRzXCI6MTY5MTQ2MDYyMjc5MCxcImNoYWluSWRcIjo1NixcImhhbmRsZVwiOlwidGd2YWt4Z3pyYmZoYjM5XCIsXCJ0YXJnZXRcIjpcIjM5ZjAyMTg4MWU3Mzg2ZjhkNzNkNmVmMjU1MzNlNjA5MWYyYTAyNTZlNDIyYjRiM2M0ZTNkMzM1Y2NhZTE0N2VcIixcInRpdGxlXCI6XCJGbGFwcHlNb29uYmlyZFwiLFwiYm9keVwiOlwiU28gZnVuIHRvIHBsYXkgaW4gbXkgc3BhcmUgdGltZS5cIn0iLCJkaWdlc3QiOiIwMjBlZTI2NmRiNWZmYjVmODY4MzIxZTc3NWU1MDk3MmQ5MDYxYzY5YjQ0NGEzNmQ0ODc0YjkyY2FkYThkMTEyIiwic2lnbmF0dXJlIjoiMHg1MzkyNmExYmMxZjAyNTg0YWRlNWQ3YmY0ZjMwNDRjMGZkYzBlYzA3NDk0NzdiNzlmZDZjMGIzZDUyNmUzNjBkNWZmMTE0MGFlMDI4M2QxMGM4OTY4MDNkMjQzMGM0YmQzZDM1MzBmYzdmYWZjMjExYzVlZWRmNjI5ZTViMTY5MiIsInNpZ25pbmdLZXkiOnsicHVibGljS2V5IjoiTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFeUg1YnBxSk00bjYrOFByVkM1SzU1KzlqWUg1Y0RSMmpDN1l0QnRpVzEwdFlzOXFJQ0MrVXdTSnJnUFJ3K2JkWTlUdTVQV3N2NWhQbDA1QUdCalIzYVE9PSIsImZvcm1hdCI6IlN1YmplY3RQdWJsaWNLZXlJbmZvIiwiYWxnb3JpdGhtIjoiRVMyNTYifSwic2lnbmluZ0tleUF1dGgiOnsiYWRkcmVzcyI6IjB4MzExYjQ5MGE5YWRiZmUwOTFkNjFiOTE2ZDJhMDRlMTllYjc1MzUxYiIsInNpZ25pbmdLZXlTaWduYXR1cmUiOiIweDJjODIzZDM2Zjc1OTI1NDhlYzIwMjFmNWY5MzI5YjgwYmRjYTE5NzY3Y2E3M2ZiMzRkZDA0NThkZWNmNjA2NGU0ODQ2NTVlMzdhNjI5NmMzNzIyZjU0MDA2MmIyOGZkYTJjZjViYjQzZjI5ZWI3NzcyOGI1MjVkMWRhMDQ4Y2M1MWMiLCJzaWduaW5nS2V5TWVzc2FnZSI6IkkgYXV0aG9yaXplIEN5YmVyQ29ubmVjdCBmcm9tIHRoaXMgZGV2aWNlIHVzaW5nIHNpZ25pbmcga2V5OlxuTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFeUg1YnBxSk00bjYrOFByVkM1SzU1KzlqWUg1Y0RSMmpDN1l0QnRpVzEwdFlzOXFJQ0MrVXdTSnJnUFJ3K2JkWTlUdTVQV3N2NWhQbDA1QUdCalIzYVE9PSJ9fQEAVe22xpr0te5AkkiA8f50iTw6qBGEUPe2Sm2vrdXcthcfV7pL8C27q2ON0m5CYzs137yK3kfFXxpkmEEzV1Ip17EwuNuofbdiw5uPm3HLp16N2q5uThzvz33xtv9AvcyYtb85rV9iuHdmGLv5BGZD9S333EragGxt9GTiaT-VCmDNP0g9D-FcBCJsnIBRV4ixTFJ95UBMTIXVYD6FiDh5HzeU884BMcHeo_etERYxRgT8qQbRv3um5-Cs0GYEeK7_CY3xNTrLXH4xs9QztMWzH9J9jauyPom6hH3ZhKToISrUY_cQrVeXYaVtVcaxFPEam4G4G-LNw1Y-xC6ccEOLgbxZyFk9s6F3RM7NyB_fhKHhBnKjtj6cIjVuRakTnXgi-S1p82Tr1SQFFq90HKsBdnvCAGeg4w4imxeYrRMqb9IOuHq11PLc5b4Rwzm3PUeDQ924HWcp_PKAsM9xFiBa4BE4P89mlAsK7hEF2vSqHt3vGrT-qyyM1BNS2b4_Nc5J9OijZlVrU1l_8FL7gve_p0Fw17ZoVYNQ5XiyQWyxfdlUQVwpKHvTkM9mOp64P-XIjM-VoxcaG00GvFVNTQjpASAA4_ATqt0W19hO6HnqJK6-1rYBLHu_vp46QL9oSplIud6sUu05rkyyl5a7IJ9d0CEQWDBwWMMrWSudsADSV3Oc-BftbJWhOdPEW3IwfMr-LJD2MpO5M289kO-kpfKtoi6M3vFwLg28ndonzOyxQsVA2CqILlxDailsU6GDQDsYsgGRc3BJXAPkEF8ccKyJX6bCOOp26OWXPL6lHkEK-9XYVng-VUCCzFfyEIRBQ1Wk7n-AhJIT9J4u5FZeWF1JFEjh0YU1absTvlknN46f8LmFkK5CMh2BL9r47__m_YyoFCUoNR23DnileeJSRkDhSE9c2BwbBW90EOzJsIl4z_9qRUOENatjqeoY6jMd-shRLVVH8J2jgs_nsOVKQ87B9vzUwMGRiPM-7Udg1MsRQJxaI23DT5hXuPh4PH9rmnp6w2IhkidcrcMkbDZrg1rt70XJEtbNI0-13nhizSqNwZhNXAkm-Xh7qgTtsw9cpKm0CJ6I7eOEKcMVE6Xhabc1fZrUgTgNlh-TWFGOGLjun1OBtmYGTDz_XLmu6d4BvhmY7I7WOI7FDqZAIE74BCmigedpw2VC2CHLTmVFHmSp0mwMRxlm5Kmnie5AlPt-QGOZE5vDWU6qenIMHCsQUpD_dy3Xa2g8so3qN9N1hTudo5jTF7038O5atWXNZkOO-S5yItnbk_pUjgjiutFsm7BUCTlFcE9XhFxe4f7xJk-W6KVDq1_KAsMRVB4XyW2WtEzESaOhQ30YqQ-N-bJnOx6WaQAACAAAAAAAAAB9AQAAAAAAAA_yBRhDb250ZW50LVR5cGUgYXBwbGljYXRpb24vanNvbhZBcHBsaWNhdGlvbhhDeWJlckNvbm5lY3QUQ29udGVudC1JZIABMjMzNjNjNzlkYjc0ZWU3NjRmYWRjOTc4MjZmMzllYzhiZTk1ZDAxMTFhYmUwZGM0ZDQ1M2ZiOGMwY2QzNTU1YxxDb250ZW50LURpZ2VzdIABMjMzNjNjNzlkYjc0ZWU3NjRmYWRjOTc4MjZmMzllYzhiZTk1ZDAxMTFhYmUwZGM0ZDQ1M2ZiOGMwY2QzNTU1YxxDb250ZW50LUF1dGhvchh6M2JsbWs0M2R2d3AOQ2hhaW5JZAQ1NhxDb250ZW50LVRhcmdldIABMzlmMDIxODgxZTczODZmOGQ3M2Q2ZWYyNTUzM2U2MDkxZjJhMDI1NmU0MjJiNGIzYzRlM2QzMzVjY2FlMTQ3ZQxTb3VyY2VIMTU1MzFmYTItMTIwNS00ZjYxLWI2ZTQtYzlmNjhlY2Y4MWY3AHsiY29udGVudCI6IntcIm9wXCI6XCJjb21tZW50XCIsXCJhZGRyZXNzXCI6XCIweGVjNTAyN2IwODgzNDQ3N2UxYWFhMGE5ZDZjYjA0ODBjNDMxY2M0OGNcIixcInRzXCI6MTY5MTQ2MDYyMjQ3NSxcImNoYWluSWRcIjo1NixcImhhbmRsZVwiOlwiejNibG1rNDNkdndwXCIsXCJ0YXJnZXRcIjpcIjM5ZjAyMTg4MWU3Mzg2ZjhkNzNkNmVmMjU1MzNlNjA5MWYyYTAyNTZlNDIyYjRiM2M0ZTNkMzM1Y2NhZTE0N2VcIixcInRpdGxlXCI6XCJGbGFwcHlNb29uYmlyZFwiLFwiYm9keVwiOlwiU28gZnVuIHRvIHBsYXkgaW4gbXkgc3BhcmUgdGltZS5cIn0iLCJkaWdlc3QiOiIyMzM2M2M3OWRiNzRlZTc2NGZhZGM5NzgyNmYzOWVjOGJlOTVkMDExMWFiZTBkYzRkNDUzZmI4YzBjZDM1NTVjIiwic2lnbmF0dXJlIjoiMHg2NDA3MjdhMDY3MGM4ODg3YTBlY2RkNGNiOGFlYzc3ZjYzMGQ4MGZiYmU2MTI2MzIxOGMyYjgxZjdmZTQ5ZTk3MDg4MjFlMTYzOWZjYjEyYWI2NjE2Mjg3MTQyZDkxMDgxNzE1MWNmMmQ0OGY4MTBmYjUwOWY1Yzc3ZmRhMjExNSIsInNpZ25pbmdLZXkiOnsicHVibGljS2V5IjoiTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFMEo5VHBSczlCcWJsMkgreldzcDNYOHUxUnVVYkpNdWZ6NlRUVU9pSnpTNThhSElBaUFyMkI2emwwaElTWnRsV3VvWndTQWNlakRmTlgwUllTOGZsK1E9PSIsImZvcm1hdCI6IlN1YmplY3RQdWJsaWNLZXlJbmZvIiwiYWxnb3JpdGhtIjoiRVMyNTYifSwic2lnbmluZ0tleUF1dGgiOnsiYWRkcmVzcyI6IjB4ZWM1MDI3YjA4ODM0NDc3ZTFhYWEwYTlkNmNiMDQ4MGM0MzFjYzQ4YyIsInNpZ25pbmdLZXlTaWduYXR1cmUiOiIweGNkMDVjODk3ODljMjZmYjgzMjFlY2RhMTVmMGU4MWI3YzYyYWQ3YTdiYzAxZmUzY2ZlNmVjYWJiODViM2M5N2UzNjg0MDBiYzEyN2RjMjcxNTVhNTExNmU0N2M5ODIxYzM3NThmNDI5OTJiZjQwNjliYzlmOTQ3YTkxMTFhOTNkMWMiLCJzaWduaW5nS2V5TWVzc2FnZSI6IkkgYXV0aG9yaXplIEN5YmVyQ29ubmVjdCBmcm9tIHRoaXMgZGV2aWNlIHVzaW5nIHNpZ25pbmcga2V5OlxuTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFMEo5VHBSczlCcWJsMkgreldzcDNYOHUxUnVVYkpNdWZ6NlRUVU9pSnpTNThhSElBaUFyMkI2emwwaElTWnRsV3VvWndTQWNlakRmTlgwUllTOGZsK1E9PSJ9fQEAjS_ANDSJ9qPGYwfqRMdaCw3jgEN2Gi3vXRIOHCnwOBSr9tVwn9kF0uRmjFgDQWpupyxX0XInkS8VsnU28L2jwAsvwg48_byHq5Eic-0jarZJgb17km-g1If85F8AJ3oZnifrCr86dhSbKq9eyMHb32vLAT5pV6DLzMYgOMag5l35l3_f75CPwDJeuZauv31cM0IY98Wt7m5P_K0edrB_UaY6VmCBR7FiuzCXqsDd_wTY6ynYI11eP1p-hNgSIUvA-ObmIP9tkvdT57PSLi4NuTk3RlLSLkFEhImZGjQ_JUyVV72HuYa5txnjBQQQ-36YL2MGejSdmyJBOHBMiYvge_11_zdsH0u-kNpGRR1hITVgRWQ911IUE3kjAq-qPdlVsmajhwZ1MDGAEdt3j6yug1_x3GKwYljPe05KmkdWfj_bNtN-5Xur9FSGgnMydBCHu75RRGytjtcLxadyFxojb2vBTGSZiLNXodZ8Hn9oPWmeCsg7sDskN2EZXmJrNkDFmYs627oqo4vOSHIkIvzNCmPYeZBE0qvGNxRgj_Sr3DAVPOf4ss_YpapS29jcd_qiTlnthxj7WG0YhKrw98YhTPeypUzEXUyekrTgW6OWlUnRjlYMwfPyEAuCUDFcCBQXfFColRD0-R03Hv1YiiUGf57nnnNAsWyD00Imv0lDzkSc-BftbJWhOdPEW3IwfMr-LJD2MpO5M289kO-kpfKtoi6M3vFwLg28ndonzOyxQsVA2CqILlxDailsU6GDQDsYsgGRc3BJXAPkEF8ccKyJX6bCOOp26OWXPL6lHkEK-9XYVng-VUCCzFfyEIRBQ1Wk7n-AhJIT9J4u5FZeWF1JFEjh0YU1absTvlknN46f8LmFkK5CMh2BL9r47__m_YyoFCUoNR23DnileeJSRkDhSE9c2BwbBW90EOzJsIl4z_9qRUOENatjqeoY6jMd-shRLVVH8J2jgs_nsOVKQ87B9vzUwMGRiPM-7Udg1MsRQJxaI23DT5hXuPh4PH9rmnp6w2IhkidcrcMkbDZrg1rt70XJEtbNI0-13nhizSqNwZhNXAkm-Xh7qgTtsw9cpKm0CJ6I7eOEKcMVE6Xhabc1fZrUgTgNlh-TWFGOGLjun1OBtmYGTDz_XLmu6d4BvhmY7I7WOI7FDqZAIE74BCmigedpw2VC2CHLTmVFHmSp0mwMRxlm5Kmnie5AlPt-QGOZE5vDWU6qenIMHCsQUpD_dy3Xa2g8so3qN9N1hTudo5jTF7038O5atWXNZkOO-S5yItnbk_pUjgjiutFsm7BUCTlFcE9XhFxe4f7xJk-W6KVDq1_KAsMRVB4XyW2WtEzESaOhQ30YqQ-N-bJnOx6WaQAABwAAAAAAAAAMAQAAAAAAAA2QBBhDb250ZW50LVR5cGUgYXBwbGljYXRpb24vanNvbhZBcHBsaWNhdGlvbhhDeWJlckNvbm5lY3QUQ29udGVudC1JZIABNDQ1ZjFiYjEyYmNiMGUyOTJjMmI2ODY0NWE4ZmZkOTJlMDg4NjY1ZGQ5MTQ1MzUxNzE1NDI2ZDRiMDMzNTdmMxxDb250ZW50LURpZ2VzdIABNDQ1ZjFiYjEyYmNiMGUyOTJjMmI2ODY0NWE4ZmZkOTJlMDg4NjY1ZGQ5MTQ1MzUxNzE1NDI2ZDRiMDMzNTdmMxxDb250ZW50LUF1dGhvchgxZXc4dnFoNW9wNTgOQ2hhaW5JZAQ1NgxTb3VyY2UIYXRlbQB7ImNvbnRlbnQiOiJ7XCJvcFwiOlwicG9zdFwiLFwiYWRkcmVzc1wiOlwiMHg0NzY1NjBjYTIzM2Q1NGEwYzdiZDI4ZTIwMmNhNThmZDFiZWYyY2ZhXCIsXCJ0c1wiOjE2OTE0NjA2MjI0MDYsXCJjaGFpbklkXCI6NTYsXCJoYW5kbGVcIjpcIjFldzh2cWg1b3A1OFwiLFwidGl0bGVcIjpcIjExMTEyXCIsXCJib2R5XCI6XCIyMjIyMjIyMjIyMjIyMjIyMjJcIn0iLCJkaWdlc3QiOiI0NDVmMWJiMTJiY2IwZTI5MmMyYjY4NjQ1YThmZmQ5MmUwODg2NjVkZDkxNDUzNTE3MTU0MjZkNGIwMzM1N2YzIiwic2lnbmF0dXJlIjoiMHhlMzQwZTdjNGJlOThjMGI5ZDFhMGY0MTZiN2MwZjZjMGQxNmIwYWY0ZDU5ZDA2NTBmMmEyNDUwYzlmMzczZmE3ZTJmNmMzYmIwZmY3NGQ5YzFmNmEzMGVmYzNlN2U5OWRmMjdiNzQ0MWQxMGNhNTE4YmY3NmFmNDFmZmU3NDVmMCIsInNpZ25pbmdLZXkiOnsicHVibGljS2V5IjoiTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFZzBXZXVmSjlsVlIwbkI4UmphcTQ5Y1IvZS8zVC9tb3FrRmVUZVRwOC91MXdVMEhNYWZPQ0hiYXVQdnIxY2JQV25uc1NwRS9wRFNwaFNxM25qRGdIakE9PSIsImZvcm1hdCI6IlN1YmplY3RQdWJsaWNLZXlJbmZvIiwiYWxnb3JpdGhtIjoiRVMyNTYifSwic2lnbmluZ0tleUF1dGgiOnsiYWRkcmVzcyI6IjB4NDc2NTYwY2EyMzNkNTRhMGM3YmQyOGUyMDJjYTU4ZmQxYmVmMmNmYSIsInNpZ25pbmdLZXlTaWduYXR1cmUiOiIweGRjYTM2Mzk2ZDU2YjYyOWM4YTllYzI2MmIyNjBjM2UzN2UxN2EwNjUyNDgwZmVmYTU1YjZjNjhjNzYyMGFiY2IwYThkYjU1NDU2ODU1NjQxY2FlOTQ4N2Y1MjQxNTFiZWU0MzU4NjNlNWFhMzJiNjYxNDVlNWQwMmNmNWI5YmIzMWMiLCJzaWduaW5nS2V5TWVzc2FnZSI6IkkgYXV0aG9yaXplIEF0ZW1SZXZpZXcgZnJvbSB0aGlzIGRldmljZSB1c2luZyBzaWduaW5nIGtleTpcbk1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRWcwV2V1Zko5bFZSMG5COFJqYXE0OWNSL2UvM1QvbW9xa0ZlVGVUcDgvdTF3VTBITWFmT0NIYmF1UHZyMWNiUFdubnNTcEUvcERTcGhTcTNuakRnSGpBPT0ifX0BAF5tG_z6kTUSr0cm1CpC4QUD42yGABVMBxe5C1rRHTxzEe3yspvU5_PIY_ydnMRLIv3QbUUZ_GqOgd2QDiB2O-BzGtz4xqhNQAP62eEwcs0NbX9npyDvR5Xy9UMH5HI0XCQuNGyR12AxuB6J6dJxkLR18HKRGh_4sMN_VWq0zxEjexiuLkd1J0XwG5CwZPuC9tj2Cnj11P2KOluZY8X-vTFrXF3BKsJfx8oa8xwwo56863gxfkgDl3MkQJFE4r-l6if8KmRr0DBNlg8G_nLmVvyY0sOBkRf5W6wlV1Sf_8C3dJh0SjP0d5ijIyu2kL2j1PQyixUnLxz-ja7utT8fvB-2RITM1ddVrbgwv99cT1jk0nSKu_1qvYy8HyshiY6siSYrR5-8TgYIT6W72vcHqZjQATqfWg4P3uFkfx5bVVNvzc3U6ED9VZowhbdOciRxECiyeH3pljRPlVzQkyWf3m641gQaZ_6N60zOMtICO0rOkSDeB4eJvqQ8FTo67Fkntw0iQfclZI2l-WOGP4GlAfK2sk3_AkSAzXnEOEUGr05nw01XdHD9UjGukHdhSOGSTDFgY0A1kkxVX9SLG3H_ZfJ0yCfTZh-SNA9G5HMW_91RzMF5Mq4uGn-CxqOGhHMBq6w77EjS5cRGS8Y91d4RqCW-2hufD9Q_pKj4lUga1k5EnPgX7WyVoTnTxFtyMHzK_iyQ9jKTuTNvPZDvpKXyraIujN7xcC4NvJ3aJ8zssULFQNgqiC5cQ2opbFOhg0A7GLIBkXNwSVwD5BBfHHCsiV-mwjjqdujllzy-pR5BCvvV2FZ4PlVAgsxX8hCEQUNVpO5_gISSE_SeLuRWXlhdSRRI4dGFNWm7E75ZJzeOn_C5hZCuQjIdgS_a-O__5v2MqBQlKDUdtw54pXniUkZA4UhPXNgcGwVvdBDsybCJeM__akVDhDWrY6nqGOozHfrIUS1VR_Cdo4LP57DlSkPOwfb81MDBkYjzPu1HYNTLEUCcWiNtw0-YV7j4eDx_a5p6esNiIZInXK3DJGw2a4Na7e9FyRLWzSNPtd54Ys0qjcGYTVwJJvl4e6oE7bMPXKSptAieiO3jhCnDFROl4Wm3NX2a1IE4DZYfk1hRjhi47p9TgbZmBkw8_1y5runeAb4ZmOyO1jiOxQ6mQCBO-AQpooHnacNlQtghy05lRR5kqdJsDEcZZuSpp4nuQJT7fkBjmRObw1lOqnpyDBwrEFKQ_3ct12toPLKN6jfTdYU7naOY0xe9N_DuWrVlzWZDjvkuciLZ25P6VI4I4rrRbJuwVAk5RXBPV4RcXuH-8SZPluilQ6tfygLDEVQeF8ltlrRMxEmjoUN9GKkPjfmyZzselmkAAAgAAAAAAAAAfQEAAAAAAAAP8gUYQ29udGVudC1UeXBlIGFwcGxpY2F0aW9uL2pzb24WQXBwbGljYXRpb24YQ3liZXJDb25uZWN0DFNvdXJjZUgxNTUzMWZhMi0xMjA1LTRmNjEtYjZlNC1jOWY2OGVjZjgxZjcUQ29udGVudC1JZIABMTFlNTc1NGJkMmVhNzAzODhmZWQ3MzhkYjg3ZWU3NjRmZjNiNzY2ZjA2MzdhZGVjYTJhYjUyYWQzODUwMDBjMRxDb250ZW50LURpZ2VzdIABMTFlNTc1NGJkMmVhNzAzODhmZWQ3MzhkYjg3ZWU3NjRmZjNiNzY2ZjA2MzdhZGVjYTJhYjUyYWQzODUwMDBjMRxDb250ZW50LUF1dGhvchhlZm9qdXl5NGF2NncOQ2hhaW5JZAQ1NhxDb250ZW50LVRhcmdldIABMzlmMDIxODgxZTczODZmOGQ3M2Q2ZWYyNTUzM2U2MDkxZjJhMDI1NmU0MjJiNGIzYzRlM2QzMzVjY2FlMTQ3ZQB7ImNvbnRlbnQiOiJ7XCJvcFwiOlwiY29tbWVudFwiLFwiYWRkcmVzc1wiOlwiMHgzYTAwNjVlYTI1NzA2MzA2OTUyOTI1NjI5MmQxOTQ0NmIwNTI2NDgwXCIsXCJ0c1wiOjE2OTE0NjA2MjI2MTMsXCJjaGFpbklkXCI6NTYsXCJoYW5kbGVcIjpcImVmb2p1eXk0YXY2d1wiLFwidGFyZ2V0XCI6XCIzOWYwMjE4ODFlNzM4NmY4ZDczZDZlZjI1NTMzZTYwOTFmMmEwMjU2ZTQyMmI0YjNjNGUzZDMzNWNjYWUxNDdlXCIsXCJ0aXRsZVwiOlwiRmxhcHB5TW9vbmJpcmRcIixcImJvZHlcIjpcIlNvIGZ1biB0byBwbGF5IGluIG15IHNwYXJlIHRpbWUuXCJ9IiwiZGlnZXN0IjoiMTFlNTc1NGJkMmVhNzAzODhmZWQ3MzhkYjg3ZWU3NjRmZjNiNzY2ZjA2MzdhZGVjYTJhYjUyYWQzODUwMDBjMSIsInNpZ25hdHVyZSI6IjB4NmIzOWM3NWE2NTJkY2RkY2MzOWI2ODRhMjE2NWQ4MDM2YjM3ZDVhMzEyNzU4Zjg2M2MyN2JlNDMxMTlmMDc1M2YzMmI0NTlhOTYwY2MyY2U4OWI0NGQ2OTQ1ZGRiMGUxZDMzZTQwZjQzMmJkZmNmYzdmMGRlYTgwZDQyMmQxMzUiLCJzaWduaW5nS2V5Ijp7InB1YmxpY0tleSI6Ik1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRU1RdVhEWmVoZzZ4dTVFYkIyVVhSMXNlTkdkYlVXbkQydnlSSVM5Tm42cmxLb0IzWGZSbkkyaDcybWhma2dPdlVkL0lBazRMdU5kTENoTHNKaFl1Zk53PT0iLCJmb3JtYXQiOiJTdWJqZWN0UHVibGljS2V5SW5mbyIsImFsZ29yaXRobSI6IkVTMjU2In0sInNpZ25pbmdLZXlBdXRoIjp7ImFkZHJlc3MiOiIweDNhMDA2NWVhMjU3MDYzMDY5NTI5MjU2MjkyZDE5NDQ2YjA1MjY0ODAiLCJzaWduaW5nS2V5U2lnbmF0dXJlIjoiMHg5MDNhZTI4MTc3YWY3OGIxY2Q2YTUzYmNiNDA2ZDZmMWE2YzVlYTljOTE3MWFjZGIyZjc0NWNmNzY3ZjUyYzAyMjY2YzIxNDYzZTM4Yjc3Yzk4NDA1MWQ0N2E3ZDI0NTE4NGI5MWEyYjM5ZjM2YTg2NzJlN2U1OGIxYTRmZTA0NjFjIiwic2lnbmluZ0tleU1lc3NhZ2UiOiJJIGF1dGhvcml6ZSBDeWJlckNvbm5lY3QgZnJvbSB0aGlzIGRldmljZSB1c2luZyBzaWduaW5nIGtleTpcbk1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRU1RdVhEWmVoZzZ4dTVFYkIyVVhSMXNlTkdkYlVXbkQydnlSSVM5Tm42cmxLb0IzWGZSbkkyaDcybWhma2dPdlVkL0lBazRMdU5kTENoTHNKaFl1Zk53PT0ifX0BAAeYocX7Tk16BmNXXb4MzoM4xgy3COlpbKLqjP-BdHL6wGd7LecNcw7tsBs-sckTa05SVBzsnDR3t0S097ss7d3UxqqjAjf6QuR_K_UMD98mK3F1XLLWPe2WUR4SADtS8kXRRabLk45iecpe4i4hQf6R-IIw2kJKg3f54IU0pE-E0gNH-wG0YIaLfpZRLUGvkkWsHPh31bPott62_pYqeIuE9FDrlnhkUyBlkxjBVkiXe4vfduOyvQFacKOdmDtDhLcNEkKAqlW1AcdC0D-n3k9lmsTFwO2CtSZ_KSQjptGgrlK3cI_TR6jBU9c-jyh_WHYYqSDfUjxS5Cp1jFPmGDvuR8X3HiUO1vC5ipRIwB_skNV-YWNtTibdhQOeJhw8PzJbuXJ-c9UVxSn4gIr5erT1E4Ab_OKSQZQ2kOCUTw4AISSJHuKLMX1BWFagwoQumZ8BQWsjfu1x6kZwtuhrxe6GcZu9hg2QWC1sCZrgqOvJmPeYEvkP2eDPsC1Ae-YqGqrdVZmpPAWWk3OvzymtmkP2ieP3yUI3P7SiNOHKfHDQlc_cBKkFYyhj_ZOqGvundRm1KyMhaYW4EQ07mB3O2URqmT0uqiVRbTMhGeZ8mB1XmPVC3ERQa1k24ZoELn6BmcGfdtp8ISobfVYXE6CizI7xUcXIBtgvjX7LUpscpUTxnPgX7WyVoTnTxFtyMHzK_iyQ9jKTuTNvPZDvpKXyraIujN7xcC4NvJ3aJ8zssULFQNgqiC5cQ2opbFOhg0A7GLIBkXNwSVwD5BBfHHCsiV-mwjjqdujllzy-pR5BCvvV2FZ4PlVAgsxX8hCEQUNVpO5_gISSE_SeLuRWXlhdSRRI4dGFNWm7E75ZJzeOn_C5hZCuQjIdgS_a-O__5v2MqBQlKDUdtw54pXniUkZA4UhPXNgcGwVvdBDsybCJeM__akVDhDWrY6nqGOozHfrIUS1VR_Cdo4LP57DlSkPOwfb81MDBkYjzPu1HYNTLEUCcWiNtw0-YV7j4eDx_a5p6esNiIZInXK3DJGw2a4Na7e9FyRLWzSNPtd54Ys0qjcGYTVwJJvl4e6oE7bMPXKSptAieiO3jhCnDFROl4Wm3NX2a1IE4DZYfk1hRjhi47p9TgbZmBkw8_1y5runeAb4ZmOyO1jiOxQ6mQCBO-AQpooHnacNlQtghy05lRR5kqdJsDEcZZuSpp4nuQJT7fkBjmRObw1lOqnpyDBwrEFKQ_3ct12toPLKN6jfTdYU7naOY0xe9N_DuWrVlzWZDjvkuciLZ25P6VI4I4rrRbJuwVAk5RXBPV4RcXuH-8SZPluilQ6tfygLDEVQeF8ltlrRMxEmjoUN9GKkPjfmyZzselmkAAAgAAAAAAAAAfQEAAAAAAAAP8gUYQ29udGVudC1UeXBlIGFwcGxpY2F0aW9uL2pzb24WQXBwbGljYXRpb24YQ3liZXJDb25uZWN0HENvbnRlbnQtRGlnZXN0gAFkZjg2OWU5ZDhjYjg2ZTY0OTc5N2VkNjRlNjk3NDhhMmQyZWZkYjkzMmY2NTc5ZGUwZDdhY2JlZmJkYmZkY2EwHENvbnRlbnQtQXV0aG9yGGs2Mjk3MjcxMjk4cQ5DaGFpbklkBDU2HENvbnRlbnQtVGFyZ2V0gAEzOWYwMjE4ODFlNzM4NmY4ZDczZDZlZjI1NTMzZTYwOTFmMmEwMjU2ZTQyMmI0YjNjNGUzZDMzNWNjYWUxNDdlDFNvdXJjZUgxNTUzMWZhMi0xMjA1LTRmNjEtYjZlNC1jOWY2OGVjZjgxZjcUQ29udGVudC1JZIABZGY4NjllOWQ4Y2I4NmU2NDk3OTdlZDY0ZTY5NzQ4YTJkMmVmZGI5MzJmNjU3OWRlMGQ3YWNiZWZiZGJmZGNhMAB7ImNvbnRlbnQiOiJ7XCJvcFwiOlwiY29tbWVudFwiLFwiYWRkcmVzc1wiOlwiMHg4ZDJhMzU2MWQ5OGNkMGJmYzUwNDY0NjQzNGY3OWJmMzM1NDRmOGQzXCIsXCJ0c1wiOjE2OTE0NjA2MjM1NjgsXCJjaGFpbklkXCI6NTYsXCJoYW5kbGVcIjpcIms2Mjk3MjcxMjk4cVwiLFwidGFyZ2V0XCI6XCIzOWYwMjE4ODFlNzM4NmY4ZDczZDZlZjI1NTMzZTYwOTFmMmEwMjU2ZTQyMmI0YjNjNGUzZDMzNWNjYWUxNDdlXCIsXCJ0aXRsZVwiOlwiRmxhcHB5TW9vbmJpcmRcIixcImJvZHlcIjpcIlNvIGZ1biB0byBwbGF5IGluIG15IHNwYXJlIHRpbWUuXCJ9IiwiZGlnZXN0IjoiZGY4NjllOWQ4Y2I4NmU2NDk3OTdlZDY0ZTY5NzQ4YTJkMmVmZGI5MzJmNjU3OWRlMGQ3YWNiZWZiZGJmZGNhMCIsInNpZ25hdHVyZSI6IjB4YmU3NDljYTI2MmUyMjdiMjY2ZGVmZTU4OGU1Njk4NGQyOThjNzYwYmJlZTkwMWRmN2UyNzg2YjFmNDIwOWI3MWRiNDJkYjFmY2I4YWE4MDkxMDcwYTAzMDQ0MmM3ODk0NWUxNzhjMDkwYTUyZjViYjQ2NDU5OTgxMjJjNWZhNGIiLCJzaWduaW5nS2V5Ijp7InB1YmxpY0tleSI6Ik1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRTJ6M3dPMlovMzZVL2VCY1hZRDRrd0E1Y1BPYTdJSHBQWXIraHNtdk9TQUczRldiOVQ2dnZvKy9VZ2hjV2RSTndldlBPSE9oKzM4aWl5a1lTZUxlbVd3PT0iLCJmb3JtYXQiOiJTdWJqZWN0UHVibGljS2V5SW5mbyIsImFsZ29yaXRobSI6IkVTMjU2In0sInNpZ25pbmdLZXlBdXRoIjp7ImFkZHJlc3MiOiIweDhkMmEzNTYxZDk4Y2QwYmZjNTA0NjQ2NDM0Zjc5YmYzMzU0NGY4ZDMiLCJzaWduaW5nS2V5U2lnbmF0dXJlIjoiMHg1NTc2YWJhODg0YWZlOTQ4NGI3NDMwZmNjNWRhNTVlNWY2YzhlN2ZlZjZmNzk3MDQ3YjZjNGFiZWJjOGU3NDI5NmEwYWM3ZDg4YTI1NzZkZjFiN2EwZDQxNzFlZTRhNThlMWNhOTA3MGRkYjg4ZGY0ZDUzNjE5MzQ1OTIwODI2NDFjIiwic2lnbmluZ0tleU1lc3NhZ2UiOiJJIGF1dGhvcml6ZSBDeWJlckNvbm5lY3QgZnJvbSB0aGlzIGRldmljZSB1c2luZyBzaWduaW5nIGtleTpcbk1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRTJ6M3dPMlovMzZVL2VCY1hZRDRrd0E1Y1BPYTdJSHBQWXIraHNtdk9TQUczRldiOVQ2dnZvKy9VZ2hjV2RSTndldlBPSE9oKzM4aWl5a1lTZUxlbVd3PT0ifX0BACqKIykjdRZ7vVeH7oUdxMWH-OifIAKwKKcsMS1QLX5dJVfsutQyXfnJjYAK0VKxXTw5FKYEsYWYjgc7DZFL6WPVwWvMTcUA9Opmc1f7qtOwiU_4j7F8bRCpTdw8Wzx-WDX1-l35Brb24bEI-m2hV8ahMeP3DRb0lMRou22SOgzwC9E4I5vlEfak5ANSIdXznBbSs_ydGNnmnvrCwTRgBTuDVFNRX6FdV_V7DsaWumnDujmR0q6XNXwx79ZIp7x0eTvbUM0Ih0DqFPcerAZtlCNYVUdGpI3Ea9hMqiKQgjYKYi6SmwOcoq7D7WSNKXtDh6AavyFDje6SKBCWIZYh-mG3be4XUG8-niZoVgBuzdgSwXaSv_KgPOiQKH-kHK8eg1F5YqhXz3r6r42LbPpCZO1JuxaMqFK1pTRh_4jZ5PL5gjfbXjyEAApmdZf_UHZkSQ5mJ4xgBMBPSr-SXqOx3YcVIDBT_HhVaYXNT8mpsshLpo7nqir2nxdi7VROjvPZRTB3SF5T9z0JvN1_vuhNfVjTkLYWS_KfRduC3SAa5lMupv46lhMNXb4SC-Kmp3KcX7LoonkQ7Ee_qzjybeJCntpN4BMaRktf03UTU7CDhvsuxiPvDgLTBq0i3s_cuB2d2e0cN0kGgpfWxKnBhx8YgecXIXNoiM64pZNkfUpRRNjEnPgX7WyVoTnTxFtyMHzK_iyQ9jKTuTNvPZDvpKXyraIujN7xcC4NvJ3aJ8zssULFQNgqiC5cQ2opbFOhg0A7GLIBkXNwSVwD5BBfHHCsiV-mwjjqdujllzy-pR5BCvvV2FZ4PlVAgsxX8hCEQUNVpO5_gISSE_SeLuRWXlhdSRRI4dGFNWm7E75ZJzeOn_C5hZCuQjIdgS_a-O__5v2MqBQlKDUdtw54pXniUkZA4UhPXNgcGwVvdBDsybCJeM__akVDhDWrY6nqGOozHfrIUS1VR_Cdo4LP57DlSkPOwfb81MDBkYjzPu1HYNTLEUCcWiNtw0-YV7j4eDx_a5p6esNiIZInXK3DJGw2a4Na7e9FyRLWzSNPtd54Ys0qjcGYTVwJJvl4e6oE7bMPXKSptAieiO3jhCnDFROl4Wm3NX2a1IE4DZYfk1hRjhi47p9TgbZmBkw8_1y5runeAb4ZmOyO1jiOxQ6mQCBO-AQpooHnacNlQtghy05lRR5kqdJsDEcZZuSpp4nuQJT7fkBjmRObw1lOqnpyDBwrEFKQ_3ct12toPLKN6jfTdYU7naOY0xe9N_DuWrVlzWZDjvkuciLZ25P6VI4I4rrRbJuwVAk5RXBPV4RcXuH-8SZPluilQ6tfygLDEVQeF8ltlrRMxEmjoUN9GKkPjfmyZzselmkAAAgAAAAAAAAAfQEAAAAAAAAP8gUYQ29udGVudC1UeXBlIGFwcGxpY2F0aW9uL2pzb24WQXBwbGljYXRpb24YQ3liZXJDb25uZWN0DkNoYWluSWQENTYcQ29udGVudC1UYXJnZXSAATM5ZjAyMTg4MWU3Mzg2ZjhkNzNkNmVmMjU1MzNlNjA5MWYyYTAyNTZlNDIyYjRiM2M0ZTNkMzM1Y2NhZTE0N2UMU291cmNlSDE1NTMxZmEyLTEyMDUtNGY2MS1iNmU0LWM5ZjY4ZWNmODFmNxRDb250ZW50LUlkgAExMzgxNjQyZmEwZmVmOTE1ODZlYTIzMmU2MDEwMDcyODFmOGQ2NmU5ODBiYmE5NmEzNmYxMTMyODNjN2EwOTAxHENvbnRlbnQtRGlnZXN0gAExMzgxNjQyZmEwZmVmOTE1ODZlYTIzMmU2MDEwMDcyODFmOGQ2NmU5ODBiYmE5NmEzNmYxMTMyODNjN2EwOTAxHENvbnRlbnQtQXV0aG9yGGk3bnJsdWI2cXl2bQB7ImNvbnRlbnQiOiJ7XCJvcFwiOlwiY29tbWVudFwiLFwiYWRkcmVzc1wiOlwiMHhmNTlkOTY1YTQ5ZjFlZmQxZTA2ZGVmZjUxOTRmZWE4OTQ1NzEwOWUwXCIsXCJ0c1wiOjE2OTE0NjA2MjMzNjEsXCJjaGFpbklkXCI6NTYsXCJoYW5kbGVcIjpcImk3bnJsdWI2cXl2bVwiLFwidGFyZ2V0XCI6XCIzOWYwMjE4ODFlNzM4NmY4ZDczZDZlZjI1NTMzZTYwOTFmMmEwMjU2ZTQyMmI0YjNjNGUzZDMzNWNjYWUxNDdlXCIsXCJ0aXRsZVwiOlwiRmxhcHB5TW9vbmJpcmRcIixcImJvZHlcIjpcIlNvIGZ1biB0byBwbGF5IGluIG15IHNwYXJlIHRpbWUuXCJ9IiwiZGlnZXN0IjoiMTM4MTY0MmZhMGZlZjkxNTg2ZWEyMzJlNjAxMDA3MjgxZjhkNjZlOTgwYmJhOTZhMzZmMTEzMjgzYzdhMDkwMSIsInNpZ25hdHVyZSI6IjB4NGI5ZDgwMDlkOTk5ZDk4ZTE2OWM0OWVhZmM5YTljMWU1YTRlYThjNzM0YWIzOTMzMzUyZTM1YWM0MGM2MDkyOTc2ZDQ0NGM4NjEzNzNjY2JjMmZkMTk3NzNjNzczYjMxMzhlMTcyZmQyOWUxMTQ5MTUwZjVjMWNkNzdmNWQ5MGMiLCJzaWduaW5nS2V5Ijp7InB1YmxpY0tleSI6Ik1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRUZMOVppSHM2YU5ram8xUGZENlEzempUZDNaWXRYaEZnaldiK1hoRUFPU3VnWEVLaG9HbnExTlZ6cVdCUmtoUzBlUVhOU2lDNFNaWEMreWdIZGZUYlNBPT0iLCJmb3JtYXQiOiJTdWJqZWN0UHVibGljS2V5SW5mbyIsImFsZ29yaXRobSI6IkVTMjU2In0sInNpZ25pbmdLZXlBdXRoIjp7ImFkZHJlc3MiOiIweGY1OWQ5NjVhNDlmMWVmZDFlMDZkZWZmNTE5NGZlYTg5NDU3MTA5ZTAiLCJzaWduaW5nS2V5U2lnbmF0dXJlIjoiMHhmMTAxYTM2YzQyY2VkYWRiYTY5ZDgxODFiNmY3Zjk4Y2E3YTk1ZmNmYmJkZTdiODhhOWMyNWFlODU1YTllMDIwNjY2MjNkODVlN2FkZDI1NTFmNGViZDAzMzE1MTQxMTAzMWEwYzdiYTEyMGE1MGFkMDQyYWNjM2YyOTZmYTY1NzFjIiwic2lnbmluZ0tleU1lc3NhZ2UiOiJJIGF1dGhvcml6ZSBDeWJlckNvbm5lY3QgZnJvbSB0aGlzIGRldmljZSB1c2luZyBzaWduaW5nIGtleTpcbk1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRUZMOVppSHM2YU5ram8xUGZENlEzempUZDNaWXRYaEZnaldiK1hoRUFPU3VnWEVLaG9HbnExTlZ6cVdCUmtoUzBlUVhOU2lDNFNaWEMreWdIZGZUYlNBPT0ifX0BAJIV9ru-TGGcmlue53pB48ubXZH_Vr_DLruV4_hsFH4oZp58ukQk0Djvp6Rp_ek3UFurRO0Zd5knd-ZYPdqSnscOQmC7IU4-RALBvKPn8Qe35gg_EvBPiT542qbvY6Us9H0atkuVU78coX8U07LuOg9OUXInA6wJHqmATDSzHCfRQTHqTkZtppPhZMJZ4xvvSAU1bzpIxRA40bnARhIFnplaf1Kjv_NRX_WXl9LMbWvHz_bKa1JyMAoxaIMh8Lp_u_qr2OZXh-i7_dEClCbjsXurFoCOexZVEFaRtVLMm9c5jK4I4Q1f75KEkL-bXuEZVRKDhVgYimsjVD8Lpje16sqhg9AHqRFOJ5ahkXLxYaske-wMUMNaW48O3H0ylCqOacT9eCaNr5Ywc5oDlpFUk0nvdOVqvCTc-ybgiDfxmwykOIVvyYOHFQsUOgs_VuZEb7QsRojVkn_8sPbJ1QKMhy6ZWQN_xc3MVY-580juS-TOPZd1PAtW-2AjezkEeGdBW6J_U1KSXREUylLXczT1RP02mZp3BklCLqNWz1SmmiHRCGb4Ukl-7LKdpeLG2EvgNPOuZKcvaeUKzv0sZ4QHu-FrxCuJNupM6vAJNRCTfhAfn4nVmPNRCuFsC2QqXJkIMVfYp3hLX35HV3PiZ1c6OlbQ5tzVeVJwCuwgf85EhCfqnPgX7WyVoTnTxFtyMHzK_iyQ9jKTuTNvPZDvpKXyraIujN7xcC4NvJ3aJ8zssULFQNgqiC5cQ2opbFOhg0A7GLIBkXNwSVwD5BBfHHCsiV-mwjjqdujllzy-pR5BCvvV2FZ4PlVAgsxX8hCEQUNVpO5_gISSE_SeLuRWXlhdSRRI4dGFNWm7E75ZJzeOn_C5hZCuQjIdgS_a-O__5v2MqBQlKDUdtw54pXniUkZA4UhPXNgcGwVvdBDsybCJeM__akVDhDWrY6nqGOozHfrIUS1VR_Cdo4LP57DlSkPOwfb81MDBkYjzPu1HYNTLEUCcWiNtw0-YV7j4eDx_a5p6esNiIZInXK3DJGw2a4Na7e9FyRLWzSNPtd54Ys0qjcGYTVwJJvl4e6oE7bMPXKSptAieiO3jhCnDFROl4Wm3NX2a1IE4DZYfk1hRjhi47p9TgbZmBkw8_1y5runeAb4ZmOyO1jiOxQ6mQCBO-AQpooHnacNlQtghy05lRR5kqdJsDEcZZuSpp4nuQJT7fkBjmRObw1lOqnpyDBwrEFKQ_3ct12toPLKN6jfTdYU7naOY0xe9N_DuWrVlzWZDjvkuciLZ25P6VI4I4rrRbJuwVAk5RXBPV4RcXuH-8SZPluilQ6tfygLDEVQeF8ltlrRMxEmjoUN9GKkPjfmyZzselmkAAAcAAAAAAAAADAEAAAAAAAANkAQYQ29udGVudC1UeXBlIGFwcGxpY2F0aW9uL2pzb24WQXBwbGljYXRpb24YQ3liZXJDb25uZWN0HENvbnRlbnQtQXV0aG9yGHp1dXBta2JuZXBudQ5DaGFpbklkBDU2DFNvdXJjZQhhdGVtFENvbnRlbnQtSWSAATk2MjIzMzVlNGEyZmQ4ZDZkMzM5ZmM4YzBlMzRjN2I1NWI4ODM0NzM4NjI4NDM5ZjFlYzEyYjRhZTkwYmVmNTEcQ29udGVudC1EaWdlc3SAATk2MjIzMzVlNGEyZmQ4ZDZkMzM5ZmM4YzBlMzRjN2I1NWI4ODM0NzM4NjI4NDM5ZjFlYzEyYjRhZTkwYmVmNTEAeyJjb250ZW50Ijoie1wib3BcIjpcInBvc3RcIixcImFkZHJlc3NcIjpcIjB4MmQ3ZDhjOWYzMWE4OWQ5MjQ4ZjY2MjkzOTM2N2M4OTY1NzBmZTg0OFwiLFwidHNcIjoxNjkxNDYwNjIzNjQ1LFwiY2hhaW5JZFwiOjU2LFwiaGFuZGxlXCI6XCJ6dXVwbWtibmVwbnVcIixcInRpdGxlXCI6XCIxMTExMlwiLFwiYm9keVwiOlwiMjIyMjIyMjIyMjIyMjIyMjIyXCJ9IiwiZGlnZXN0IjoiOTYyMjMzNWU0YTJmZDhkNmQzMzlmYzhjMGUzNGM3YjU1Yjg4MzQ3Mzg2Mjg0MzlmMWVjMTJiNGFlOTBiZWY1MSIsInNpZ25hdHVyZSI6IjB4NjIxODY5YjQ5YjkwZjcyYzlmYzQyZGU3MTMyMTJhYmFiMDc3Mzc2MzA4OTA4ZmFjMjMxMjQwNmEyMWU3MzFmY2RkYzNjYjhkMDg1NTkxYmRiZDU0NWQyNzYyOWJlY2Y2NTJlNTMyZWEwODk0ZjIzM2Q2MWEwZmZmNGJiYzRlMzIiLCJzaWduaW5nS2V5Ijp7InB1YmxpY0tleSI6Ik1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRVJ0MEVUQVNrVlN6U1BEWXFDOC9jeEpINDFmbEJpQnFqdUJuZGpYbmJZbEdiTUw5SVdIK3B4M25veXZ6a2RKSkVNbHJXRzNEVHdRNHd0SFlaZ2Y0aURnPT0iLCJmb3JtYXQiOiJTdWJqZWN0UHVibGljS2V5SW5mbyIsImFsZ29yaXRobSI6IkVTMjU2In0sInNpZ25pbmdLZXlBdXRoIjp7ImFkZHJlc3MiOiIweDJkN2Q4YzlmMzFhODlkOTI0OGY2NjI5MzkzNjdjODk2NTcwZmU4NDgiLCJzaWduaW5nS2V5U2lnbmF0dXJlIjoiMHg1MzBjMmM1NTVhNzZiNjBkOWM0ZmY1ZTJjMzI0NWFlMjEyZWE5MjU1OTRkMDZlYmNhNWRhZThhMTg2MTJkYWZhMmY3MzA0ZjU3NjcxMzMzNzg5NmUwMzNlMDNiZWM4OTQ4MTZhYWYxNGJkNjYwNjE0NDUxMmM2NmU3NzJkNzNkNjFjIiwic2lnbmluZ0tleU1lc3NhZ2UiOiJJIGF1dGhvcml6ZSBBdGVtUmV2aWV3IGZyb20gdGhpcyBkZXZpY2UgdXNpbmcgc2lnbmluZyBrZXk6XG5NRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUVSdDBFVEFTa1ZTelNQRFlxQzgvY3hKSDQxZmxCaUJxanVCbmRqWG5iWWxHYk1MOUlXSCtweDNub3l2emtkSkpFTWxyV0czRFR3UTR3dEhZWmdmNGlEZz09In19AQBePN4annyUzab45W_nr9HokFZKBc2RdXXnJeSh9LX2tvUTTdyXFSWiGf9TNeKzvZvFmddjiHlHG2l0kIbzUBoZwY6cfN2RvVviW1VqnS-Xwm7uoJb-CrDHE5qj3rG8vZcwMvC0lziU-R21RIaO7Qw8Mq8_l8q699HIr5FRqsiC2OESp9bRTURCHK0njQ2sMox--XDuDAzfVpSj1gH0PA9s0a8gmjCMHGCpBZXUtyURfUYs405fpju4YpB0An_lWe8SID1rW2oypd-HSObwEHJEVWGNFymZNZWhoKLHG4dU0ChNWOIJCO8BJfeJVNJJkvY1NKOJDa_sVKJUoCcUdAUOyZNpue2vulivrpYuvyd0URsCnWZMmrqZwFDpYpJixnYDMO7R8VrvudTzeCz93zbcwOFJi5qNi0ALAp8lvN8O-BVKicHm3mpV9fmxVWF1ij8w3b8MZO6aBr0L3wTA8oqkIhc3igyXr9n_9FstHdmoHUZy7v7S79ukECJexpakCMiJVMcZNxbb2Mc6QPdC1zDOpacuDGtLGrVJlPEGk2R5AcJhcaf_B3Jyne4weV7_m0lMtfhsljegrJgj9nPJOAXihebBlZjkGemjRmo6mZvpxNPowxE4_j09MqsOogfZNVu1h9d3NrPmEkmXGjM3YUUgrRGvg6RFgTZ2vk_zAPRd15z4F-1slaE508RbcjB8yv4skPYyk7kzbz2Q76Sl8q2iLoze8XAuDbyd2ifM7LFCxUDYKoguXENqKWxToYNAOxiyAZFzcElcA-QQXxxwrIlfpsI46nbo5Zc8vqUeQQr71dhWeD5VQILMV_IQhEFDVaTuf4CEkhP0ni7kVl5YXUkUSOHRhTVpuxO-WSc3jp_wuYWQrkIyHYEv2vjv_-b9jKgUJSg1HbcOeKV54lJGQOFIT1zYHBsFb3QQ7MmwiXjP_2pFQ4Q1q2Op6hjqMx36yFEtVUfwnaOCz-ew5UpDzsH2_NTAwZGI8z7tR2DUyxFAnFojbcNPmFe4-Hg8f2uaenrDYiGSJ1ytwyRsNmuDWu3vRckS1s0jT7XeeGLNKo3BmE1cCSb5eHuqBO2zD1ykqbQInojt44QpwxUTpeFptzV9mtSBOA2WH5NYUY4YuO6fU4G2ZgZMPP9cua7p3gG-GZjsjtY4jsUOpkAgTvgEKaKB52nDZULYIctOZUUeZKnSbAxHGWbkqaeJ7kCU-35AY5kTm8NZTqp6cgwcKxBSkP93LddraDyyjeo303WFO52jmNMXvTfw7lq1Zc1mQ475LnIi2duT-lSOCOK60WybsFQJOUVwT1eEXF7h_vEmT5bopUOrX8oCwxFUHhfJbZa0TMRJo6FDfRipD435smc7HpZpAAAIAAAAAAAAAH4BAAAAAAAAD_QFGENvbnRlbnQtVHlwZSBhcHBsaWNhdGlvbi9qc29uFkFwcGxpY2F0aW9uGEN5YmVyQ29ubmVjdBxDb250ZW50LUF1dGhvcho4NDY5MjgyNjY2MDYxDkNoYWluSWQENTYcQ29udGVudC1UYXJnZXSAATM5ZjAyMTg4MWU3Mzg2ZjhkNzNkNmVmMjU1MzNlNjA5MWYyYTAyNTZlNDIyYjRiM2M0ZTNkMzM1Y2NhZTE0N2UMU291cmNlSDE1NTMxZmEyLTEyMDUtNGY2MS1iNmU0LWM5ZjY4ZWNmODFmNxRDb250ZW50LUlkgAE0NTM3ODRjZDY0MWYzMWU1OTI4ZmY5MDkyNzRlZTE5NjM0NmJlNTAxZThlMmZiZGI1YzcxZWFkMDk3Yjc2YjNlHENvbnRlbnQtRGlnZXN0gAE0NTM3ODRjZDY0MWYzMWU1OTI4ZmY5MDkyNzRlZTE5NjM0NmJlNTAxZThlMmZiZGI1YzcxZWFkMDk3Yjc2YjNlAHsiY29udGVudCI6IntcIm9wXCI6XCJjb21tZW50XCIsXCJhZGRyZXNzXCI6XCIweDcxNzhmODgzMDI5NzhlMWExMjMyMGNjZTU2ODZjYzFhMTYwODJkMGRcIixcInRzXCI6MTY5MTQ2MDYyMzY3NixcImNoYWluSWRcIjo1NixcImhhbmRsZVwiOlwiODQ2OTI4MjY2NjA2MVwiLFwidGFyZ2V0XCI6XCIzOWYwMjE4ODFlNzM4NmY4ZDczZDZlZjI1NTMzZTYwOTFmMmEwMjU2ZTQyMmI0YjNjNGUzZDMzNWNjYWUxNDdlXCIsXCJ0aXRsZVwiOlwiRmxhcHB5TW9vbmJpcmRcIixcImJvZHlcIjpcIlNvIGZ1biB0byBwbGF5IGluIG15IHNwYXJlIHRpbWUuXCJ9IiwiZGlnZXN0IjoiNDUzNzg0Y2Q2NDFmMzFlNTkyOGZmOTA5Mjc0ZWUxOTYzNDZiZTUwMWU4ZTJmYmRiNWM3MWVhZDA5N2I3NmIzZSIsInNpZ25hdHVyZSI6IjB4NDdhNmVmNjFjNDU0NjA4OTk2YzJiMDYzYWY4MGZhODBmNDVjZWVlMGJhYmRjNTBjYTk0MjY4ODlmOWI1NWU2MjAzZGMwM2MyNzY5MzE1ODllNzFmMjQzMWYwNzU0MWZhOWE2ZmMyNWU5NDQ4NDViNTAzYTVlOTQwYjJkNWVjNmIiLCJzaWduaW5nS2V5Ijp7InB1YmxpY0tleSI6Ik1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRXdJbW1pcUNzdXdMMHV0MndJNHZEejA2SklYSi9acTdNUUhLT3JFV3dWSE1FS3ZhVzBiRXArT2h2eGtwOENoUStGTHd0Zk1sTndKNDg4aXZNVlVIRWtRPT0iLCJmb3JtYXQiOiJTdWJqZWN0UHVibGljS2V5SW5mbyIsImFsZ29yaXRobSI6IkVTMjU2In0sInNpZ25pbmdLZXlBdXRoIjp7ImFkZHJlc3MiOiIweDcxNzhmODgzMDI5NzhlMWExMjMyMGNjZTU2ODZjYzFhMTYwODJkMGQiLCJzaWduaW5nS2V5U2lnbmF0dXJlIjoiMHhkMjJiYzg4MjAzOWE0YjcxYWUwMWZkMjE1ZDk5ODNjYmFhY2NlMGI5YmQzYzM5OGVhYTNmOTdiZDFjOGUxYjc1NzhkNzU4N2VkNzVjMGQ3ZTBiMzhhODA1NjA2ZDEwZTJkZGRjOGYwMDQxNjBjNTZlNTAyY2IzZjEzMWVmODI0ZjFjIiwic2lnbmluZ0tleU1lc3NhZ2UiOiJJIGF1dGhvcml6ZSBDeWJlckNvbm5lY3QgZnJvbSB0aGlzIGRldmljZSB1c2luZyBzaWduaW5nIGtleTpcbk1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRXdJbW1pcUNzdXdMMHV0MndJNHZEejA2SklYSi9acTdNUUhLT3JFV3dWSE1FS3ZhVzBiRXArT2h2eGtwOENoUStGTHd0Zk1sTndKNDg4aXZNVlVIRWtRPT0ifX0BAGQvd7SMh2QAqiTW67RwRqza4qQeccXBPh4qQv7LCk5LVDcAmm9j8C1nTcn0l5e5FCEVQ-hZKl6YFAgb-0DSaeEPOxJ_HcQPmrFbDKkc8lUhxV6Czg7txyAJH8NvUsECF1YFl6kgTXAh8mCyPe8iji1DLYJMzFEqrECWIoctBw2fcYiI99dLUwTMnIy3vUN5DmlWpPaW-_ooLA1NDAUDALFFnVFeZbef54JidQ1iMxhco3hFZU1-I5ukcB_9qk-9o5mhXoLUiXKL8vDqXhavsvrfy_y-Cpo3o7czYY71wonFalrltjSxlDzqwR0QcZedxT3zLWKVEMpKOXAUVg_jUpkgio_YVMXUBRp6blK1zS7PUI4yvjzqsRKNCpICMjzRIlnemAv5ziZE3fjE6Jufn-bT-R8r3vIJsDR5CejDfgb94YgGCiOrJ4i2xogfBTwRz7HW3Iydw1XOYsFJsUpem9SYb5ORbbldnaz1IUHFIY__G9Rf-NkWgugj6OVZ8bqaP_MJmldRIemcyXCvia6HSAcwe5fyoSWRbpzavlBVVuO1XuEZ5JfKRGbaGlOwJYqrGAIBH4s9Yw9qOgWJ7aaZeARQiZOpIYSz7J2zqig2bItoyTJC_rV9W5pQ0Hxe5fNZT-rNu46afVSVq3RrtzdSwWWmGo6PevD4xveQy_lWnjSnnPgX7WyVoTnTxFtyMHzK_iyQ9jKTuTNvPZDvpKXyraIujN7xcC4NvJ3aJ8zssULFQNgqiC5cQ2opbFOhg0A7GLIBkXNwSVwD5BBfHHCsiV-mwjjqdujllzy-pR5BCvvV2FZ4PlVAgsxX8hCEQUNVpO5_gISSE_SeLuRWXlhdSRRI4dGFNWm7E75ZJzeOn_C5hZCuQjIdgS_a-O__5v2MqBQlKDUdtw54pXniUkZA4UhPXNgcGwVvdBDsybCJeM__akVDhDWrY6nqGOozHfrIUS1VR_Cdo4LP57DlSkPOwfb81MDBkYjzPu1HYNTLEUCcWiNtw0-YV7j4eDx_a5p6esNiIZInXK3DJGw2a4Na7e9FyRLWzSNPtd54Ys0qjcGYTVwJJvl4e6oE7bMPXKSptAieiO3jhCnDFROl4Wm3NX2a1IE4DZYfk1hRjhi47p9TgbZmBkw8_1y5runeAb4ZmOyO1jiOxQ6mQCBO-AQpooHnacNlQtghy05lRR5kqdJsDEcZZuSpp4nuQJT7fkBjmRObw1lOqnpyDBwrEFKQ_3ct12toPLKN6jfTdYU7naOY0xe9N_DuWrVlzWZDjvkuciLZ25P6VI4I4rrRbJuwVAk5RXBPV4RcXuH-8SZPluilQ6tfygLDEVQeF8ltlrRMxEmjoUN9GKkPjfmyZzselmkAAAgAAAAAAAAAfQEAAAAAAAAP8gUYQ29udGVudC1UeXBlIGFwcGxpY2F0aW9uL2pzb24WQXBwbGljYXRpb24YQ3liZXJDb25uZWN0HENvbnRlbnQtRGlnZXN0gAFjZWY5MDM4ZjI4NzM3OTc3YWJhODc0Yzc5MGE2YTQzNjQzMWEyMmMwOTZiN2Y5MmM3YWQxODM4Zjg4MjYzMGZiHENvbnRlbnQtQXV0aG9yGDd3bWFwbnEwbjE0bA5DaGFpbklkBDU2HENvbnRlbnQtVGFyZ2V0gAEzOWYwMjE4ODFlNzM4NmY4ZDczZDZlZjI1NTMzZTYwOTFmMmEwMjU2ZTQyMmI0YjNjNGUzZDMzNWNjYWUxNDdlDFNvdXJjZUgxNTUzMWZhMi0xMjA1LTRmNjEtYjZlNC1jOWY2OGVjZjgxZjcUQ29udGVudC1JZIABY2VmOTAzOGYyODczNzk3N2FiYTg3NGM3OTBhNmE0MzY0MzFhMjJjMDk2YjdmOTJjN2FkMTgzOGY4ODI2MzBmYgB7ImNvbnRlbnQiOiJ7XCJvcFwiOlwiY29tbWVudFwiLFwiYWRkcmVzc1wiOlwiMHhkNGE5ODA5ODIxMTJmNDQ2YTVjMjgwNzhiMGNiZWZhMzRhNmRlNjllXCIsXCJ0c1wiOjE2OTE0NjA2MjI4NTMsXCJjaGFpbklkXCI6NTYsXCJoYW5kbGVcIjpcIjd3bWFwbnEwbjE0bFwiLFwidGFyZ2V0XCI6XCIzOWYwMjE4ODFlNzM4NmY4ZDczZDZlZjI1NTMzZTYwOTFmMmEwMjU2ZTQyMmI0YjNjNGUzZDMzNWNjYWUxNDdlXCIsXCJ0aXRsZVwiOlwiRmxhcHB5TW9vbmJpcmRcIixcImJvZHlcIjpcIlNvIGZ1biB0byBwbGF5IGluIG15IHNwYXJlIHRpbWUuXCJ9IiwiZGlnZXN0IjoiY2VmOTAzOGYyODczNzk3N2FiYTg3NGM3OTBhNmE0MzY0MzFhMjJjMDk2YjdmOTJjN2FkMTgzOGY4ODI2MzBmYiIsInNpZ25hdHVyZSI6IjB4YzhiNTkyNTRhYjUxZWZmNzRkMzJlODU3M2FmNjViMDA1NzZhYzg0OGI5YTEwMjUxNTU2M2YxYjVjMTI0ZmViZDYwMjI4OWZmYTFiZTY3ZGEwODY5OGQ1YTUwNDE5NmM4M2UxYTgwN2ZlYmM4YTA2NDlkODhjNDFlMzE0ZjIyM2UiLCJzaWduaW5nS2V5Ijp7InB1YmxpY0tleSI6Ik1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRXZ4U2FHQVloVzF0ZGZTUDdJZmxhbXd3UExGdnYzT2xrSEdGU2V5d0tLUko5Mm94Vkx3ZThqNTY0T0Iwb2F1SDBXcjJIRm5GK3AwNDVlc2NtNUVkcHR3PT0iLCJmb3JtYXQiOiJTdWJqZWN0UHVibGljS2V5SW5mbyIsImFsZ29yaXRobSI6IkVTMjU2In0sInNpZ25pbmdLZXlBdXRoIjp7ImFkZHJlc3MiOiIweGQ0YTk4MDk4MjExMmY0NDZhNWMyODA3OGIwY2JlZmEzNGE2ZGU2OWUiLCJzaWduaW5nS2V5U2lnbmF0dXJlIjoiMHg4NzUwYjBmODIzMzUyNzY3YzFkYTEwN2I3ZmY3ZDk2YTYzMTgwZmExOTcxMjAzZDgxZTdkMjc4YTdmMDhlMmM3MzFmY2JlM2Q0ZTg0N2IwY2MxNjZkYTM1YTAyODM3NThkNTBhOGNmNzdjMjYxZDZkZGFmNzdiY2ZhM2RjYmExYjFiIiwic2lnbmluZ0tleU1lc3NhZ2UiOiJJIGF1dGhvcml6ZSBDeWJlckNvbm5lY3QgZnJvbSB0aGlzIGRldmljZSB1c2luZyBzaWduaW5nIGtleTpcbk1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRXZ4U2FHQVloVzF0ZGZTUDdJZmxhbXd3UExGdnYzT2xrSEdGU2V5d0tLUko5Mm94Vkx3ZThqNTY0T0Iwb2F1SDBXcjJIRm5GK3AwNDVlc2NtNUVkcHR3PT0ifX0BAEvksf3R-DXnHvsecVlMPdcBsF3WUFwlVRhDrXo_5mhQwMWzG0q4q9qUhjy3IUoRh1hnQTG0taHHqZl12x8VhDPUPiAsGY06fMqfAdGoyB8rqyudy8aPPhX_1_II8gP5xkh7yc8pJ48ZtF8jp2hQ0Ynw8NTfyUJg26YUlBOQ5zVFknFdidfRjbV4SrCXt8lpUHq6bfqGHU0iYQukownPIDzXCgok3Aqszo10ghBDuTAldmqHkMx-TqB-kDRn62kVppnmo0xvQodA_xcnIqZ1z4tjE1dJW0A38qPCAgYQ3UGsnawG0wDsUmEKz1hVbRFWdK5UNGN9E67Uysh0RSJpx4YJ5xoMS9_MLMaLUAkFF6Ghhx7HEDfEUoI1GVS12KtRwlG_qmx-FkdHxdac25rhvgvWkKNKFAbJH4XlSm9yLa-zdvfOZwFmziByoOM6dvOfc_sd-jbTicZKP9eiMdrP26Y9XlNk3iag7-TJENSUhJ4QCuoUgUdre-R9JknQ-ftwY63YyMKelmb8XofTXqGyL3uN0kdUUuDjlurzKm_A9BQLT8Cf6844VcpQR3K_hzNCo0DFEEPLgQRLjrJyO1_BSgOu_ghXWaEn16EbZRgVi3odWhZGns7yVfzGbJ_F2-VwxS1a7r5Yj4fQhNVDM3JtmXvxySh0Cqghjp7oHnbxPBFonPgX7WyVoTnTxFtyMHzK_iyQ9jKTuTNvPZDvpKXyraIujN7xcC4NvJ3aJ8zssULFQNgqiC5cQ2opbFOhg0A7GLIBkXNwSVwD5BBfHHCsiV-mwjjqdujllzy-pR5BCvvV2FZ4PlVAgsxX8hCEQUNVpO5_gISSE_SeLuRWXlhdSRRI4dGFNWm7E75ZJzeOn_C5hZCuQjIdgS_a-O__5v2MqBQlKDUdtw54pXniUkZA4UhPXNgcGwVvdBDsybCJeM__akVDhDWrY6nqGOozHfrIUS1VR_Cdo4LP57DlSkPOwfb81MDBkYjzPu1HYNTLEUCcWiNtw0-YV7j4eDx_a5p6esNiIZInXK3DJGw2a4Na7e9FyRLWzSNPtd54Ys0qjcGYTVwJJvl4e6oE7bMPXKSptAieiO3jhCnDFROl4Wm3NX2a1IE4DZYfk1hRjhi47p9TgbZmBkw8_1y5runeAb4ZmOyO1jiOxQ6mQCBO-AQpooHnacNlQtghy05lRR5kqdJsDEcZZuSpp4nuQJT7fkBjmRObw1lOqnpyDBwrEFKQ_3ct12toPLKN6jfTdYU7naOY0xe9N_DuWrVlzWZDjvkuciLZ25P6VI4I4rrRbJuwVAk5RXBPV4RcXuH-8SZPluilQ6tfygLDEVQeF8ltlrRMxEmjoUN9GKkPjfmyZzselmkAAAgAAAAAAAAAfQEAAAAAAAAP8gUYQ29udGVudC1UeXBlIGFwcGxpY2F0aW9uL2pzb24WQXBwbGljYXRpb24YQ3liZXJDb25uZWN0HENvbnRlbnQtQXV0aG9yGGhsbmpvb3VxYmd5aA5DaGFpbklkBDU2HENvbnRlbnQtVGFyZ2V0gAEzOWYwMjE4ODFlNzM4NmY4ZDczZDZlZjI1NTMzZTYwOTFmMmEwMjU2ZTQyMmI0YjNjNGUzZDMzNWNjYWUxNDdlDFNvdXJjZUgxNTUzMWZhMi0xMjA1LTRmNjEtYjZlNC1jOWY2OGVjZjgxZjcUQ29udGVudC1JZIABMGEzY2VhNjIxZjUyMGM2NDlkZGI4Mzg0Y2ExOWQ1YTJjYjAwOWIyYjhlNzUwZjA0OTNlOTMwYmFkOGY4NjdlMRxDb250ZW50LURpZ2VzdIABMGEzY2VhNjIxZjUyMGM2NDlkZGI4Mzg0Y2ExOWQ1YTJjYjAwOWIyYjhlNzUwZjA0OTNlOTMwYmFkOGY4NjdlMQB7ImNvbnRlbnQiOiJ7XCJvcFwiOlwiY29tbWVudFwiLFwiYWRkcmVzc1wiOlwiMHg2YWY5NDViM2U0MjZlMmFhMjZjYmMzOTU2NjQ2ZTA4MDk5OTMzOWNlXCIsXCJ0c1wiOjE2OTE0NjA2MjI5NzQsXCJjaGFpbklkXCI6NTYsXCJoYW5kbGVcIjpcImhsbmpvb3VxYmd5aFwiLFwidGFyZ2V0XCI6XCIzOWYwMjE4ODFlNzM4NmY4ZDczZDZlZjI1NTMzZTYwOTFmMmEwMjU2ZTQyMmI0YjNjNGUzZDMzNWNjYWUxNDdlXCIsXCJ0aXRsZVwiOlwiRmxhcHB5TW9vbmJpcmRcIixcImJvZHlcIjpcIlNvIGZ1biB0byBwbGF5IGluIG15IHNwYXJlIHRpbWUuXCJ9IiwiZGlnZXN0IjoiMGEzY2VhNjIxZjUyMGM2NDlkZGI4Mzg0Y2ExOWQ1YTJjYjAwOWIyYjhlNzUwZjA0OTNlOTMwYmFkOGY4NjdlMSIsInNpZ25hdHVyZSI6IjB4MzFiOWFlMjJjNWM3MzUyZjk2ZmU0ODM0OGU2MDk5OTkyNWU1ZDZkNjkzNDA3ZWIzZTQ4NmY3ZDdmZDA5ZGM3MDQ0NmU5OTY3MjA3NDE0ZjNjNzJmNDAyMWFjMzY0MGJmODg1NmEyYWE5YTgxNjZiNjYzYjBjYTY0NjRhNDdlNDUiLCJzaWduaW5nS2V5Ijp7InB1YmxpY0tleSI6Ik1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRVNuNzNkYWN0MURFc0VPK1ZHNlQzMnk2c0FBalJjNm9SMW9zNlNyWGUyYVJYNllZVXhhRWdKZ1V0VmdlMjBKWHRzRTlreGJmSzl2bnptWWtYVENxWllnPT0iLCJmb3JtYXQiOiJTdWJqZWN0UHVibGljS2V5SW5mbyIsImFsZ29yaXRobSI6IkVTMjU2In0sInNpZ25pbmdLZXlBdXRoIjp7ImFkZHJlc3MiOiIweDZhZjk0NWIzZTQyNmUyYWEyNmNiYzM5NTY2NDZlMDgwOTk5MzM5Y2UiLCJzaWduaW5nS2V5U2lnbmF0dXJlIjoiMHhlMWIxZTFlZjQ5YjMxYWEyMGE5ZWFmNzQxOGE5NjBjNjgyNGJkYWM2YjM1YzZiYjFhNzVmZDM1ODJkOGMxOWZhNWU0YWRhMDFjZjU1ODM2MGM2NDgxNTI4Y2E4Mzk1YjAyNTA4MzIyNzNkNTgwYWI4YTBlZmNiZWM5Njk2YzU5YTFiIiwic2lnbmluZ0tleU1lc3NhZ2UiOiJJIGF1dGhvcml6ZSBDeWJlckNvbm5lY3QgZnJvbSB0aGlzIGRldmljZSB1c2luZyBzaWduaW5nIGtleTpcbk1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRVNuNzNkYWN0MURFc0VPK1ZHNlQzMnk2c0FBalJjNm9SMW9zNlNyWGUyYVJYNllZVXhhRWdKZ1V0VmdlMjBKWHRzRTlreGJmSzl2bnptWWtYVENxWllnPT0ifX0BABpCO_NC8mLOdI46arZ0-STrdU4zWKHwwnXZ1ZFeq56Y7FBR30QUFCCotKXPeV1XGzXWCcLbeteuJlQm7s_4aJQ_wOLwjxLGIqd8zG2ZteJYabA7OOEsrBFzDUbU5w_K5y5PW-KtwTYmzL3G701UvAHavp_8wA-qtbvNn1eTsqhSl8fqJAHQox6Yp5Qkp0H-2QuIOXeU_fapIFV5Ht2XurHXy9map33ivQqTMQt7HgsRJtWLwlhN9Y_ewTErNQLqdhtP5g0A96KpfCg9Lo6uYgcsVfnLW7uvrJpctTya5ukCThmsZVaTr7pny2y7cEczvvOIbug1LmUYsrtnKni9t5mJHQWlfsHPd0MdvfVv1byh2CsvBDhXzL6eYmXzZ5VZlPqFsfp0Srxhg0t_u3Mxqh4Hq4iB_o7kx4WqadQuue12s_QN97c0KZzVbxvxstQ-moAZ-jVQ7_JXLb3uCGTX22sKISYgov8VF3YS82T0xtB8zMdGjSb0NZE8D5zu8xjPWsvyDNWVPkwyvYtIdfKW2eQK7AdLg76OkPMcxNOno8sHQM2V7OGPP5opk_NRJTSnx_CgMdxdji_oXArWWWvLXMY-yBru1lQq7IDkXPU3hSyhww7oHFclUCOnDIMlHX9-slwtYW4Db89s-kiUsyxL8LBX3vW2j16eIzQ16qo_L6BPnPgX7WyVoTnTxFtyMHzK_iyQ9jKTuTNvPZDvpKXyraIujN7xcC4NvJ3aJ8zssULFQNgqiC5cQ2opbFOhg0A7GLIBkXNwSVwD5BBfHHCsiV-mwjjqdujllzy-pR5BCvvV2FZ4PlVAgsxX8hCEQUNVpO5_gISSE_SeLuRWXlhdSRRI4dGFNWm7E75ZJzeOn_C5hZCuQjIdgS_a-O__5v2MqBQlKDUdtw54pXniUkZA4UhPXNgcGwVvdBDsybCJeM__akVDhDWrY6nqGOozHfrIUS1VR_Cdo4LP57DlSkPOwfb81MDBkYjzPu1HYNTLEUCcWiNtw0-YV7j4eDx_a5p6esNiIZInXK3DJGw2a4Na7e9FyRLWzSNPtd54Ys0qjcGYTVwJJvl4e6oE7bMPXKSptAieiO3jhCnDFROl4Wm3NX2a1IE4DZYfk1hRjhi47p9TgbZmBkw8_1y5runeAb4ZmOyO1jiOxQ6mQCBO-AQpooHnacNlQtghy05lRR5kqdJsDEcZZuSpp4nuQJT7fkBjmRObw1lOqnpyDBwrEFKQ_3ct12toPLKN6jfTdYU7naOY0xe9N_DuWrVlzWZDjvkuciLZ25P6VI4I4rrRbJuwVAk5RXBPV4RcXuH-8SZPluilQ6tfygLDEVQeF8ltlrRMxEmjoUN9GKkPjfmyZzselmkAAAgAAAAAAAAAfQEAAAAAAAAP8gUYQ29udGVudC1UeXBlIGFwcGxpY2F0aW9uL2pzb24WQXBwbGljYXRpb24YQ3liZXJDb25uZWN0DkNoYWluSWQENTYcQ29udGVudC1UYXJnZXSAATM5ZjAyMTg4MWU3Mzg2ZjhkNzNkNmVmMjU1MzNlNjA5MWYyYTAyNTZlNDIyYjRiM2M0ZTNkMzM1Y2NhZTE0N2UMU291cmNlSDE1NTMxZmEyLTEyMDUtNGY2MS1iNmU0LWM5ZjY4ZWNmODFmNxRDb250ZW50LUlkgAEwZTQzM2VlZDM2ZDNmYzBhMjJmZjNmNDgyMTg0NTNhM2EwYjYwMTJkZGU2MjgxNWRhNjJlMzEwODU3ZTIyNDlhHENvbnRlbnQtRGlnZXN0gAEwZTQzM2VlZDM2ZDNmYzBhMjJmZjNmNDgyMTg0NTNhM2EwYjYwMTJkZGU2MjgxNWRhNjJlMzEwODU3ZTIyNDlhHENvbnRlbnQtQXV0aG9yGGZvdnVleXA0cm1tYgB7ImNvbnRlbnQiOiJ7XCJvcFwiOlwiY29tbWVudFwiLFwiYWRkcmVzc1wiOlwiMHhmMTcwMTg3Yzk4NTMwOGRkZTMwN2ZjODdjMmQzNTU4ZjZmNmNlMTQwXCIsXCJ0c1wiOjE2OTE0NjA2MjI5NTIsXCJjaGFpbklkXCI6NTYsXCJoYW5kbGVcIjpcImZvdnVleXA0cm1tYlwiLFwidGFyZ2V0XCI6XCIzOWYwMjE4ODFlNzM4NmY4ZDczZDZlZjI1NTMzZTYwOTFmMmEwMjU2ZTQyMmI0YjNjNGUzZDMzNWNjYWUxNDdlXCIsXCJ0aXRsZVwiOlwiRmxhcHB5TW9vbmJpcmRcIixcImJvZHlcIjpcIlNvIGZ1biB0byBwbGF5IGluIG15IHNwYXJlIHRpbWUuXCJ9IiwiZGlnZXN0IjoiMGU0MzNlZWQzNmQzZmMwYTIyZmYzZjQ4MjE4NDUzYTNhMGI2MDEyZGRlNjI4MTVkYTYyZTMxMDg1N2UyMjQ5YSIsInNpZ25hdHVyZSI6IjB4MmJiMTk1N2Q0MmUxNzgwNzA4YzFkMDRhNjg0OGY2YjU2YzcxYzJmZGI1MDY5MjVmMDNmNWM4ZDVkZjQ4M2Q1NjBmZTk4ODhiNTc2ZTllZWRiNWE0Yzg1ODNmNjI5ZDk0Y2NhMTJmYjUxOGU0N2ViMjE1YmI4MTdhYjc3YmMyNWEiLCJzaWduaW5nS2V5Ijp7InB1YmxpY0tleSI6Ik1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRTZwRGNSYXRnZHZCSHVGazYzRG1HRUw3emVWeEltSW0yeFUvd1NWTFZRZEhwQVExN0pUN2psRFhtL2RZdlNSb2NMcnNGVE1mRkxmMWtUUVlnZWVEMUF3PT0iLCJmb3JtYXQiOiJTdWJqZWN0UHVibGljS2V5SW5mbyIsImFsZ29yaXRobSI6IkVTMjU2In0sInNpZ25pbmdLZXlBdXRoIjp7ImFkZHJlc3MiOiIweGYxNzAxODdjOTg1MzA4ZGRlMzA3ZmM4N2MyZDM1NThmNmY2Y2UxNDAiLCJzaWduaW5nS2V5U2lnbmF0dXJlIjoiMHg1Yjc3MWQ1YWQwNDZmZDFkOTEyN2RmOTc2YzY4NDQ2ZTA4Zjg4YTg0ZTFjODc1ZTE1ODljMTMxN2JlNzRlNGNiMzljNzM1OTYyZWM1OTk0NzljNWNhZDViODZmY2JiZGU3N2Q4MDRiNDFlMzZjNDUwNmFiYTEyNjM5NzI3YmQ2NzFjIiwic2lnbmluZ0tleU1lc3NhZ2UiOiJJIGF1dGhvcml6ZSBDeWJlckNvbm5lY3QgZnJvbSB0aGlzIGRldmljZSB1c2luZyBzaWduaW5nIGtleTpcbk1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRTZwRGNSYXRnZHZCSHVGazYzRG1HRUw3emVWeEltSW0yeFUvd1NWTFZRZEhwQVExN0pUN2psRFhtL2RZdlNSb2NMcnNGVE1mRkxmMWtUUVlnZWVEMUF3PT0ifX0BAIkNboJ9ZLi0IgofVN5eZBqya5mlAHCVfKbvfcz8HSRzir_PQtc6ZUbjJL5sFd4mp-OQcLDZSnUUc3LItV77_2Bwy94Bod2TAD1b8Vb1_p42LTtwWIlPBLvRL9sy6GHuD9NeIABdUszbYnFrSUV6sPPfJtG_iKPzwykUMNOqqLp70HJMpPLI0hlXSfxAg_GE-zgye77c18dw6TC0Q-08c3jjjJ45e9CZ9c90IzRLyXYePuehqdoJBXJi0re41ONQDDyTzsfDu7wNjXiAphT7DOWIJyvs14D_7LSD7U7jFATygl4GCkJQz6VU9wY3OvCbbUnwp0Ed9vD3iyAy_sxlCBdI4JPNja9cYt3sEXOFOpQDRZ9vMQB3k7ha6DQ6C9nZEcw-pqKCr3a_YcevEiCrYas7elyxrM0qcTTfBWBk4v8pgHwgOt0G73nhmeWXa2cc0T4Xy6luutMU3xLvar5IMDD4vYUIXRDLNeuGtnDLyylUYiX1TtUgdeaLuzuZK2-paVxi2gVp1IKpcpJEjGTQlMHVtXhqQeB9XLBrzT_Ar-LHujsLzt-2YCD1xkzC2KA2-kcDtc302VRNfT_qIqHmvnjaj5A81O65ivwx-TNk-ELdpeqob5JW296xmMySYhf5KZ-iapF7wN-83tWQmFTSz_EQLH75P9fiIiDeVm4zOH3nnPgX7WyVoTnTxFtyMHzK_iyQ9jKTuTNvPZDvpKXyraIujN7xcC4NvJ3aJ8zssULFQNgqiC5cQ2opbFOhg0A7GLIBkXNwSVwD5BBfHHCsiV-mwjjqdujllzy-pR5BCvvV2FZ4PlVAgsxX8hCEQUNVpO5_gISSE_SeLuRWXlhdSRRI4dGFNWm7E75ZJzeOn_C5hZCuQjIdgS_a-O__5v2MqBQlKDUdtw54pXniUkZA4UhPXNgcGwVvdBDsybCJeM__akVDhDWrY6nqGOozHfrIUS1VR_Cdo4LP57DlSkPOwfb81MDBkYjzPu1HYNTLEUCcWiNtw0-YV7j4eDx_a5p6esNiIZInXK3DJGw2a4Na7e9FyRLWzSNPtd54Ys0qjcGYTVwJJvl4e6oE7bMPXKSptAieiO3jhCnDFROl4Wm3NX2a1IE4DZYfk1hRjhi47p9TgbZmBkw8_1y5runeAb4ZmOyO1jiOxQ6mQCBO-AQpooHnacNlQtghy05lRR5kqdJsDEcZZuSpp4nuQJT7fkBjmRObw1lOqnpyDBwrEFKQ_3ct12toPLKN6jfTdYU7naOY0xe9N_DuWrVlzWZDjvkuciLZ25P6VI4I4rrRbJuwVAk5RXBPV4RcXuH-8SZPluilQ6tfygLDEVQeF8ltlrRMxEmjoUN9GKkPjfmyZzselmkAAAcAAAAAAAAAEgEAAAAAAAANnAQYQ29udGVudC1UeXBlIGFwcGxpY2F0aW9uL2pzb24WQXBwbGljYXRpb24YQ3liZXJDb25uZWN0FENvbnRlbnQtSWSAAWEzZWZkZGJkOGQxNjcxMTYzOGUwMzQzOTEyMmQzMjk4OGM2NzIyNTZhODk1MmUzMDcxMTg4NzUxZTY3MDhiYjkcQ29udGVudC1EaWdlc3SAAWEzZWZkZGJkOGQxNjcxMTYzOGUwMzQzOTEyMmQzMjk4OGM2NzIyNTZhODk1MmUzMDcxMTg4NzUxZTY3MDhiYjkcQ29udGVudC1BdXRob3IaaGllbjI3MTEwMjQ2Ng5DaGFpbklkBDU2DFNvdXJjZRJjeWJlcnR1bmUAeyJjb250ZW50Ijoie1wib3BcIjpcInBvc3RcIixcImFkZHJlc3NcIjpcIjB4Nzg1YWE4M2E4ZDUwN2E2NzYyZjM0ZWM0MmY5MzU3YjhmYTYwMGQ0NFwiLFwidHNcIjoxNjkxNDYwNjI0MjM1LFwiY2hhaW5JZFwiOjU2LFwiaGFuZGxlXCI6XCJoaWVuMjcxMTAyNDY2XCIsXCJ0aXRsZVwiOlwiNjc2N1wiLFwiYm9keVwiOlwiNjc2XCJ9IiwiZGlnZXN0IjoiYTNlZmRkYmQ4ZDE2NzExNjM4ZTAzNDM5MTIyZDMyOTg4YzY3MjI1NmE4OTUyZTMwNzExODg3NTFlNjcwOGJiOSIsInNpZ25hdHVyZSI6IjB4Njk1NDA0YmJhNmJjMGVhYTM3OTcxN2MwMzRjOGYyZWI0ZmU2M2IwNTg5NmFjNGQwOTZkOTQxNTUxOTcwNTk2NTM4MDE0NzU1OWQxODljZjAwMDdiYmYyNWI3YzRkZTBjYWM2YWFmMzU5OWJiOTcwYmVkMWE3NzNiOTFhNWYyYzEiLCJzaWduaW5nS2V5Ijp7InB1YmxpY0tleSI6Ik1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRXdUb3o5VDhjdE9iaE1saGdKK3dwaHpiTXlqbkFRdlM1K2dTb2ZvaWtPQ3ZibVd4akEzcTRxZEVzWEViVmRYanBZeGJtRHF0b0JHTytRKytNdDJOakxRPT0iLCJmb3JtYXQiOiJTdWJqZWN0UHVibGljS2V5SW5mbyIsImFsZ29yaXRobSI6IkVTMjU2In0sInNpZ25pbmdLZXlBdXRoIjp7ImFkZHJlc3MiOiIweDc4NWFhODNhOGQ1MDdhNjc2MmYzNGVjNDJmOTM1N2I4ZmE2MDBkNDQiLCJzaWduaW5nS2V5U2lnbmF0dXJlIjoiMHhiOTRhNGRlMDcxMzk5ODYzYWMzMzczMjdkN2E1MmJhNjhmMmE3ZWM4Y2UwZjg4Zjc3NWQ4YWYwYzBmOTVjMTRmN2I0MjBjM2NjOGQzNTUzMjBiNjJiZGFiMGUxZjk4ZTAyMzY4N2IzYzBlYTE1NWVkNDE3MjFiOGI2ZjU0ZjM4ZTFjIiwic2lnbmluZ0tleU1lc3NhZ2UiOiJJIGF1dGhvcml6ZSBJIGF1dGhvcml6ZSBDeWJlclR1bmUueHl6IGZyb20gdGhpcyBkZXZpY2UgdXNpbmcgc2lnbmluZyBrZXk6ICBmcm9tIHRoaXMgZGV2aWNlIHVzaW5nIHNpZ25pbmcga2V5OlxuTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFd1RvejlUOGN0T2JoTWxoZ0ord3BoemJNeWpuQVF2UzUrZ1NvZm9pa09DdmJtV3hqQTNxNHFkRXNYRWJWZFhqcFl4Ym1EcXRvQkdPK1ErK010Mk5qTFE9PSJ9fQEAP6QuvbRAOOGNUzGn7Ef_YJu6lY6nWT6lYYiqbiC5Yk9wK5zpLvdtbI6j4-1BVIvS_traTxw4KxsKRHms5Tkr3Bx1t9kNWiLrMOgmx6NnqTNdSM-WEsQlKl9t0-PXcuEAwjcmX8JUgV91rMskDv6EPeW2OPoaZPdZY9z2P2qXdZqVy_WKNZr02Sp3X5MNmuCTnLO4ouuKnGB2n46tHuZOVtuW2HWICHCfQWXlJhfrxI0EbrJBo_PfyInGCwUl26QnBvxIVuk0RhBOGoAG-5E0Eo0ZrUMQ6cU6NBIu7g73OyMuMPLjpEEUWJ7BsqxZ28MQ_-vhkpPPVVsC_a5cD5_8UhcxSZfrYBp4XE6622eJWdaWXNMvVSYXWyrdJe0JoeMIrCk3D6Bq3xP8Baht45R19914FKNoaZ6JtvPVj1EScIhOMCKLrbA_Fu2FR979AR0DmAVMOxMhoVDU8yyOtpaLFinDBlNFw5MUKoU3FPqs4l3eJhV05e3fBZwC_0hwezwand1P4aUx6GPgEToyM1gwR1n94NpSIya3Ca3wiQ_D9KZgyCdCu6PiGtZAwQMW9OsPBbfC6XqKEXlRRZ_VNpySgX1SAhW79UNg-LIKFX0xoPS28Ec5FZ9aTZIsHQHs7q37l--B9mwwpSH3Ap8XZWiwySOtOGsyFzRhHFrTaRY85pSc-BftbJWhOdPEW3IwfMr-LJD2MpO5M289kO-kpfKtoi6M3vFwLg28ndonzOyxQsVA2CqILlxDailsU6GDQDsYsgGRc3BJXAPkEF8ccKyJX6bCOOp26OWXPL6lHkEK-9XYVng-VUCCzFfyEIRBQ1Wk7n-AhJIT9J4u5FZeWF1JFEjh0YU1absTvlknN46f8LmFkK5CMh2BL9r47__m_YyoFCUoNR23DnileeJSRkDhSE9c2BwbBW90EOzJsIl4z_9qRUOENatjqeoY6jMd-shRLVVH8J2jgs_nsOVKQ87B9vzUwMGRiPM-7Udg1MsRQJxaI23DT5hXuPh4PH9rmnp6w2IhkidcrcMkbDZrg1rt70XJEtbNI0-13nhizSqNwZhNXAkm-Xh7qgTtsw9cpKm0CJ6I7eOEKcMVE6Xhabc1fZrUgTgNlh-TWFGOGLjun1OBtmYGTDz_XLmu6d4BvhmY7I7WOI7FDqZAIE74BCmigedpw2VC2CHLTmVFHmSp0mwMRxlm5Kmnie5AlPt-QGOZE5vDWU6qenIMHCsQUpD_dy3Xa2g8so3qN9N1hTudo5jTF7038O5atWXNZkOO-S5yItnbk_pUjgjiutFsm7BUCTlFcE9XhFxe4f7xJk-W6KVDq1_KAsMRVB4XyW2WtEzESaOhQ30YqQ-N-bJnOx6WaQAACAAAAAAAAAB9AQAAAAAAAA_yBRhDb250ZW50LVR5cGUgYXBwbGljYXRpb24vanNvbhZBcHBsaWNhdGlvbhhDeWJlckNvbm5lY3QcQ29udGVudC1UYXJnZXSAATM5ZjAyMTg4MWU3Mzg2ZjhkNzNkNmVmMjU1MzNlNjA5MWYyYTAyNTZlNDIyYjRiM2M0ZTNkMzM1Y2NhZTE0N2UMU291cmNlSDE1NTMxZmEyLTEyMDUtNGY2MS1iNmU0LWM5ZjY4ZWNmODFmNxRDb250ZW50LUlkgAEwZGZkNzE2NjE4OTcyN2I1M2Q3NGUwOTA2MTQzZGYyNDMyNjVjNjE5NzNlZGNkY2NmOGEwZDhiNjAxMmM3MzU2HENvbnRlbnQtRGlnZXN0gAEwZGZkNzE2NjE4OTcyN2I1M2Q3NGUwOTA2MTQzZGYyNDMyNjVjNjE5NzNlZGNkY2NmOGEwZDhiNjAxMmM3MzU2HENvbnRlbnQtQXV0aG9yGDU3d2x2aW44bHJjZw5DaGFpbklkBDU2AHsiY29udGVudCI6IntcIm9wXCI6XCJjb21tZW50XCIsXCJhZGRyZXNzXCI6XCIweGMzY2YwZjI4MjIxODJmMWU2NTdjNzkyNjEzOTUxZWUwMzZlYmFjMTJcIixcInRzXCI6MTY5MTQ2MDYyMzY5NSxcImNoYWluSWRcIjo1NixcImhhbmRsZVwiOlwiNTd3bHZpbjhscmNnXCIsXCJ0YXJnZXRcIjpcIjM5ZjAyMTg4MWU3Mzg2ZjhkNzNkNmVmMjU1MzNlNjA5MWYyYTAyNTZlNDIyYjRiM2M0ZTNkMzM1Y2NhZTE0N2VcIixcInRpdGxlXCI6XCJGbGFwcHlNb29uYmlyZFwiLFwiYm9keVwiOlwiU28gZnVuIHRvIHBsYXkgaW4gbXkgc3BhcmUgdGltZS5cIn0iLCJkaWdlc3QiOiIwZGZkNzE2NjE4OTcyN2I1M2Q3NGUwOTA2MTQzZGYyNDMyNjVjNjE5NzNlZGNkY2NmOGEwZDhiNjAxMmM3MzU2Iiwic2lnbmF0dXJlIjoiMHhiZDU0MmFiZDIwM2RiMjJmMjQ3MTg2ZTI4ZGM4NmEwMjA4NmJlZjViNjU2YWViMTY1ZTEyYzYwMjJlYTQ1YzY1MmE3NjE3OGNlNzRlYTVlNDFiNGIzZGUyZmNiNjQyNGU0ODc2YTdiZDU4ZTI0NTlkYTk4MTdkYWY4NWFiNmFlZiIsInNpZ25pbmdLZXkiOnsicHVibGljS2V5IjoiTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFdUVoMTVab0Q0OG1SMWtBVGFsSHZiVGhFU3BpWGRnS3A2T25HZHlUdXJZRzlJV2pYYnc2blJENGwyZ2JjZStNUDdoS1NuSndWdWkydlhucUU0VEZpckE9PSIsImZvcm1hdCI6IlN1YmplY3RQdWJsaWNLZXlJbmZvIiwiYWxnb3JpdGhtIjoiRVMyNTYifSwic2lnbmluZ0tleUF1dGgiOnsiYWRkcmVzcyI6IjB4YzNjZjBmMjgyMjE4MmYxZTY1N2M3OTI2MTM5NTFlZTAzNmViYWMxMiIsInNpZ25pbmdLZXlTaWduYXR1cmUiOiIweDkzODYyMWY2MDM2YmNlNWZiMDhiMzNmYzg4YjM0ZmExY2JmYjdiMDcyNDU2YjQ3MzM4MDYwYzI0ZTE1NmQ2NDE2OTI3MzgyZTQwZTEzZGRkYzdlNjJkYTYyYTEzZjQ4MTliYzZiMWZmZDgwZjUxMmM3YjAwM2I5ODc3NjIxMzNkMWMiLCJzaWduaW5nS2V5TWVzc2FnZSI6IkkgYXV0aG9yaXplIEN5YmVyQ29ubmVjdCBmcm9tIHRoaXMgZGV2aWNlIHVzaW5nIHNpZ25pbmcga2V5OlxuTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFdUVoMTVab0Q0OG1SMWtBVGFsSHZiVGhFU3BpWGRnS3A2T25HZHlUdXJZRzlJV2pYYnc2blJENGwyZ2JjZStNUDdoS1NuSndWdWkydlhucUU0VEZpckE9PSJ9fQEADfd1ZVEZmpRxGvpMWRHc7u4ooyqxUN1KI4kzo-85Qq2QEbcxztyo1WvVG5y1Y_WGUccYRxmTe8XDD9rBOPoC7HEmAox-v47YZGsjl_NPxpoKoiD6WpD6bnqSIQcR6rt0-WcL48UKwlLh1s-HZwNQC57QZFWvSAHhXXjz_ibrtXjGDGqG6n-fXELkjSOAshW6zLF0RjTM8sZIOCPK7O8lJFtEBMJxoSyn_RU1lChu6sICJrebFbXZfUe8sagYyaLd8V5ASJa455oESbzsLRQVY4FAExpsYO-s9Dx-5-DCz924AVfLUeEgYvhI77SW9sOFhoAiHBEZNxcG1X_Wh05UpSA-KyKvOTTggs83zHzQi_j7w1u4xkoc1oUXuOurgdyO_RQUEt8bEbZVa7-4W0wYiwgXQ8H8ZLi-1IsYNy4xYjybIieY1yI2WKpmVYkriKR3dXwtWta3iFY1EaUVnjeR7H3qpH3gJzS4hgQIi3tIeg6frwpeshsDjVAVJDEQVmMQ3apxexldirXAd4NJIR1KohvN47JhhB0qJhAXjYShrQBb2IJ2mSG31cEm_kc3fHdfFwj72NIUGZHLS6wIpheOfzlavLvItnumxjXBBVnqLh1Am2FUypaybe_nv8VzzchvfTNuGSLRjYQ2j4nhz0Xfnmekz2Ka6VP2KfxU3-MLiDqc-BftbJWhOdPEW3IwfMr-LJD2MpO5M289kO-kpfKtoi6M3vFwLg28ndonzOyxQsVA2CqILlxDailsU6GDQDsYsgGRc3BJXAPkEF8ccKyJX6bCOOp26OWXPL6lHkEK-9XYVng-VUCCzFfyEIRBQ1Wk7n-AhJIT9J4u5FZeWF1JFEjh0YU1absTvlknN46f8LmFkK5CMh2BL9r47__m_YyoFCUoNR23DnileeJSRkDhSE9c2BwbBW90EOzJsIl4z_9qRUOENatjqeoY6jMd-shRLVVH8J2jgs_nsOVKQ87B9vzUwMGRiPM-7Udg1MsRQJxaI23DT5hXuPh4PH9rmnp6w2IhkidcrcMkbDZrg1rt70XJEtbNI0-13nhizSqNwZhNXAkm-Xh7qgTtsw9cpKm0CJ6I7eOEKcMVE6Xhabc1fZrUgTgNlh-TWFGOGLjun1OBtmYGTDz_XLmu6d4BvhmY7I7WOI7FDqZAIE74BCmigedpw2VC2CHLTmVFHmSp0mwMRxlm5Kmnie5AlPt-QGOZE5vDWU6qenIMHCsQUpD_dy3Xa2g8so3qN9N1hTudo5jTF7038O5atWXNZkOO-S5yItnbk_pUjgjiutFsm7BUCTlFcE9XhFxe4f7xJk-W6KVDq1_KAsMRVB4XyW2WtEzESaOhQ30YqQ-N-bJnOx6WaQAABwAAAAAAAAANAQAAAAAAAA2SBBhDb250ZW50LVR5cGUgYXBwbGljYXRpb24vanNvbhZBcHBsaWNhdGlvbhhDeWJlckNvbm5lY3QMU291cmNlCGF0ZW0UQ29udGVudC1JZIABODYwOTM0NmI1ZTU4ZjczMmZlYWYxOGIzNWUzZmNkY2M3NTJlNjhjNzAwM2UxMzY3OGFmZTg0NTAxMjNiMDAwMRxDb250ZW50LURpZ2VzdIABODYwOTM0NmI1ZTU4ZjczMmZlYWYxOGIzNWUzZmNkY2M3NTJlNjhjNzAwM2UxMzY3OGFmZTg0NTAxMjNiMDAwMRxDb250ZW50LUF1dGhvcho5MjU2NzQyNjI3MjcxDkNoYWluSWQENTYAeyJjb250ZW50Ijoie1wib3BcIjpcInBvc3RcIixcImFkZHJlc3NcIjpcIjB4ZTNhZmZmNWZlYjBmYTdlNmUzMmY5NGQxZjcwMzE1M2U4NDAzMGNjNlwiLFwidHNcIjoxNjkxNDYwNjI0MTgxLFwiY2hhaW5JZFwiOjU2LFwiaGFuZGxlXCI6XCI5MjU2NzQyNjI3MjcxXCIsXCJ0aXRsZVwiOlwiMTExMTJcIixcImJvZHlcIjpcIjIyMjIyMjIyMjIyMjIyMjIyMlwifSIsImRpZ2VzdCI6Ijg2MDkzNDZiNWU1OGY3MzJmZWFmMThiMzVlM2ZjZGNjNzUyZTY4YzcwMDNlMTM2NzhhZmU4NDUwMTIzYjAwMDEiLCJzaWduYXR1cmUiOiIweDc1OTIxMjBjN2EyMDAxMTQ3MzA4MjM3MTc5Y2QxYmUyNGUxOTYyOTc3MjMwY2ViMTBiN2QzOGIyMmVlOTAxZWFkYjExN2ZjMDM2MmQ0YTEyNWNjYmY0N2NmOTVlZGI5ZDIyYzRiZjZiMDM3M2M2ZTdlZmE5YmJhZGVkOTAwYTYwIiwic2lnbmluZ0tleSI6eyJwdWJsaWNLZXkiOiJNRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUUxSml5MzYwVkVTOWZ5WCs3aHFpNjJ5Z2c0SSsyOFdKdlRTSW9xZDBPSzFWcGJKVFJ0bmtIcGRQZTdHampVek9UMDY2VGNJSVVlbmZkMFd5bmZUU2RSZz09IiwiZm9ybWF0IjoiU3ViamVjdFB1YmxpY0tleUluZm8iLCJhbGdvcml0aG0iOiJFUzI1NiJ9LCJzaWduaW5nS2V5QXV0aCI6eyJhZGRyZXNzIjoiMHhlM2FmZmY1ZmViMGZhN2U2ZTMyZjk0ZDFmNzAzMTUzZTg0MDMwY2M2Iiwic2lnbmluZ0tleVNpZ25hdHVyZSI6IjB4NDA5NzE5Y2IzMTBmYTgwZDE2MWUyOTU2NzQ5M2RlZTBkMWExNGFlZjM1MmMxY2JkZWQzNjgzZWJmZDQ2M2M0NjM5NWM3YmVlMWY5ZWFlYzAyODg3MzZiNDFmN2ExMjVjZTA2MjU0NzZjNTk4ZDI1NWI2NmViOTQ4NjRmN2VmYWIxYyIsInNpZ25pbmdLZXlNZXNzYWdlIjoiSSBhdXRob3JpemUgQXRlbVJldmlldyBmcm9tIHRoaXMgZGV2aWNlIHVzaW5nIHNpZ25pbmcga2V5OlxuTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFMUppeTM2MFZFUzlmeVgrN2hxaTYyeWdnNEkrMjhXSnZUU0lvcWQwT0sxVnBiSlRSdG5rSHBkUGU3R2pqVXpPVDA2NlRjSUlVZW5mZDBXeW5mVFNkUmc9PSJ9fQEAXueKfIFm0B5wVLin_odyUWvtNpzfS67PsxWTKgiC0uBdfPCm-GL07Kdsr3sbWjPrEsceZDKXDbTuSUVL0MjW3JRtkZ2gE765gF8dL4fhMS1ckzq7SXtLG4OYdoA8RODK5ewgyMGvYE9-NthTf5WhN82XO0_Cu5ib48QF0qiO98owVoZKNPzUF359snsIFpcwL2Cjt2elYsTKBsJxt2A2dInwZo1nMvM2scuckXTLy1r7gtmOT8d9z9aIQxmGntTMgu6tGjCuXcqba0V6sv4qzGrvs_hhKtSXOXCVbg2xyvQsn5JQ384dZIYk070eGTZISNfTEK18BR4wTp6axv8Wmd59h985YMODIanwV-BQF-WieI4mrr1VkbNIldfGBv6pr85u5slk_74wFnIEHpAKOsXk_e8WhctQ9fvFG-I2GdCFn8FQ7qIdc_H0wdAFXvDSMjgDl6LINwBGhWLHWUpfgem9lkgzIObaG_gc9bAZGISrrULiBnLxhqqU66_QNaRbq2xClYU1XXcBNoub0N8NUlnWbsRowecsSz7r3nnDzoIjYJX4ryOULd2LAH9kpJ_2khwgpuTIuKMB1BrgkPF7WrGHGpBJT9eizieT5WUxsJcIZXkbjZNjwH9X2NFigrgWFTIhBJfBKgAWo1bVhRoAWMcpF1i8_amRLO0rpsgPy_Wc-BftbJWhOdPEW3IwfMr-LJD2MpO5M289kO-kpfKtoi6M3vFwLg28ndonzOyxQsVA2CqILlxDailsU6GDQDsYsgGRc3BJXAPkEF8ccKyJX6bCOOp26OWXPL6lHkEK-9XYVng-VUCCzFfyEIRBQ1Wk7n-AhJIT9J4u5FZeWF1JFEjh0YU1absTvlknN46f8LmFkK5CMh2BL9r47__m_YyoFCUoNR23DnileeJSRkDhSE9c2BwbBW90EOzJsIl4z_9qRUOENatjqeoY6jMd-shRLVVH8J2jgs_nsOVKQ87B9vzUwMGRiPM-7Udg1MsRQJxaI23DT5hXuPh4PH9rmnp6w2IhkidcrcMkbDZrg1rt70XJEtbNI0-13nhizSqNwZhNXAkm-Xh7qgTtsw9cpKm0CJ6I7eOEKcMVE6Xhabc1fZrUgTgNlh-TWFGOGLjun1OBtmYGTDz_XLmu6d4BvhmY7I7WOI7FDqZAIE74BCmigedpw2VC2CHLTmVFHmSp0mwMRxlm5Kmnie5AlPt-QGOZE5vDWU6qenIMHCsQUpD_dy3Xa2g8so3qN9N1hTudo5jTF7038O5atWXNZkOO-S5yItnbk_pUjgjiutFsm7BUCTlFcE9XhFxe4f7xJk-W6KVDq1_KAsMRVB4XyW2WtEzESaOhQ30YqQ-N-bJnOx6WaQAACAAAAAAAAAB9AQAAAAAAAA_yBRhDb250ZW50LVR5cGUgYXBwbGljYXRpb24vanNvbhZBcHBsaWNhdGlvbhhDeWJlckNvbm5lY3QcQ29udGVudC1BdXRob3IYNWptemFlN3M4aDJ4DkNoYWluSWQENTYcQ29udGVudC1UYXJnZXSAATM5ZjAyMTg4MWU3Mzg2ZjhkNzNkNmVmMjU1MzNlNjA5MWYyYTAyNTZlNDIyYjRiM2M0ZTNkMzM1Y2NhZTE0N2UMU291cmNlSDE1NTMxZmEyLTEyMDUtNGY2MS1iNmU0LWM5ZjY4ZWNmODFmNxRDb250ZW50LUlkgAE3ZGZkY2RhMDI0OTE1ZDE5MDg4YTgwY2VlNmE5MjkxYTY2NDVjNjAxN2NlMDE3ZDJlMTcxZGNkZWViZWI4YTk0HENvbnRlbnQtRGlnZXN0gAE3ZGZkY2RhMDI0OTE1ZDE5MDg4YTgwY2VlNmE5MjkxYTY2NDVjNjAxN2NlMDE3ZDJlMTcxZGNkZWViZWI4YTk0AHsiY29udGVudCI6IntcIm9wXCI6XCJjb21tZW50XCIsXCJhZGRyZXNzXCI6XCIweDVkZWExMDIzYWE1ODU0YzUzNWJlYjkyYzg4ZGI4MWRjMDI0NzEyY2FcIixcInRzXCI6MTY5MTQ2MDYyMzM2NixcImNoYWluSWRcIjo1NixcImhhbmRsZVwiOlwiNWptemFlN3M4aDJ4XCIsXCJ0YXJnZXRcIjpcIjM5ZjAyMTg4MWU3Mzg2ZjhkNzNkNmVmMjU1MzNlNjA5MWYyYTAyNTZlNDIyYjRiM2M0ZTNkMzM1Y2NhZTE0N2VcIixcInRpdGxlXCI6XCJGbGFwcHlNb29uYmlyZFwiLFwiYm9keVwiOlwiU28gZnVuIHRvIHBsYXkgaW4gbXkgc3BhcmUgdGltZS5cIn0iLCJkaWdlc3QiOiI3ZGZkY2RhMDI0OTE1ZDE5MDg4YTgwY2VlNmE5MjkxYTY2NDVjNjAxN2NlMDE3ZDJlMTcxZGNkZWViZWI4YTk0Iiwic2lnbmF0dXJlIjoiMHgzMGE0NDA3ZGM2YjMzZWVlY2Q5OGFkNWI4NWQzY2MxNThhOTEyMWYxM2U1MjdiNDU2NzM1ZWQwYzk4MWQwODZmOWJiMzM1MDU1OTE0ZDc5NjYzYjFhM2U1NGMyYzAxNzZiNjQ4NzIyNDdjMDAzZDY1N2U2MzkzMGM3OTJjMDVmZiIsInNpZ25pbmdLZXkiOnsicHVibGljS2V5IjoiTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFaTVZTjA1RkhTeEVtQlNIMU5xRmxFQlo5Znc0Sm1xdWFneGM3SGY2eWZUcHVCbDZpUXkxais4K3lLYUxKSWhvQm5RU0NNS2pWS2RlMXk5cGxKVFdGSkE9PSIsImZvcm1hdCI6IlN1YmplY3RQdWJsaWNLZXlJbmZvIiwiYWxnb3JpdGhtIjoiRVMyNTYifSwic2lnbmluZ0tleUF1dGgiOnsiYWRkcmVzcyI6IjB4NWRlYTEwMjNhYTU4NTRjNTM1YmViOTJjODhkYjgxZGMwMjQ3MTJjYSIsInNpZ25pbmdLZXlTaWduYXR1cmUiOiIweDU1NTJmNDVjN2M2YWZhYzJjZDJmMzA0YTU5OGU0ZmVkNzNkOWQ4NzU5NDc4ZDBkYTEwMmJjZWY5NzQxMWU1N2EwZDg2NjMxNGZkM2UxNTFhMmFmZjJhNDQyYmM0YTUxODkzNTE0MjVjYjYzYTIwM2ZiZTI2MWJiMTY1NTU4ODRkMWMiLCJzaWduaW5nS2V5TWVzc2FnZSI6IkkgYXV0aG9yaXplIEN5YmVyQ29ubmVjdCBmcm9tIHRoaXMgZGV2aWNlIHVzaW5nIHNpZ25pbmcga2V5OlxuTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFaTVZTjA1RkhTeEVtQlNIMU5xRmxFQlo5Znc0Sm1xdWFneGM3SGY2eWZUcHVCbDZpUXkxais4K3lLYUxKSWhvQm5RU0NNS2pWS2RlMXk5cGxKVFdGSkE9PSJ9fQEAkvMnAGqxxX1jZbZbVddDRuGu31Pgimdv6nrTQOFaTbGrQTFKHnyPGtaPGkhaAoc11xQ-oWbDfYqRRaEfGVchnJHiRoEOmJxp1vHGvvOfFma7x7BipHdXo7uaXOiC0Iq5E190eNG81iTWU9pnUWg-luT8YP3WNb_tWrMZ2dhOBAiIvuVR81kkMrooOJp_LoiOabujIoSW0oFo0vJ1PzvmCp9B9UVRTzqkurV8TQVWMltIuNeD1x0nB495UFwmuE94VG1R-JW7SUvF4WewNoLHwVonpIoHKGOhoFDhcfEDMVFLP6LpCXbSOrQnNdKRj1GOmLaw-6SJ5ZOPCGn1keVk8VDfcYBrR_pDB2wrBpBlwp2SltF6dil3S3vSO6KJrcqX83MGITMjMjhFjgzoXVgxVHhu4F3UGhhSFcdeHufY75OWZdOaVBT3dI_22cT1jA2rQI24PU3nrhh-cMbfgZAKjJyh6SWc-0mJfrpydyOkTarjDP2E5VnME5-SIJh84UpiEQLRQz0u3Yq8tr6IvHhpDHNoxWk7XWpI85HZySPYS5n3TTJLvwRDFfNqDwwSKkAWvCRD2dvdz_tmFxC1hiK53IgVEMc5qS3-HMACUJDAR0DG2Bb5XJ8SQQB371z7d3K17P3BcX9AZ0Ij9u5dCY2PrDF9SitXyf1j0xU00AjAa_qc-BftbJWhOdPEW3IwfMr-LJD2MpO5M289kO-kpfKtoi6M3vFwLg28ndonzOyxQsVA2CqILlxDailsU6GDQDsYsgGRc3BJXAPkEF8ccKyJX6bCOOp26OWXPL6lHkEK-9XYVng-VUCCzFfyEIRBQ1Wk7n-AhJIT9J4u5FZeWF1JFEjh0YU1absTvlknN46f8LmFkK5CMh2BL9r47__m_YyoFCUoNR23DnileeJSRkDhSE9c2BwbBW90EOzJsIl4z_9qRUOENatjqeoY6jMd-shRLVVH8J2jgs_nsOVKQ87B9vzUwMGRiPM-7Udg1MsRQJxaI23DT5hXuPh4PH9rmnp6w2IhkidcrcMkbDZrg1rt70XJEtbNI0-13nhizSqNwZhNXAkm-Xh7qgTtsw9cpKm0CJ6I7eOEKcMVE6Xhabc1fZrUgTgNlh-TWFGOGLjun1OBtmYGTDz_XLmu6d4BvhmY7I7WOI7FDqZAIE74BCmigedpw2VC2CHLTmVFHmSp0mwMRxlm5Kmnie5AlPt-QGOZE5vDWU6qenIMHCsQUpD_dy3Xa2g8so3qN9N1hTudo5jTF7038O5atWXNZkOO-S5yItnbk_pUjgjiutFsm7BUCTlFcE9XhFxe4f7xJk-W6KVDq1_KAsMRVB4XyW2WtEzESaOhQ30YqQ-N-bJnOx6WaQAACAAAAAAAAAB9AQAAAAAAAA_yBRhDb250ZW50LVR5cGUgYXBwbGljYXRpb24vanNvbhZBcHBsaWNhdGlvbhhDeWJlckNvbm5lY3QcQ29udGVudC1BdXRob3IYMGkxemQ1b3A0YjZ3DkNoYWluSWQENTYcQ29udGVudC1UYXJnZXSAATM5ZjAyMTg4MWU3Mzg2ZjhkNzNkNmVmMjU1MzNlNjA5MWYyYTAyNTZlNDIyYjRiM2M0ZTNkMzM1Y2NhZTE0N2UMU291cmNlSDE1NTMxZmEyLTEyMDUtNGY2MS1iNmU0LWM5ZjY4ZWNmODFmNxRDb250ZW50LUlkgAEyYmQyY2JkYmUzMzMxYWQ3ZDJmMTE3NjNlMTU3M2I5ZGFlZWQ4MTA4MTJhYTc3ZjFlNjE5MWRmZWMyZTM1MzM1HENvbnRlbnQtRGlnZXN0gAEyYmQyY2JkYmUzMzMxYWQ3ZDJmMTE3NjNlMTU3M2I5ZGFlZWQ4MTA4MTJhYTc3ZjFlNjE5MWRmZWMyZTM1MzM1AHsiY29udGVudCI6IntcIm9wXCI6XCJjb21tZW50XCIsXCJhZGRyZXNzXCI6XCIweDZjNmY3ZTBlZjRkZDZjNTUyNjE3MjQ2ZTAzZTYxMzM4Y2M2NGJiYjJcIixcInRzXCI6MTY5MTQ2MDYyMzM5OCxcImNoYWluSWRcIjo1NixcImhhbmRsZVwiOlwiMGkxemQ1b3A0YjZ3XCIsXCJ0YXJnZXRcIjpcIjM5ZjAyMTg4MWU3Mzg2ZjhkNzNkNmVmMjU1MzNlNjA5MWYyYTAyNTZlNDIyYjRiM2M0ZTNkMzM1Y2NhZTE0N2VcIixcInRpdGxlXCI6XCJGbGFwcHlNb29uYmlyZFwiLFwiYm9keVwiOlwiU28gZnVuIHRvIHBsYXkgaW4gbXkgc3BhcmUgdGltZS5cIn0iLCJkaWdlc3QiOiIyYmQyY2JkYmUzMzMxYWQ3ZDJmMTE3NjNlMTU3M2I5ZGFlZWQ4MTA4MTJhYTc3ZjFlNjE5MWRmZWMyZTM1MzM1Iiwic2lnbmF0dXJlIjoiMHhkZGI3NzlkZjY2MTMxODlkMDFhOWY3YzlmYzdjYzY3MzA4MDlkNzA1YTgzNDE5YTdlZmNlY2VhM2I0OWQ4Y2U5NGVmZjUyOTRkMGQ1YWJkZmM2OGNkM2QyNzRiMDRiZGU5ZGQyMTA5ZDIyODQ3ZTU3MjcwYTIzNGM0N2JmZjliMSIsInNpZ25pbmdLZXkiOnsicHVibGljS2V5IjoiTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFMlhCeTdjNGF1dmpCMUJ6MndaTkhyQWlTa3RualFiRnh3VlI4UTVMQTJtbDFwdnZCTHFWM3ZRV3hxLzBuUVZ2Ykt6dWRxQzMzMjU4WEtveEVDV2hIa3c9PSIsImZvcm1hdCI6IlN1YmplY3RQdWJsaWNLZXlJbmZvIiwiYWxnb3JpdGhtIjoiRVMyNTYifSwic2lnbmluZ0tleUF1dGgiOnsiYWRkcmVzcyI6IjB4NmM2ZjdlMGVmNGRkNmM1NTI2MTcyNDZlMDNlNjEzMzhjYzY0YmJiMiIsInNpZ25pbmdLZXlTaWduYXR1cmUiOiIweGQ1ODMzYWM3ZTUyMDQ3ZjJiNDBhNDIzZjNjN2IzZGVkYmUwMTBkNjUzNjU5MTExYjYxMmNkMTQxZjY3OGZmY2ExN2ZkNGNlMWZmY2Y0Nzc0YzI3YmY3NTJjNzc1OWI2ODc5NDEzYjg2MzRlYTA4MmQxNWI5Mzg0NjViY2UxMGRiMWMiLCJzaWduaW5nS2V5TWVzc2FnZSI6IkkgYXV0aG9yaXplIEN5YmVyQ29ubmVjdCBmcm9tIHRoaXMgZGV2aWNlIHVzaW5nIHNpZ25pbmcga2V5OlxuTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFMlhCeTdjNGF1dmpCMUJ6MndaTkhyQWlTa3RualFiRnh3VlI4UTVMQTJtbDFwdnZCTHFWM3ZRV3hxLzBuUVZ2Ykt6dWRxQzMzMjU4WEtveEVDV2hIa3c9PSJ9fQEAj6MA9o_vKkqo-mi60v7jqRU0usrHypgP85hp4OnKUWGGdrCmTfagUf3xnvD2vY7aTRma_EM-dPukCZLGCxnjgzV792QP3YNIWyjUve2RcLCIvrYTpxZFoc9DY7qYzebyTu0e2M80mc5R8IPLbhtyv7qq7B9ORrcs2cpDCJUkl8FbhXZkKeBevq_AdbotHmy4_js6wu5EsnREwk3fbNDPH3cAbTNlLcNGYrsAwyDXGnaoi3N5_Qrz5WJ5RmU9stMKbNvF426A2nY8mAMisg1Yvvsdk8Xp2TBJ6PIRYNBo6iFDvw38mhH000xBNwqW3ih76CkrnfbbLBEzCIYXG3VeHPUY0J_jAwlFzHlmEtGLPnPM43EZwZ_cKEyOtRXErhz68N9rkhp1JdRSPcGEYP1SBUmWLgcHuLG5UtsEpe6iAV9AXNx5SPLOKRfLJhzLv8C9w8C9txdDoy-df7H6GKtHOVe0qQ_s7Ah9dc3750qkLawZc2eTFBp4_6VLeLwCkwzQMxXkpP7XNHu4iVofcygZZgU8Yl3igrpM-a5jg7VXDtorLjS3yUmcn5ZKXd-q5eAvEd1qFx6W4iz80ilueAblDZD4alMt9tL3PukRoWSYFWTGD3VCM1JjnFeRyjfu5UvhIK4mtLEKW5UzKqeTQwuSEjygZgKvl9RgKIL3ca47L7Kc-BftbJWhOdPEW3IwfMr-LJD2MpO5M289kO-kpfKtoi6M3vFwLg28ndonzOyxQsVA2CqILlxDailsU6GDQDsYsgGRc3BJXAPkEF8ccKyJX6bCOOp26OWXPL6lHkEK-9XYVng-VUCCzFfyEIRBQ1Wk7n-AhJIT9J4u5FZeWF1JFEjh0YU1absTvlknN46f8LmFkK5CMh2BL9r47__m_YyoFCUoNR23DnileeJSRkDhSE9c2BwbBW90EOzJsIl4z_9qRUOENatjqeoY6jMd-shRLVVH8J2jgs_nsOVKQ87B9vzUwMGRiPM-7Udg1MsRQJxaI23DT5hXuPh4PH9rmnp6w2IhkidcrcMkbDZrg1rt70XJEtbNI0-13nhizSqNwZhNXAkm-Xh7qgTtsw9cpKm0CJ6I7eOEKcMVE6Xhabc1fZrUgTgNlh-TWFGOGLjun1OBtmYGTDz_XLmu6d4BvhmY7I7WOI7FDqZAIE74BCmigedpw2VC2CHLTmVFHmSp0mwMRxlm5Kmnie5AlPt-QGOZE5vDWU6qenIMHCsQUpD_dy3Xa2g8so3qN9N1hTudo5jTF7038O5atWXNZkOO-S5yItnbk_pUjgjiutFsm7BUCTlFcE9XhFxe4f7xJk-W6KVDq1_KAsMRVB4XyW2WtEzESaOhQ30YqQ-N-bJnOx6WaQAACAAAAAAAAAB9AQAAAAAAAA_yBRhDb250ZW50LVR5cGUgYXBwbGljYXRpb24vanNvbhZBcHBsaWNhdGlvbhhDeWJlckNvbm5lY3QMU291cmNlSDE1NTMxZmEyLTEyMDUtNGY2MS1iNmU0LWM5ZjY4ZWNmODFmNxRDb250ZW50LUlkgAE3NzM1NzUxZGE3NWQ1ODI1MjdkN2FkMjA2YTQ5OTc1MjE4NTYzMjZhNzA2MzFhNTc5MmEyOThmMzc1ZTRhNmYyHENvbnRlbnQtRGlnZXN0gAE3NzM1NzUxZGE3NWQ1ODI1MjdkN2FkMjA2YTQ5OTc1MjE4NTYzMjZhNzA2MzFhNTc5MmEyOThmMzc1ZTRhNmYyHENvbnRlbnQtQXV0aG9yGHJ2bTBqMHcxZjZ0bA5DaGFpbklkBDU2HENvbnRlbnQtVGFyZ2V0gAEzOWYwMjE4ODFlNzM4NmY4ZDczZDZlZjI1NTMzZTYwOTFmMmEwMjU2ZTQyMmI0YjNjNGUzZDMzNWNjYWUxNDdlAHsiY29udGVudCI6IntcIm9wXCI6XCJjb21tZW50XCIsXCJhZGRyZXNzXCI6XCIweGU0OTBlZTNjNGM3ZWRlNGMzNWRjMDExYzZlNGM2ZjkwYTUyNGMyZDRcIixcInRzXCI6MTY5MTQ2MDYyNDM1MCxcImNoYWluSWRcIjo1NixcImhhbmRsZVwiOlwicnZtMGowdzFmNnRsXCIsXCJ0YXJnZXRcIjpcIjM5ZjAyMTg4MWU3Mzg2ZjhkNzNkNmVmMjU1MzNlNjA5MWYyYTAyNTZlNDIyYjRiM2M0ZTNkMzM1Y2NhZTE0N2VcIixcInRpdGxlXCI6XCJGbGFwcHlNb29uYmlyZFwiLFwiYm9keVwiOlwiU28gZnVuIHRvIHBsYXkgaW4gbXkgc3BhcmUgdGltZS5cIn0iLCJkaWdlc3QiOiI3NzM1NzUxZGE3NWQ1ODI1MjdkN2FkMjA2YTQ5OTc1MjE4NTYzMjZhNzA2MzFhNTc5MmEyOThmMzc1ZTRhNmYyIiwic2lnbmF0dXJlIjoiMHg5ODY1NDljMWRjZDQ4MTNiYjRkZmVkZjQ0NmE1MWRiMWI5MTg5ZjZkZTVhOWE4ZWI5N2QyYmY2NzAxYWNiZTI1OWMyMjA4ZDZkZDE2ODUxOGI0NjY0MTIwZDUyOGMzNzJlOTM0NjA0ZGZlN2MzZDE3MWQxNjBhYjYyMzMxMGY2YiIsInNpZ25pbmdLZXkiOnsicHVibGljS2V5IjoiTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFREJRWE9UN2xmL05ueDlqNkhSejROUzM3ajVVYkFvYzJtV0pUYTkvaE95TGtObGRsaDdRSFYyRnAvWU10emQyVDBEOStoWHBrUmtQR0xMeWdrUWUyTEE9PSIsImZvcm1hdCI6IlN1YmplY3RQdWJsaWNLZXlJbmZvIiwiYWxnb3JpdGhtIjoiRVMyNTYifSwic2lnbmluZ0tleUF1dGgiOnsiYWRkcmVzcyI6IjB4ZTQ5MGVlM2M0YzdlZGU0YzM1ZGMwMTFjNmU0YzZmOTBhNTI0YzJkNCIsInNpZ25pbmdLZXlTaWduYXR1cmUiOiIweGJhZWYyMzRiMTFmMDg1NTc2MmZkOTg3OGRiMWM2MDVkNGUwOGE3YjIxNDRiZjNiM2M0YmI5ZTc5NTRkM2ZmZWM2NjE0MGU5NzVjNGM5NDdjM2E0YzdhMmUzY2Y2MjAzODFmMmE2MTIzNDFiYzc1NjNmMmRhNGQ1MzViZDEyMzMxMWMiLCJzaWduaW5nS2V5TWVzc2FnZSI6IkkgYXV0aG9yaXplIEN5YmVyQ29ubmVjdCBmcm9tIHRoaXMgZGV2aWNlIHVzaW5nIHNpZ25pbmcga2V5OlxuTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFREJRWE9UN2xmL05ueDlqNkhSejROUzM3ajVVYkFvYzJtV0pUYTkvaE95TGtObGRsaDdRSFYyRnAvWU10emQyVDBEOStoWHBrUmtQR0xMeWdrUWUyTEE9PSJ9fQEACM7s6Tr7rDyKzchgY4qVdyRZYnArKLF71Vy465VtLp18MOJ9Nuj1oP2uwHWmLsnFg5Gifcr9YIsqLtOCqcmSOrsZGKDOnGvaXjHI7suHs7Qmo2uCXbcxZCbC0VSB3kB2M4uM_zvGjfr4FZk6_b2TBLND4EuXllycDgXnewaR3qskG7BjjQMn16rKjRa-Hax7IBVoQNddpqRTeQQwip0W95xI0JK6CcVyu-76ZVHt3mQMrv0v3NjBSlaWx2gebEopLAw9B8b5cJWtxI75A8o6sTBbQXeDwYP3a7mr_jVA1H_eDVPfp5sU7BKu3CPoVTE3AoWupR_i-naERzT0XekIEdZYbdaVen9Wdu_uwgGuXku_tZSPpn_6YYbSfuJ42Ph4Ov8Wldu4sRAReas4Fw7xPnB9DqzpIXw5lZxnnLDn04xt4M-nJlh3mdDTVJdG8UdhIZoV9eT-3YPLytPKzNwlNKKeqR_N6PzHVBtocok-fHEJ-jv_8h5fnr4pNNgX22F3U6XijffzgrWY-0i-qpvX0s0secrtbyinsU1jZamWd6gxpQBOGjTBRSY5Hc756FW4b5dSaLFi7wokqJPhQ9G7XEblrf_EaV-EoQVxkMv6FZAm60VawZLxCE_25uJiA-ac1F05dJL2p7MdTTq_Uh1pB2R4A14qXWjtswhECNgAJ02c-BftbJWhOdPEW3IwfMr-LJD2MpO5M289kO-kpfKtoi6M3vFwLg28ndonzOyxQsVA2CqILlxDailsU6GDQDsYsgGRc3BJXAPkEF8ccKyJX6bCOOp26OWXPL6lHkEK-9XYVng-VUCCzFfyEIRBQ1Wk7n-AhJIT9J4u5FZeWF1JFEjh0YU1absTvlknN46f8LmFkK5CMh2BL9r47__m_YyoFCUoNR23DnileeJSRkDhSE9c2BwbBW90EOzJsIl4z_9qRUOENatjqeoY6jMd-shRLVVH8J2jgs_nsOVKQ87B9vzUwMGRiPM-7Udg1MsRQJxaI23DT5hXuPh4PH9rmnp6w2IhkidcrcMkbDZrg1rt70XJEtbNI0-13nhizSqNwZhNXAkm-Xh7qgTtsw9cpKm0CJ6I7eOEKcMVE6Xhabc1fZrUgTgNlh-TWFGOGLjun1OBtmYGTDz_XLmu6d4BvhmY7I7WOI7FDqZAIE74BCmigedpw2VC2CHLTmVFHmSp0mwMRxlm5Kmnie5AlPt-QGOZE5vDWU6qenIMHCsQUpD_dy3Xa2g8so3qN9N1hTudo5jTF7038O5atWXNZkOO-S5yItnbk_pUjgjiutFsm7BUCTlFcE9XhFxe4f7xJk-W6KVDq1_KAsMRVB4XyW2WtEzESaOhQ30YqQ-N-bJnOx6WaQAABwAAAAAAAAAMAQAAAAAAAA2QBBhDb250ZW50LVR5cGUgYXBwbGljYXRpb24vanNvbhZBcHBsaWNhdGlvbhhDeWJlckNvbm5lY3QcQ29udGVudC1BdXRob3IYem53eHczNjF3eW1wDkNoYWluSWQENTYMU291cmNlCGF0ZW0UQ29udGVudC1JZIABOGZhYjViNDExMDJiMTFhNDhkZWJiYzViNjg0NDIxMTI5MjM5NTYzZjA4YzRhYWJmOWMzNmYyZmJjMzc2Mzg2ZRxDb250ZW50LURpZ2VzdIABOGZhYjViNDExMDJiMTFhNDhkZWJiYzViNjg0NDIxMTI5MjM5NTYzZjA4YzRhYWJmOWMzNmYyZmJjMzc2Mzg2ZQB7ImNvbnRlbnQiOiJ7XCJvcFwiOlwicG9zdFwiLFwiYWRkcmVzc1wiOlwiMHhlMTVmYzUxMTYwZDI1YTYyMzQyZTdlZTdkNGVjMGExMDdlZDBmNWU0XCIsXCJ0c1wiOjE2OTE0NjA2MjQ0MDYsXCJjaGFpbklkXCI6NTYsXCJoYW5kbGVcIjpcInpud3h3MzYxd3ltcFwiLFwidGl0bGVcIjpcIjExMTEyXCIsXCJib2R5XCI6XCIyMjIyMjIyMjIyMjIyMjIyMjJcIn0iLCJkaWdlc3QiOiI4ZmFiNWI0MTEwMmIxMWE0OGRlYmJjNWI2ODQ0MjExMjkyMzk1NjNmMDhjNGFhYmY5YzM2ZjJmYmMzNzYzODZlIiwic2lnbmF0dXJlIjoiMHhmM2YyYTRhNzJmNDY3MGNhYWI4MmQ1ZTRiYzgxYjRkYWU2YzNiNWQ3NDMzYzJkNWNjNWJmMjc2ODk0MzYwNjFiZTVkNjk4YTE0NzAyNzJjMTI0ZjcwNDI2MTQyN2E1MmExYTJlYTE4MzQyZTI2NGYxODhmYWJjMmM5OWIwMTUyZCIsInNpZ25pbmdLZXkiOnsicHVibGljS2V5IjoiTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFdnppZFJsTllIdEUrazR5R2Q5bjJOVWNPajJLeGZ3T2J3T1doLzdwVnR5OXlQYnBTb3hOQUIvdnBPODFCdFZpN0t3U3UxcVNWRXhCT1lmZ05VTW1kR3c9PSIsImZvcm1hdCI6IlN1YmplY3RQdWJsaWNLZXlJbmZvIiwiYWxnb3JpdGhtIjoiRVMyNTYifSwic2lnbmluZ0tleUF1dGgiOnsiYWRkcmVzcyI6IjB4ZTE1ZmM1MTE2MGQyNWE2MjM0MmU3ZWU3ZDRlYzBhMTA3ZWQwZjVlNCIsInNpZ25pbmdLZXlTaWduYXR1cmUiOiIweDliNDc1OWMyNTZkNjNiYzM1M2RlYmEzMmViMDE5NWEzMWE3NDg1MTNiMjM1ZWYxOTJlOTAyNGI3N2E0ZGFiM2YzYTA4MDcyYzI4MGY0MTAyNzJhMDBmYjI5YWY1MTg1YjE4OGYwZDQzZjg5MDExYzE4ZDk1NzI0MDA1OTZkZmEzMWMiLCJzaWduaW5nS2V5TWVzc2FnZSI6IkkgYXV0aG9yaXplIEF0ZW1SZXZpZXcgZnJvbSB0aGlzIGRldmljZSB1c2luZyBzaWduaW5nIGtleTpcbk1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRXZ6aWRSbE5ZSHRFK2s0eUdkOW4yTlVjT2oyS3hmd09id09XaC83cFZ0eTl5UGJwU294TkFCL3ZwTzgxQnRWaTdLd1N1MXFTVkV4Qk9ZZmdOVU1tZEd3PT0ifX0BABKPnmUhWwx73U3CW5F5_WN2OH3MQnMv8MtTntOnWZw2BlC9fLWc7SZkotSsM4ZaQiPmWww_bg6aa6mqgr2sBqBODmXErwZs4z8xe0bpmx7B2rDrmOjYM6cfkg2L-u04maT9eQVJTMk_SP_EMz8VC1KhXHfd1ZV-CB5uuJ8GWh6Sr-L5_Hb4ghYmnu1174MEXWpvhSE3qHQRkaJne1eReQtaFAjvmotUHDMSFYir7FwtddaVa4uF4oT60_9_5ffMmgdzz2o3ZB5_nFaEAMIibdTJemgubDkFyaYepNBbnUX7zfmeYuXRLy-zewC9yqyRLayXlgfHtFMoTTBrwXG8cDLyZlXiRGUtOyWFcl0eVA_4Y5Vr8gxzV7Id4BlLPC_OLugTnQJ4bCNq-boxhsz8hXEXb9h6olOI2lnMe5ge4VprDote4uKqjCdGvGK_IVdLZQDtSdKtV-v6_4Wi9_tbeb9jdVY_GBzyuv-HVMm9dBcL5dBS14rmHEegejwObxx-N0ekst3R6N_G5ldne6TtNQ0XgSvRsOehORloDbsDFyUWiwk84Pw0ag4fIjDt-AsqcYmBxA_H_-hSlZ6BnnGvmydz6H6iajbS563FVImbCkovEAuQNaVrZ0xxhYoOi0N-CiZ8QUMXPGIm_CRYSiQ2m94BMU-FFwOLcHeOLBedtkhHnPgX7WyVoTnTxFtyMHzK_iyQ9jKTuTNvPZDvpKXyraIujN7xcC4NvJ3aJ8zssULFQNgqiC5cQ2opbFOhg0A7GLIBkXNwSVwD5BBfHHCsiV-mwjjqdujllzy-pR5BCvvV2FZ4PlVAgsxX8hCEQUNVpO5_gISSE_SeLuRWXlhdSRRI4dGFNWm7E75ZJzeOn_C5hZCuQjIdgS_a-O__5v2MqBQlKDUdtw54pXniUkZA4UhPXNgcGwVvdBDsybCJeM__akVDhDWrY6nqGOozHfrIUS1VR_Cdo4LP57DlSkPOwfb81MDBkYjzPu1HYNTLEUCcWiNtw0-YV7j4eDx_a5p6esNiIZInXK3DJGw2a4Na7e9FyRLWzSNPtd54Ys0qjcGYTVwJJvl4e6oE7bMPXKSptAieiO3jhCnDFROl4Wm3NX2a1IE4DZYfk1hRjhi47p9TgbZmBkw8_1y5runeAb4ZmOyO1jiOxQ6mQCBO-AQpooHnacNlQtghy05lRR5kqdJsDEcZZuSpp4nuQJT7fkBjmRObw1lOqnpyDBwrEFKQ_3ct12toPLKN6jfTdYU7naOY0xe9N_DuWrVlzWZDjvkuciLZ25P6VI4I4rrRbJuwVAk5RXBPV4RcXuH-8SZPluilQ6tfygLDEVQeF8ltlrRMxEmjoUN9GKkPjfmyZzselmkAAAgAAAAAAAAAfQEAAAAAAAAP8gUYQ29udGVudC1UeXBlIGFwcGxpY2F0aW9uL2pzb24WQXBwbGljYXRpb24YQ3liZXJDb25uZWN0FENvbnRlbnQtSWSAATU5ODAzNmZiYTkxYjBlOTMxMDExODg1MmRhY2VlMDBjM2ZhYTdkMWM3MDI0MGI1ZTI2NDYxMDM0ZDRkNDZlNzIcQ29udGVudC1EaWdlc3SAATU5ODAzNmZiYTkxYjBlOTMxMDExODg1MmRhY2VlMDBjM2ZhYTdkMWM3MDI0MGI1ZTI2NDYxMDM0ZDRkNDZlNzIcQ29udGVudC1BdXRob3IYOXRvdHVpaHA3MTh2DkNoYWluSWQENTYcQ29udGVudC1UYXJnZXSAATM5ZjAyMTg4MWU3Mzg2ZjhkNzNkNmVmMjU1MzNlNjA5MWYyYTAyNTZlNDIyYjRiM2M0ZTNkMzM1Y2NhZTE0N2UMU291cmNlSDE1NTMxZmEyLTEyMDUtNGY2MS1iNmU0LWM5ZjY4ZWNmODFmNwB7ImNvbnRlbnQiOiJ7XCJvcFwiOlwiY29tbWVudFwiLFwiYWRkcmVzc1wiOlwiMHhlZDIwMDc1ZThiMTZlMWNmNTE0NzdlM2Y3OTc5ZmQ5MTliZDI5NzYzXCIsXCJ0c1wiOjE2OTE0NjA2MjM2NjUsXCJjaGFpbklkXCI6NTYsXCJoYW5kbGVcIjpcIjl0b3R1aWhwNzE4dlwiLFwidGFyZ2V0XCI6XCIzOWYwMjE4ODFlNzM4NmY4ZDczZDZlZjI1NTMzZTYwOTFmMmEwMjU2ZTQyMmI0YjNjNGUzZDMzNWNjYWUxNDdlXCIsXCJ0aXRsZVwiOlwiRmxhcHB5TW9vbmJpcmRcIixcImJvZHlcIjpcIlNvIGZ1biB0byBwbGF5IGluIG15IHNwYXJlIHRpbWUuXCJ9IiwiZGlnZXN0IjoiNTk4MDM2ZmJhOTFiMGU5MzEwMTE4ODUyZGFjZWUwMGMzZmFhN2QxYzcwMjQwYjVlMjY0NjEwMzRkNGQ0NmU3MiIsInNpZ25hdHVyZSI6IjB4NzNmOGNmZGZiNmM1ZTZiYTNmZmU3ZDQ0ODI0Y2M0ZmRjYTM0MWM3Y2VkMmIwMjcwNzFiODlhYWE3MTc1YTVmMGFkM2E4MzVmY2Q3MjVkMzg1ZTcyMjU0YTZjOTY1ZDA4YThmMDAyZjNjN2Y2MzViZjVmM2VhMGExMDMzNjVhMTUiLCJzaWduaW5nS2V5Ijp7InB1YmxpY0tleSI6Ik1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRStSbEk0VWM1WW8rQ05sWWw5WFBaUjdZampzVVAvSXFTRjlmSC9tLzZyeTJUdTBlS2c5cS9yaXpyTVhRQ2FhcksxQ0djZXZMcFZPa00wRXhpSkkxNDVBPT0iLCJmb3JtYXQiOiJTdWJqZWN0UHVibGljS2V5SW5mbyIsImFsZ29yaXRobSI6IkVTMjU2In0sInNpZ25pbmdLZXlBdXRoIjp7ImFkZHJlc3MiOiIweGVkMjAwNzVlOGIxNmUxY2Y1MTQ3N2UzZjc5NzlmZDkxOWJkMjk3NjMiLCJzaWduaW5nS2V5U2lnbmF0dXJlIjoiMHhjNmE0NWU3ZjgxMzY1YzQ3ODljMWQ2MzMyOTkyNjI3Njk2MzYzZWNlNTlhZjc4ZWE5YmZjMmFhZDUyNjViYWU1MzFlOWVjZGY3ZGU0NDUzMmRmMWQ0MGM2YTZhNDdlMTA4MWRjMmZkZTAzMzFmNWMwMGJhYzgwZDZlM2ZmNWU4NTFiIiwic2lnbmluZ0tleU1lc3NhZ2UiOiJJIGF1dGhvcml6ZSBDeWJlckNvbm5lY3QgZnJvbSB0aGlzIGRldmljZSB1c2luZyBzaWduaW5nIGtleTpcbk1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRStSbEk0VWM1WW8rQ05sWWw5WFBaUjdZampzVVAvSXFTRjlmSC9tLzZyeTJUdTBlS2c5cS9yaXpyTVhRQ2FhcksxQ0djZXZMcFZPa00wRXhpSkkxNDVBPT0ifX0BAIdVIKxewDm5EmGscWsx72pr8JQxgU_vaOz1iHDDw1_JDdOvRy95cKhzDkdsb4TNt2txMomjypMiueTfg8-OpcveaasTuuG7ymu5BkjEQDaO1EC1lMLhuY5cGoT0Mv5zMDhHBHY023Ydef_mCkNj5I8eFSZllSojA3OJSR6Mu3_rhZEs-BxPbFOJarSNMCjhg2wRzGXqF8OMVgbq2GF4LxYKnsD-ZHIdLN-fkFmhvytMiwhWhF6WFIko9rUvFeuNBNdkSD1gN2GWiZsVrhcN4gsYGpzoIi0OImhAg_hgROK5NFuH4yQH-94Zxi9pJYhSMGFkS_xG1R1VfqY3j_Xlc3gqHyEPcGpOpcUQb0s1-hK5n5izi2jH9AUy_PAfSTlJ6P_OOyr14I65NA0RykGt2cATSQ7_zW_FdgO0yhPFSGMTUi-C57vK2wf9i5geOkUwO9VZZqArkupYKqYk4YeeDcI7eBYR4lNQWQ5htB_IsT1jGSHgwhpT0EN4t5CCQJygeZnwqvsoTTmqSE08vnwqOxMJDnuWva-wjMMmT3iii3AGGiDFKHrdo_fCnZn0wa_lIQ5lc1WTcIufp8L5lTR-EuLPicDjXn25RRS2np5qf-t9QDcORmfqZGMxRlW7DEM1jEhUqjvUBt816ded3Q9F_OsIGxi-v4JoCv33hjhRJ45SnPgX7WyVoTnTxFtyMHzK_iyQ9jKTuTNvPZDvpKXyraIujN7xcC4NvJ3aJ8zssULFQNgqiC5cQ2opbFOhg0A7GLIBkXNwSVwD5BBfHHCsiV-mwjjqdujllzy-pR5BCvvV2FZ4PlVAgsxX8hCEQUNVpO5_gISSE_SeLuRWXlhdSRRI4dGFNWm7E75ZJzeOn_C5hZCuQjIdgS_a-O__5v2MqBQlKDUdtw54pXniUkZA4UhPXNgcGwVvdBDsybCJeM__akVDhDWrY6nqGOozHfrIUS1VR_Cdo4LP57DlSkPOwfb81MDBkYjzPu1HYNTLEUCcWiNtw0-YV7j4eDx_a5p6esNiIZInXK3DJGw2a4Na7e9FyRLWzSNPtd54Ys0qjcGYTVwJJvl4e6oE7bMPXKSptAieiO3jhCnDFROl4Wm3NX2a1IE4DZYfk1hRjhi47p9TgbZmBkw8_1y5runeAb4ZmOyO1jiOxQ6mQCBO-AQpooHnacNlQtghy05lRR5kqdJsDEcZZuSpp4nuQJT7fkBjmRObw1lOqnpyDBwrEFKQ_3ct12toPLKN6jfTdYU7naOY0xe9N_DuWrVlzWZDjvkuciLZ25P6VI4I4rrRbJuwVAk5RXBPV4RcXuH-8SZPluilQ6tfygLDEVQeF8ltlrRMxEmjoUN9GKkPjfmyZzselmkAAAcAAAAAAAAAFgEAAAAAAAANpAQYQ29udGVudC1UeXBlIGFwcGxpY2F0aW9uL2pzb24WQXBwbGljYXRpb24YQ3liZXJDb25uZWN0FENvbnRlbnQtSWSAATA0Y2NhOGFmOGQ3YzM4NzgyNjY2Y2JiZTYwNGIzY2NmOTU2MDI1MjkwMjY2YjkxNmI3MDAwYzdjMTk2OTgzYjgcQ29udGVudC1EaWdlc3SAATA0Y2NhOGFmOGQ3YzM4NzgyNjY2Y2JiZTYwNGIzY2NmOTU2MDI1MjkwMjY2YjkxNmI3MDAwYzdjMTk2OTgzYjgcQ29udGVudC1BdXRob3IiY3Voa3RkcHNxY2xoZnlhODYOQ2hhaW5JZAQ1NgxTb3VyY2USY3liZXJ0dW5lAHsiY29udGVudCI6IntcIm9wXCI6XCJwb3N0XCIsXCJhZGRyZXNzXCI6XCIweDExNGNlMTNiMzJmZGY4MjEzM2YxNTUzMTAyYTc0Y2U5NGQ3ZGEyODVcIixcInRzXCI6MTY5MTQ2MDYyNDY3NCxcImNoYWluSWRcIjo1NixcImhhbmRsZVwiOlwiY3Voa3RkcHNxY2xoZnlhODZcIixcInRpdGxlXCI6XCJUaGUgUG9ydHJhaXQgb2YgdGhlIEludmlzaWJsZSBXb21hblwiLFwiYm9keVwiOlwiWW91ciBwb3N0IHdhcyBib3RoIGluZm9ybWF0aXZlIGFuZCB3ZWxsLXdyaXR0ZW4uIFRoYW5rcyBmb3Igc2hhcmluZyB5b3VyIGV4cGVydGlzZS5cIn0iLCJkaWdlc3QiOiIwNGNjYThhZjhkN2MzODc4MjY2NmNiYmU2MDRiM2NjZjk1NjAyNTI5MDI2NmI5MTZiNzAwMGM3YzE5Njk4M2I4Iiwic2lnbmF0dXJlIjoiMHhlOGZhOWY5ODViNDUxZDdmZjAyNTVjNzdmZjNlNzc1YmIxYmVkYWQwYWY3ZDg4MTkxM2NmMDk5ZmU1NjNmODljZjYwZTg1MWNjMmZhNTVmMTJiMjFhZDBlMGEzNGU5NGQzYWU4MjYzYmRlZjBlM2EzNWM4Yzc0NjgzNmM5MmMxOCIsInNpZ25pbmdLZXkiOnsicHVibGljS2V5IjoiTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFckVNR3E5VW1XazdXa05OY3ZlVUJaUS92NnhabmdtMWp0Ky9nQVU3ZVI0L2hxZWxyQkN2K2FBNGpyMHA2MUxiTTBlcVl5ZGpydndCcXNBNDR2VEFYSmc9PSIsImZvcm1hdCI6IlN1YmplY3RQdWJsaWNLZXlJbmZvIiwiYWxnb3JpdGhtIjoiRVMyNTYifSwic2lnbmluZ0tleUF1dGgiOnsiYWRkcmVzcyI6IjB4MTE0Y2UxM2IzMmZkZjgyMTMzZjE1NTMxMDJhNzRjZTk0ZDdkYTI4NSIsInNpZ25pbmdLZXlTaWduYXR1cmUiOiIweGQ4ODlkMzIwMGNlYTlmMjVkMDgyZjliOTM2ZWI1OWNkYmQ3NTYzMGUzNGJjNDU5YmRiMzAzNzBkYTk0NWUyYjk1NDAwMTcwYjY2NTE3OWMzNWUxMzI1YjIyNWQwNGVjY2NjNTcwYzkwZmE0NjkyNGFhNGY4MTMxYzQ4NDdlMDBkMWIiLCJzaWduaW5nS2V5TWVzc2FnZSI6IkkgYXV0aG9yaXplIEkgYXV0aG9yaXplIEN5YmVyVHVuZS54eXogZnJvbSB0aGlzIGRldmljZSB1c2luZyBzaWduaW5nIGtleTpcbk1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRXJFTUdxOVVtV2s3V2tOTmN2ZVVCWlEvdjZ4Wm5nbTFqdCsvZ0FVN2VSNC9ocWVsckJDdithQTRqcjBwNjFMYk0wZXFZeWRqcnZ3QnFzQTQ0dlRBWEpnPT0ifX0BADM3VeePELZ5yBNHp0RVcIcMNmvI5q0Lbup0LWRpa1rtVx3YNajlS2ysmOJbdwZ21HIDnbYQ8y6KSbvO4S4J_ArD_wHhatpfZ0teY_Vi-QeXoeHjcVpDN5X3ovuzMpKvvULaFcjVfmm4gZKmffVz-AHYjj7ZeQLY1tBoEGoADuuCkGt91wRdqg5gnBHcvt4cm14xzarUFwQF2ZeDcnWz-UG5kLILgW_Drm2-J1L697-AO9tvInXdWAnkZLS8tm3pJQaO2VZDmA0VEeUiyFwIlAgPByQyjJ4cyjI5CJu0FlkiX8a5SyZKVDEVXpdrCYwCUihHKI9Y2k-cMXSkhiuZU58dhsjIQ6PSkSgZm5gUkog4iRC3g9qEIoTOQkJY3h2gQjOArhKmVq6tE9U05grCRCN6TprygbocjG815fBUHSDkGHKxj5kf7bKpIc3_jsSMVznwS8W6E-hlfhzUJv6GLleLFWpkq3mezqIgLhcygDc6sJfAyKRbmC9STe9O3CbtmLHIsz1YMDQVOsrn7FEvEnvOCOMaW3q7jx5tNefMFLBTQx9bIzUbhxfG6CeDVOZwpdzzy-qtvOkSAY9H4X9lmdwtfg1EjaHqyX1qoKwXfPcpzNJytXccL5_NRCy0uvC2732rvwCgTo1YY25gCf5vGpQy4kuOvQBsvz1JWH6Rm_sdnPgX7WyVoTnTxFtyMHzK_iyQ9jKTuTNvPZDvpKXyraIujN7xcC4NvJ3aJ8zssULFQNgqiC5cQ2opbFOhg0A7GLIBkXNwSVwD5BBfHHCsiV-mwjjqdujllzy-pR5BCvvV2FZ4PlVAgsxX8hCEQUNVpO5_gISSE_SeLuRWXlhdSRRI4dGFNWm7E75ZJzeOn_C5hZCuQjIdgS_a-O__5v2MqBQlKDUdtw54pXniUkZA4UhPXNgcGwVvdBDsybCJeM__akVDhDWrY6nqGOozHfrIUS1VR_Cdo4LP57DlSkPOwfb81MDBkYjzPu1HYNTLEUCcWiNtw0-YV7j4eDx_a5p6esNiIZInXK3DJGw2a4Na7e9FyRLWzSNPtd54Ys0qjcGYTVwJJvl4e6oE7bMPXKSptAieiO3jhCnDFROl4Wm3NX2a1IE4DZYfk1hRjhi47p9TgbZmBkw8_1y5runeAb4ZmOyO1jiOxQ6mQCBO-AQpooHnacNlQtghy05lRR5kqdJsDEcZZuSpp4nuQJT7fkBjmRObw1lOqnpyDBwrEFKQ_3ct12toPLKN6jfTdYU7naOY0xe9N_DuWrVlzWZDjvkuciLZ25P6VI4I4rrRbJuwVAk5RXBPV4RcXuH-8SZPluilQ6tfygLDEVQeF8ltlrRMxEmjoUN9GKkPjfmyZzselmkAAAgAAAAAAAAAfQEAAAAAAAAP8gUYQ29udGVudC1UeXBlIGFwcGxpY2F0aW9uL2pzb24WQXBwbGljYXRpb24YQ3liZXJDb25uZWN0HENvbnRlbnQtQXV0aG9yGGJmbTdmaWk0NHNyeA5DaGFpbklkBDU2HENvbnRlbnQtVGFyZ2V0gAEzOWYwMjE4ODFlNzM4NmY4ZDczZDZlZjI1NTMzZTYwOTFmMmEwMjU2ZTQyMmI0YjNjNGUzZDMzNWNjYWUxNDdlDFNvdXJjZUgxNTUzMWZhMi0xMjA1LTRmNjEtYjZlNC1jOWY2OGVjZjgxZjcUQ29udGVudC1JZIABN2UwNjU4YzYxZmNkMzkwNTVhZGJlZmE1MWU3YzJjNGNiODVhZTVjNjc0OWI5ZDM5ZTYwNWIyNGNkMDkzYTY1YhxDb250ZW50LURpZ2VzdIABN2UwNjU4YzYxZmNkMzkwNTVhZGJlZmE1MWU3YzJjNGNiODVhZTVjNjc0OWI5ZDM5ZTYwNWIyNGNkMDkzYTY1YgB7ImNvbnRlbnQiOiJ7XCJvcFwiOlwiY29tbWVudFwiLFwiYWRkcmVzc1wiOlwiMHgzODE0ZWYxZjQyNWVmMzFiYmI0MzEyY2IyMjAwODA1YTgzZGQwMjE3XCIsXCJ0c1wiOjE2OTE0NjA2MjM2NTQsXCJjaGFpbklkXCI6NTYsXCJoYW5kbGVcIjpcImJmbTdmaWk0NHNyeFwiLFwidGFyZ2V0XCI6XCIzOWYwMjE4ODFlNzM4NmY4ZDczZDZlZjI1NTMzZTYwOTFmMmEwMjU2ZTQyMmI0YjNjNGUzZDMzNWNjYWUxNDdlXCIsXCJ0aXRsZVwiOlwiRmxhcHB5TW9vbmJpcmRcIixcImJvZHlcIjpcIlNvIGZ1biB0byBwbGF5IGluIG15IHNwYXJlIHRpbWUuXCJ9IiwiZGlnZXN0IjoiN2UwNjU4YzYxZmNkMzkwNTVhZGJlZmE1MWU3YzJjNGNiODVhZTVjNjc0OWI5ZDM5ZTYwNWIyNGNkMDkzYTY1YiIsInNpZ25hdHVyZSI6IjB4MmI4ZGVmY2IyNDZmZDI3YjdmODQxMDQ0MDJiNzI2YzEyNjlhYzdlZjgxYzE3NDg4YzcwZGY1ZmM0NjcxMTYwYjYyZWUwZGI0MWUxZDY2ZWQ2OGRkN2FlN2UzYmIyMmJjMDVmMDI3ZjE0MjY5YTZiMGVjYTZmNWViMjJjODgxMzAiLCJzaWduaW5nS2V5Ijp7InB1YmxpY0tleSI6Ik1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRTRLcHh5YVVFeHc5aXFaMit3L0FBcWFPOUFZRVd2aWp3RlEybjNXZGk5dHVleUlPZkRVZ1lwbHpES2o3cTh4aXJGWUZ4R0haZC9KZ2d5RDZmUkNWRXJnPT0iLCJmb3JtYXQiOiJTdWJqZWN0UHVibGljS2V5SW5mbyIsImFsZ29yaXRobSI6IkVTMjU2In0sInNpZ25pbmdLZXlBdXRoIjp7ImFkZHJlc3MiOiIweDM4MTRlZjFmNDI1ZWYzMWJiYjQzMTJjYjIyMDA4MDVhODNkZDAyMTciLCJzaWduaW5nS2V5U2lnbmF0dXJlIjoiMHgwNDQ2MjQ0ZDJhODQ0MTQ0MzRjZGZkNThkZTlkNjUwZGY2NDdmY2FlZWNkMmFjN2JkNmE3OWQzYTYyMWJiNWRlNDNlZGYzOGU2YjllNjg5OTNjZDFjYmVkOWI1Nzk1NTkyN2M0YTYzZjM0ODM5NWRlY2VkOGU0MDJmY2EwNDYwYTFjIiwic2lnbmluZ0tleU1lc3NhZ2UiOiJJIGF1dGhvcml6ZSBDeWJlckNvbm5lY3QgZnJvbSB0aGlzIGRldmljZSB1c2luZyBzaWduaW5nIGtleTpcbk1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRTRLcHh5YVVFeHc5aXFaMit3L0FBcWFPOUFZRVd2aWp3RlEybjNXZGk5dHVleUlPZkRVZ1lwbHpES2o3cTh4aXJGWUZ4R0haZC9KZ2d5RDZmUkNWRXJnPT0ifX0BAFJpEsI7e5Kzo0XFLHqa1JupQ4vf9KwLZnumpS9BY8Cjkz93YirNnUhYIEM_-CADChI3Z-PS9A2EtaNH_CVpN2fEyPduTTRIsTDBljahKg_OlzAcKkOGrkreitW290n5YQIDa-8h9bmSUE1HYPyDvquvcAgAuO_bZBKerU5P8-abLR0IQBxXbbc2F6Ic-kLIbAr32tAr-NcRmUgMddrR2muDPmththOmoBBynPQT5c3Wm_mF0fAdJpgQWCcEj2iexXP79bZFnzDPnH8lVzrLc9E9I8LiLbxhJbhLg34hhijDTZjCsWaQo8r772ns8IUf47U-6l4sQKRGNO6Zj80XynlpVaZobDzIw-1Jmh2btyZVCp3VSWdh4TsFoWIL0JDSvnJ85d_VKrgkWuc9uCBQuWcSNsnGqAcUzXsHnuUCvZtcy5-YD02eNNKRel0jIk-mp3VjlL1_9kzjj4ykkLtOGet67l5bj2tNJ8OKuQGQAN2lpmNqoltGDGcHiCRlyFgFOYNadNzCWhRu69Y0QOtrI_upTKbG3c3UYd8LigzXSAlstU5pLmkQ8DhY8RLaPJjGQOfJqTpWPGEzGFPgdkJFiNPPuflwaGwjaTxtBQwMxsrpOGMIv-aSzjf-dYdF0cRgO-mFbisWUB7FN5IMZU3IAfRTaE30DaE57qDeXPxQYoj1nPgX7WyVoTnTxFtyMHzK_iyQ9jKTuTNvPZDvpKXyraIujN7xcC4NvJ3aJ8zssULFQNgqiC5cQ2opbFOhg0A7GLIBkXNwSVwD5BBfHHCsiV-mwjjqdujllzy-pR5BCvvV2FZ4PlVAgsxX8hCEQUNVpO5_gISSE_SeLuRWXlhdSRRI4dGFNWm7E75ZJzeOn_C5hZCuQjIdgS_a-O__5v2MqBQlKDUdtw54pXniUkZA4UhPXNgcGwVvdBDsybCJeM__akVDhDWrY6nqGOozHfrIUS1VR_Cdo4LP57DlSkPOwfb81MDBkYjzPu1HYNTLEUCcWiNtw0-YV7j4eDx_a5p6esNiIZInXK3DJGw2a4Na7e9FyRLWzSNPtd54Ys0qjcGYTVwJJvl4e6oE7bMPXKSptAieiO3jhCnDFROl4Wm3NX2a1IE4DZYfk1hRjhi47p9TgbZmBkw8_1y5runeAb4ZmOyO1jiOxQ6mQCBO-AQpooHnacNlQtghy05lRR5kqdJsDEcZZuSpp4nuQJT7fkBjmRObw1lOqnpyDBwrEFKQ_3ct12toPLKN6jfTdYU7naOY0xe9N_DuWrVlzWZDjvkuciLZ25P6VI4I4rrRbJuwVAk5RXBPV4RcXuH-8SZPluilQ6tfygLDEVQeF8ltlrRMxEmjoUN9GKkPjfmyZzselmkAAAgAAAAAAAAAfQEAAAAAAAAP8gUYQ29udGVudC1UeXBlIGFwcGxpY2F0aW9uL2pzb24WQXBwbGljYXRpb24YQ3liZXJDb25uZWN0DFNvdXJjZUgxNTUzMWZhMi0xMjA1LTRmNjEtYjZlNC1jOWY2OGVjZjgxZjcUQ29udGVudC1JZIABZjA5NTM2MDQ1YzhkNDZhMDEyMWM3NjgwNTBjNGE2MWQ1NDhjYmRhNjJmNGQ5MmE4M2ZkYzA4MTdiNTFhN2RhOBxDb250ZW50LURpZ2VzdIABZjA5NTM2MDQ1YzhkNDZhMDEyMWM3NjgwNTBjNGE2MWQ1NDhjYmRhNjJmNGQ5MmE4M2ZkYzA4MTdiNTFhN2RhOBxDb250ZW50LUF1dGhvchh1YjV6ZTd4ZGp1NWwOQ2hhaW5JZAQ1NhxDb250ZW50LVRhcmdldIABMzlmMDIxODgxZTczODZmOGQ3M2Q2ZWYyNTUzM2U2MDkxZjJhMDI1NmU0MjJiNGIzYzRlM2QzMzVjY2FlMTQ3ZQB7ImNvbnRlbnQiOiJ7XCJvcFwiOlwiY29tbWVudFwiLFwiYWRkcmVzc1wiOlwiMHg2NjhiYjhiYWFkMThhZDA5ODEwYzRmMjlhZjBmNjVjZDQyZmZlMGU0XCIsXCJ0c1wiOjE2OTE0NjA2MjQ2ODQsXCJjaGFpbklkXCI6NTYsXCJoYW5kbGVcIjpcInViNXplN3hkanU1bFwiLFwidGFyZ2V0XCI6XCIzOWYwMjE4ODFlNzM4NmY4ZDczZDZlZjI1NTMzZTYwOTFmMmEwMjU2ZTQyMmI0YjNjNGUzZDMzNWNjYWUxNDdlXCIsXCJ0aXRsZVwiOlwiRmxhcHB5TW9vbmJpcmRcIixcImJvZHlcIjpcIlNvIGZ1biB0byBwbGF5IGluIG15IHNwYXJlIHRpbWUuXCJ9IiwiZGlnZXN0IjoiZjA5NTM2MDQ1YzhkNDZhMDEyMWM3NjgwNTBjNGE2MWQ1NDhjYmRhNjJmNGQ5MmE4M2ZkYzA4MTdiNTFhN2RhOCIsInNpZ25hdHVyZSI6IjB4OTIwZDgzNzJjZDk1YWE2OGQyY2Y3N2VkNTFkYjUzNzZhMjc5NzI4NmYyYzczYzUzOTA3OTI4ZGMzNWU0ODg0MDNiNjQ5ZWU5YTQxZGQyMWE0ZjZmMWQ3NmNhY2RlZWIzMzMzYmIwYTQ2ZDdlOGRhZmQ3NWRlOTIxN2ZlOTRhYzIiLCJzaWduaW5nS2V5Ijp7InB1YmxpY0tleSI6Ik1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRWJWVnF2T0FLcUdYelBYbVNza1lPam9vbzlxdzBYdjRvMnVzNWV4U1VsQlpLLzFVY3NpdDZuYVNNaVBBNFRlZkRMUjZlbzFEQllDOW5HQUIwM2ZZSjlRPT0iLCJmb3JtYXQiOiJTdWJqZWN0UHVibGljS2V5SW5mbyIsImFsZ29yaXRobSI6IkVTMjU2In0sInNpZ25pbmdLZXlBdXRoIjp7ImFkZHJlc3MiOiIweDY2OGJiOGJhYWQxOGFkMDk4MTBjNGYyOWFmMGY2NWNkNDJmZmUwZTQiLCJzaWduaW5nS2V5U2lnbmF0dXJlIjoiMHgwMGQ2NGM5YTBiNDI1ZDcyM2JmYmQ4NTZjZWVhYjQwZmE2YTdjZjY4ZWE0YmNkZDAzOGQ1NzRlNDM2NjMzNmQwMDA5MTRjNDRjODM2MWZjZDJjYmMyZDRmYTFlOThhZTA1ZjdkYWU3MTVjODliN2YzYzc3NTBhNmViOTVjOWY2MDFiIiwic2lnbmluZ0tleU1lc3NhZ2UiOiJJIGF1dGhvcml6ZSBDeWJlckNvbm5lY3QgZnJvbSB0aGlzIGRldmljZSB1c2luZyBzaWduaW5nIGtleTpcbk1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRWJWVnF2T0FLcUdYelBYbVNza1lPam9vbzlxdzBYdjRvMnVzNWV4U1VsQlpLLzFVY3NpdDZuYVNNaVBBNFRlZkRMUjZlbzFEQllDOW5HQUIwM2ZZSjlRPT0ifX0BABMkeQvdumydQyKZV-F0qd9bw4bZABzqYAfEhORY-LqUefbREjlD6Qk5c0mBy_IKbhfvToRrTCE-HP_Qp9a_WTTwItoW7iRvQk0yGSiLr7AN2PkdWlXkxkBNo2E9e0mcUri2RYFKGSfwt3t-wvJFNxFvMyZ_vIkouIGprYsr_ue0RWYM2iLGdoHaqSpwG93DBGnm4Jttx2MTF8g5HOA47uNimOMEJpEBAs9CWfE-DLPQsEVxJbefEqms3RPt1dpdxip7qohi4cBVeY1Vjg9wBiIzRi36bQOJRnMw_C2zupu0HnVXsRLUH8jhk_qyT7nlLdWtr_X9ZZWxIeZuXeDyMQnMn02LDqyW3k0Ohaybsp_nPN2I8dMX0P-Q0tr5eaF8bEF2Q_gqsMepAniC9MUktIN4auus30sgKlu5l3OcgTb-HfG1Zpeqv1VVzum9nytxiwjqFPtK82Kd_gjbsYP5_pc9KU7upbVtQbXhvDiKHciiicsIT-2zd3YgZKemorlzlh7MzAmgABBoKC9kfgigVhrY7cgLib2uWScfiIRuA8BPVymeCZju8BYeHvWpG1bXIzkQDd4FBwze2RgcqmIpGXG5M0yaOjo7WuvnwHVRlmbVuj1MRr1z8NogpmgbS-hgpusHY2U1nYIsOMQGXzO5RfmZiQgC54OfFtF-GnDpx82XnPgX7WyVoTnTxFtyMHzK_iyQ9jKTuTNvPZDvpKXyraIujN7xcC4NvJ3aJ8zssULFQNgqiC5cQ2opbFOhg0A7GLIBkXNwSVwD5BBfHHCsiV-mwjjqdujllzy-pR5BCvvV2FZ4PlVAgsxX8hCEQUNVpO5_gISSE_SeLuRWXlhdSRRI4dGFNWm7E75ZJzeOn_C5hZCuQjIdgS_a-O__5v2MqBQlKDUdtw54pXniUkZA4UhPXNgcGwVvdBDsybCJeM__akVDhDWrY6nqGOozHfrIUS1VR_Cdo4LP57DlSkPOwfb81MDBkYjzPu1HYNTLEUCcWiNtw0-YV7j4eDx_a5p6esNiIZInXK3DJGw2a4Na7e9FyRLWzSNPtd54Ys0qjcGYTVwJJvl4e6oE7bMPXKSptAieiO3jhCnDFROl4Wm3NX2a1IE4DZYfk1hRjhi47p9TgbZmBkw8_1y5runeAb4ZmOyO1jiOxQ6mQCBO-AQpooHnacNlQtghy05lRR5kqdJsDEcZZuSpp4nuQJT7fkBjmRObw1lOqnpyDBwrEFKQ_3ct12toPLKN6jfTdYU7naOY0xe9N_DuWrVlzWZDjvkuciLZ25P6VI4I4rrRbJuwVAk5RXBPV4RcXuH-8SZPluilQ6tfygLDEVQeF8ltlrRMxEmjoUN9GKkPjfmyZzselmkAAAcAAAAAAAAADAEAAAAAAAANkAQYQ29udGVudC1UeXBlIGFwcGxpY2F0aW9uL2pzb24WQXBwbGljYXRpb24YQ3liZXJDb25uZWN0HENvbnRlbnQtQXV0aG9yGDF3ZWI4OXJrMTUwMQ5DaGFpbklkBDU2DFNvdXJjZQhhdGVtFENvbnRlbnQtSWSAAWE4NWQwMTM4ZDU0Yjc0MDdmOTM0ZmExOTlhYzA5YzQwN2E3ZTI3NTc1YzNmOWVjODUxMjczNDVkZTFlMTNmMDAcQ29udGVudC1EaWdlc3SAAWE4NWQwMTM4ZDU0Yjc0MDdmOTM0ZmExOTlhYzA5YzQwN2E3ZTI3NTc1YzNmOWVjODUxMjczNDVkZTFlMTNmMDAAeyJjb250ZW50Ijoie1wib3BcIjpcInBvc3RcIixcImFkZHJlc3NcIjpcIjB4MTM4YzY3NDk2YzRhMTVkNDk3MDEwM2U4NmNlN2I0ZThhOGFmNmI4ZVwiLFwidHNcIjoxNjkxNDYwNjIzOTUyLFwiY2hhaW5JZFwiOjU2LFwiaGFuZGxlXCI6XCIxd2ViODlyazE1MDFcIixcInRpdGxlXCI6XCIxMTExMlwiLFwiYm9keVwiOlwiMjIyMjIyMjIyMjIyMjIyMjIyXCJ9IiwiZGlnZXN0IjoiYTg1ZDAxMzhkNTRiNzQwN2Y5MzRmYTE5OWFjMDljNDA3YTdlMjc1NzVjM2Y5ZWM4NTEyNzM0NWRlMWUxM2YwMCIsInNpZ25hdHVyZSI6IjB4OWFlOTk3NjRiYTlmNjRkYjE2YmExNGNhMDI3ZmVjMzRjNzJlOWIyOWYyYmM2ZDNmODBhMjVmYTBmNTEwZjM5OGQzMmM1ZDE4NDU0MzAzZjc4MzVmMzMxYTBjZGQ2YjVlYmRjNGZhNGYyYzBkNzRkYzBjNzkzZDBjZTI2OTcxODgiLCJzaWduaW5nS2V5Ijp7InB1YmxpY0tleSI6Ik1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRXhMREk3VG42ckl2M1lGK01NMFdSNVdKOHZZbThsNXkrSGZicHFuOHF5cXdHMTducDl2dEVuMFNzNDUxZFZHeFRXU3VOSE9rdEhLU3I4cnRidWhPVmVRPT0iLCJmb3JtYXQiOiJTdWJqZWN0UHVibGljS2V5SW5mbyIsImFsZ29yaXRobSI6IkVTMjU2In0sInNpZ25pbmdLZXlBdXRoIjp7ImFkZHJlc3MiOiIweDEzOGM2NzQ5NmM0YTE1ZDQ5NzAxMDNlODZjZTdiNGU4YThhZjZiOGUiLCJzaWduaW5nS2V5U2lnbmF0dXJlIjoiMHhiMGIxNjc4NzY4ZTEwNjBmZmY0ZTExNWRlNTY5NzkyNjQ1NmEyZTkzNWZiYjA1N2ZiMTdhMmU5YjY3ZWMyN2Q0MzA1N2Q1OWRlY2FhYTZhZjdkNGM1MWY0NWRlMWU3ZDllMGYxOTQzMmUxYjI2MjAyNjBhNzAxZGJiYmYwZjEzZDFiIiwic2lnbmluZ0tleU1lc3NhZ2UiOiJJIGF1dGhvcml6ZSBBdGVtUmV2aWV3IGZyb20gdGhpcyBkZXZpY2UgdXNpbmcgc2lnbmluZyBrZXk6XG5NRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUV4TERJN1RuNnJJdjNZRitNTTBXUjVXSjh2WW04bDV5K0hmYnBxbjhxeXF3RzE3bnA5dnRFbjBTczQ1MWRWR3hUV1N1TkhPa3RIS1NyOHJ0YnVoT1ZlUT09In19AQCX4Oc9jt3xVNvGe7dPhAunWiIf6LyME6ogapDlhPU1X5Us6dvjfyKbsYsUnYHeILugGRksRCwfSdwgu1dPv_Jn_BDAwxJMJi1lw5OO3UmkG-jB96Qo28jft2w0Z1ljHr_qZrVYTQCSc8cKhYddDgkw0YflDckpuMEGQMEQTKRaqrQ-TaOHlLMHq6LHZQ6VpIaGv9uBfHe-A1eZJEhBbQAuNIGnTeHSPGh4dAkvL_kBLz9QvvJkWnWbVPG9JamjDCG6qqkTNKpbaryPdhjCO1u_kJ0Pt8ZsHRW3o9_43_ZNpm6zeKDtoSuPA1bv58SK_tELLljs3evw3UkSIJyEKDmTe0pzpWoqha7__HIMqswK1N77-eNScEVE1CAq_mYveEaslIJ1KCt5-8Zpsp7rMtZCFp9qwsbum0XZOQ61sjllWIWpXN2fW5z5WJ7JTPR9KUm9wKcp-n-rsPgzNmPTwKlGu0Ui38AXrfaG_3_-_KMAPtt8wQpvWghqYMECQefURz7Zapps915_Nsq7-mn57GzTEvjxo6-bBRyNGA93C-l8sum0RlyGP0Mhn8ILSp7UYvfngQCfaHtputoITKiNnT0Zz6h9pDxzy-xkmLjNVmzRBa984PssyPsjYcMaY5Mw4Z6yR_XCr-DZ6aEq-_e2JyChg9aUTmM3xwrIrHbcomoijJz4F-1slaE508RbcjB8yv4skPYyk7kzbz2Q76Sl8q2iLoze8XAuDbyd2ifM7LFCxUDYKoguXENqKWxToYNAOxiyAZFzcElcA-QQXxxwrIlfpsI46nbo5Zc8vqUeQQr71dhWeD5VQILMV_IQhEFDVaTuf4CEkhP0ni7kVl5YXUkUSOHRhTVpuxO-WSc3jp_wuYWQrkIyHYEv2vjv_-b9jKgUJSg1HbcOeKV54lJGQOFIT1zYHBsFb3QQ7MmwiXjP_2pFQ4Q1q2Op6hjqMx36yFEtVUfwnaOCz-ew5UpDzsH2_NTAwZGI8z7tR2DUyxFAnFojbcNPmFe4-Hg8f2uaenrDYiGSJ1ytwyRsNmuDWu3vRckS1s0jT7XeeGLNKo3BmE1cCSb5eHuqBO2zD1ykqbQInojt44QpwxUTpeFptzV9mtSBOA2WH5NYUY4YuO6fU4G2ZgZMPP9cua7p3gG-GZjsjtY4jsUOpkAgTvgEKaKB52nDZULYIctOZUUeZKnSbAxHGWbkqaeJ7kCU-35AY5kTm8NZTqp6cgwcKxBSkP93LddraDyyjeo303WFO52jmNMXvTfw7lq1Zc1mQ475LnIi2duT-lSOCOK60WybsFQJOUVwT1eEXF7h_vEmT5bopUOrX8oCwxFUHhfJbZa0TMRJo6FDfRipD435smc7HpZpAAAHAAAAAAAAAAwBAAAAAAAADZAEGENvbnRlbnQtVHlwZSBhcHBsaWNhdGlvbi9qc29uFkFwcGxpY2F0aW9uGEN5YmVyQ29ubmVjdA5DaGFpbklkBDU2DFNvdXJjZQhhdGVtFENvbnRlbnQtSWSAAWU1NjEzMDViMDY4YzJmNjZhY2U4MWE0ZDEyM2M4YTQxYWY3M2NjYjcxNmQ1M2FjNTI5ZjI3YTM3ZGQ3ODY4MTYcQ29udGVudC1EaWdlc3SAAWU1NjEzMDViMDY4YzJmNjZhY2U4MWE0ZDEyM2M4YTQxYWY3M2NjYjcxNmQ1M2FjNTI5ZjI3YTM3ZGQ3ODY4MTYcQ29udGVudC1BdXRob3IYcTJrdGZjZGJrdHNvAHsiY29udGVudCI6IntcIm9wXCI6XCJwb3N0XCIsXCJhZGRyZXNzXCI6XCIweDFkNDIyNjJmODQ3YWQyZWU0Y2M3NjIyZjQxZDBhMTlhMzZhMDZhMmNcIixcInRzXCI6MTY5MTQ2MDYyNDE2NCxcImNoYWluSWRcIjo1NixcImhhbmRsZVwiOlwicTJrdGZjZGJrdHNvXCIsXCJ0aXRsZVwiOlwiMTExMTJcIixcImJvZHlcIjpcIjIyMjIyMjIyMjIyMjIyMjIyMlwifSIsImRpZ2VzdCI6ImU1NjEzMDViMDY4YzJmNjZhY2U4MWE0ZDEyM2M4YTQxYWY3M2NjYjcxNmQ1M2FjNTI5ZjI3YTM3ZGQ3ODY4MTYiLCJzaWduYXR1cmUiOiIweDdlMjZhNzlkNzMyYjdkMzQ3M2NlZDlkYTlhZDNlYzZkZTIxNGFiZTU3YTFlYWJmZDA4MjM4Zjg0NWI1NDgzMTA3NmU4ZWVmODJiMWE0OTZmZmJmMWI4ZTA3MDhiZmYzMzNjZTQ5NjI1MmU0ZjI3NjBiNGU3ZTJhNWVhMjIyMWM5Iiwic2lnbmluZ0tleSI6eyJwdWJsaWNLZXkiOiJNRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUVaSlk2UHJGN1BzRTZxYUcyL3N2Q2hTVGZnZkkreVZ4ZTlSaVhMUW5EOUREUklUOFJHQkhqL1c0SUxDNVM2dXNJZ1dhUUllSGtKK3poWEllVmJiU08xQT09IiwiZm9ybWF0IjoiU3ViamVjdFB1YmxpY0tleUluZm8iLCJhbGdvcml0aG0iOiJFUzI1NiJ9LCJzaWduaW5nS2V5QXV0aCI6eyJhZGRyZXNzIjoiMHgxZDQyMjYyZjg0N2FkMmVlNGNjNzYyMmY0MWQwYTE5YTM2YTA2YTJjIiwic2lnbmluZ0tleVNpZ25hdHVyZSI6IjB4OGZmMGFlYWM5MTE2Y2JlMTRlNTlmNzkyMmFjMGM2NzMyYTNhMjZjOTUxNzcwMjhjOTRlZDg0ZTk2ZmQ2YWQ5NzY1NGJmY2JhNTQ3MDA1YWQxODA0ZDM5MDFhMDBmMjZhZjNkOTgwNmQ3YWVjM2RmZjAwMzgyNjEwYjU5NTMxMzYxYiIsInNpZ25pbmdLZXlNZXNzYWdlIjoiSSBhdXRob3JpemUgQXRlbVJldmlldyBmcm9tIHRoaXMgZGV2aWNlIHVzaW5nIHNpZ25pbmcga2V5OlxuTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFWkpZNlByRjdQc0U2cWFHMi9zdkNoU1RmZ2ZJK3lWeGU5UmlYTFFuRDlERFJJVDhSR0JIai9XNElMQzVTNnVzSWdXYVFJZUhrSit6aFhJZVZiYlNPMUE9PSJ9fQEADtIAjH3_Ut5OtJGcmjrv4d42U7Nz4ruA-4184ESk6Zm1FQk85P5aHevcq4AiZlHP6HGdW7CtIJgOQIQXPFLdGZO8y8mdgO-tQUbiXjMFYkwX4IDtX1hK239Z8WdT3_s4USHYXLx3kTOiqXJPu8r48V6GWxEJn-jYgYjeViGrxZggQEq-WLrXEfVnj46ndeh4TlpIiWoi0gNixmuIYhCkrGvtNxpUD__FOu7HBRiZ-0MB_AVKA3PKBpnkWgu1ni38S4Cx6Y0CkxANGYmWQPrK-gZHfzeatO3_8OtJ6i6bvnwUB0htBl4rUm7Z7QCOstp_UAfR03ACGKfmvrqJ59sPCcFCBj36VH4M7qLd1xzEdExClYa9WrukewlBxSu7Bm33aF6poIw3XLr9GkxKvBbQM7GvJizPAjlWsLm_SB8_IZFYCE9fSh6UifE9faBeVU5J5kZbakhwmaxeemjfUaoIp_c6ZuP39Wrm3eC82CdCMpuoB3rhaydaBPDaIP4tKt5sjdH_TY3rBF2W39ipytP-pygctVXXCmhgRsqQmJRgh-3T01WxELPGyJOBC-U-MhhqqMZF1ehHvnWjFmOoxyBUzC1qdXq6DlB0EbeyUtWskYmixnYF6ZduHaYhZiiqlCZPKxLk28RqMSkAKFTA9yofZ0dPp9MDNW5Mq3vgcrmD_JKc-BftbJWhOdPEW3IwfMr-LJD2MpO5M289kO-kpfKtoi6M3vFwLg28ndonzOyxQsVA2CqILlxDailsU6GDQDsYsgGRc3BJXAPkEF8ccKyJX6bCOOp26OWXPL6lHkEK-9XYVng-VUCCzFfyEIRBQ1Wk7n-AhJIT9J4u5FZeWF1JFEjh0YU1absTvlknN46f8LmFkK5CMh2BL9r47__m_YyoFCUoNR23DnileeJSRkDhSE9c2BwbBW90EOzJsIl4z_9qRUOENatjqeoY6jMd-shRLVVH8J2jgs_nsOVKQ87B9vzUwMGRiPM-7Udg1MsRQJxaI23DT5hXuPh4PH9rmnp6w2IhkidcrcMkbDZrg1rt70XJEtbNI0-13nhizSqNwZhNXAkm-Xh7qgTtsw9cpKm0CJ6I7eOEKcMVE6Xhabc1fZrUgTgNlh-TWFGOGLjun1OBtmYGTDz_XLmu6d4BvhmY7I7WOI7FDqZAIE74BCmigedpw2VC2CHLTmVFHmSp0mwMRxlm5Kmnie5AlPt-QGOZE5vDWU6qenIMHCsQUpD_dy3Xa2g8so3qN9N1hTudo5jTF7038O5atWXNZkOO-S5yItnbk_pUjgjiutFsm7BUCTlFcE9XhFxe4f7xJk-W6KVDq1_KAsMRVB4XyW2WtEzESaOhQ30YqQ-N-bJnOx6WaQAABwAAAAAAAAAMAQAAAAAAAA2QBBhDb250ZW50LVR5cGUgYXBwbGljYXRpb24vanNvbhZBcHBsaWNhdGlvbhhDeWJlckNvbm5lY3QUQ29udGVudC1JZIABZjI2NDQxZjc5MDVmYjA3M2ZlMTM2OTE3ZWU2Y2EwYmVkMmU5MTUxNjgzMmFiN2JmNTQ4MDc0Mjk5Y2QxOTcyZBxDb250ZW50LURpZ2VzdIABZjI2NDQxZjc5MDVmYjA3M2ZlMTM2OTE3ZWU2Y2EwYmVkMmU5MTUxNjgzMmFiN2JmNTQ4MDc0Mjk5Y2QxOTcyZBxDb250ZW50LUF1dGhvchg5N3NsNjd4a2R6Y3MOQ2hhaW5JZAQ1NgxTb3VyY2UIYXRlbQB7ImNvbnRlbnQiOiJ7XCJvcFwiOlwicG9zdFwiLFwiYWRkcmVzc1wiOlwiMHhjNzBlNTU2NzUwMWE2ZDMzYmU1ZmNhMWNiMGUwMDFhMmMyMjdjMzg3XCIsXCJ0c1wiOjE2OTE0NjA2MjQwMjgsXCJjaGFpbklkXCI6NTYsXCJoYW5kbGVcIjpcIjk3c2w2N3hrZHpjc1wiLFwidGl0bGVcIjpcIjExMTEyXCIsXCJib2R5XCI6XCIyMjIyMjIyMjIyMjIyMjIyMjJcIn0iLCJkaWdlc3QiOiJmMjY0NDFmNzkwNWZiMDczZmUxMzY5MTdlZTZjYTBiZWQyZTkxNTE2ODMyYWI3YmY1NDgwNzQyOTljZDE5NzJkIiwic2lnbmF0dXJlIjoiMHg4MzMxYzBlODAzOTUwN2VkNjAwMzY4M2Q1ODVmZTZlOGU5MjU2NTFhMWY5MzJhZmMyZWEzZTE2ODQwMmQ4ZWIzOGE5YWQxZmIwNmNlMjMzZTljMjVkYWE1MzVhZDc4YTcwZDk2NjE4YzE0NGM5M2FhMjUyM2Y3ZWYxODgzNGEwYyIsInNpZ25pbmdLZXkiOnsicHVibGljS2V5IjoiTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFTlRpaEpWRStxeHFqZXJycVAxMFlNTG1FUFduNUZ5cUF3bzhpajZmWFQwZVE1Ky8vd29tbk05VWFpWGdHWFNzMmFVT081eUwxa0dtdUxaQ0dBQXVNWnc9PSIsImZvcm1hdCI6IlN1YmplY3RQdWJsaWNLZXlJbmZvIiwiYWxnb3JpdGhtIjoiRVMyNTYifSwic2lnbmluZ0tleUF1dGgiOnsiYWRkcmVzcyI6IjB4YzcwZTU1Njc1MDFhNmQzM2JlNWZjYTFjYjBlMDAxYTJjMjI3YzM4NyIsInNpZ25pbmdLZXlTaWduYXR1cmUiOiIweDBjZDE2NjZiMWFjY2RiMzc0Mjk5MzQ4NmViNGMyZDc4MGMyMjdjNzViYTA5YzE3NTZhMWQyZDk2OGNjMWE1ZGIyYjA3ODk0NjQyZjhiNDdjOGRkMWYwMjU5YTRhYjRlZmJiNzU4MmMyOTNkNDliY2QyOTAwMDgxNTlhNGY3ZDRlMWIiLCJzaWduaW5nS2V5TWVzc2FnZSI6IkkgYXV0aG9yaXplIEF0ZW1SZXZpZXcgZnJvbSB0aGlzIGRldmljZSB1c2luZyBzaWduaW5nIGtleTpcbk1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRU5UaWhKVkUrcXhxamVycnFQMTBZTUxtRVBXbjVGeXFBd284aWo2ZlhUMGVRNSsvL3dvbW5NOVVhaVhnR1hTczJhVU9PNXlMMWtHbXVMWkNHQUF1TVp3PT0ifX0BAHJEnd9y_pDL64eMfDztNRaN64cm-8kMDLSl08Eyt_UjpmDoG0mG-47fX3HHnwJr4Ey2JDw8d9xZ37Dtn88D4B1xtY01Ei1UJRVRanarF0hvGvugGSUkw_pDEOOE11PZ7n2_IwMDbFO2A5aHQUMaILhLxPjfdEDk3UWYRBCKqMSBn5eVPspYktc2EfHIQCUjFimp45jDyxiUtRKqV-ockK6f5-HM7kroG4OKdc8ZWguO47zQQTgCtiapkZ0qyVUQ5lwkYOaUFpGGCrTYVZl_1kdR_YdAGvAWhEU5ezQufjMT4-Eq77BySFxoZbjIi5fUZEH49evlFln3pq7BvAvRf3FdzkpYdZQyh7LD2tafSE4bJ8NdRubfehNgsYO5__qg1hOnZK3TSjtzPt8BnNceVyfFkqdLoW71aUfSJq8jzjuC3sWZgcNIG3SWDhgxmPcHxGqPxy88wR65HMB9Jzoa6vdtCqUPQcMu3q-v-C5Cbduran7xhrt2wXGtTVbkR_dPkAg8HyEp3kRpOGHBnbq4t-IP-SH_wjtCgoWoVVBcIlzJa-f0pjNkcj85g5dYqEJKdEjRLjRyUEC67piC6Anq0PtOUGx3tuHq0KsUIH7H5eU8Y_YO1lHd728nxSLvRKaLvBNp93nbPl4N3ucuFVxGwTZLnQFvYikC5uZN0Rgi38FTnPgX7WyVoTnTxFtyMHzK_iyQ9jKTuTNvPZDvpKXyraIujN7xcC4NvJ3aJ8zssULFQNgqiC5cQ2opbFOhg0A7GLIBkXNwSVwD5BBfHHCsiV-mwjjqdujllzy-pR5BCvvV2FZ4PlVAgsxX8hCEQUNVpO5_gISSE_SeLuRWXlhdSRRI4dGFNWm7E75ZJzeOn_C5hZCuQjIdgS_a-O__5v2MqBQlKDUdtw54pXniUkZA4UhPXNgcGwVvdBDsybCJeM__akVDhDWrY6nqGOozHfrIUS1VR_Cdo4LP57DlSkPOwfb81MDBkYjzPu1HYNTLEUCcWiNtw0-YV7j4eDx_a5p6esNiIZInXK3DJGw2a4Na7e9FyRLWzSNPtd54Ys0qjcGYTVwJJvl4e6oE7bMPXKSptAieiO3jhCnDFROl4Wm3NX2a1IE4DZYfk1hRjhi47p9TgbZmBkw8_1y5runeAb4ZmOyO1jiOxQ6mQCBO-AQpooHnacNlQtghy05lRR5kqdJsDEcZZuSpp4nuQJT7fkBjmRObw1lOqnpyDBwrEFKQ_3ct12toPLKN6jfTdYU7naOY0xe9N_DuWrVlzWZDjvkuciLZ25P6VI4I4rrRbJuwVAk5RXBPV4RcXuH-8SZPluilQ6tfygLDEVQeF8ltlrRMxEmjoUN9GKkPjfmyZzselmkAAAcAAAAAAAAADAEAAAAAAAANkAQYQ29udGVudC1UeXBlIGFwcGxpY2F0aW9uL2pzb24WQXBwbGljYXRpb24YQ3liZXJDb25uZWN0DkNoYWluSWQENTYMU291cmNlCGF0ZW0UQ29udGVudC1JZIABYjVjNmQ1OGJmMDQyZDdiOTM5NzQ3NDA1OTAyNTViZWMzM2VjOGZlODQyZmI5Yzg4NjFmNDc4YzE1MTUwMmI5MBxDb250ZW50LURpZ2VzdIABYjVjNmQ1OGJmMDQyZDdiOTM5NzQ3NDA1OTAyNTViZWMzM2VjOGZlODQyZmI5Yzg4NjFmNDc4YzE1MTUwMmI5MBxDb250ZW50LUF1dGhvchg5Y2ExeWZteXdvMmMAeyJjb250ZW50Ijoie1wib3BcIjpcInBvc3RcIixcImFkZHJlc3NcIjpcIjB4NzgzYWQwMThmY2M5OTk5MDlmNDU3ZTViNzAwMmFjNDdhOWJlZmNlZVwiLFwidHNcIjoxNjkxNDYwNjI0MDk4LFwiY2hhaW5JZFwiOjU2LFwiaGFuZGxlXCI6XCI5Y2ExeWZteXdvMmNcIixcInRpdGxlXCI6XCIxMTExMlwiLFwiYm9keVwiOlwiMjIyMjIyMjIyMjIyMjIyMjIyXCJ9IiwiZGlnZXN0IjoiYjVjNmQ1OGJmMDQyZDdiOTM5NzQ3NDA1OTAyNTViZWMzM2VjOGZlODQyZmI5Yzg4NjFmNDc4YzE1MTUwMmI5MCIsInNpZ25hdHVyZSI6IjB4ZDdlYjY3YmQxNGJlNTBkMTEzNzVkYzEwZWU5ZmI3NmRiZDhiMzJhNjAzYTgwYmI2MjU5ZWFjMjlhZDY0NzA5Yzc5MmI0YTlkODAzMjAzNjViMmE4MTAwY2YzYTk3NGViNTEzMzNlNmJiZjAwNjgzOWQwNzk3NTI2YWY1NmY4M2IiLCJzaWduaW5nS2V5Ijp7InB1YmxpY0tleSI6Ik1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRUgxNlR0emM0Znd1dTIvWTFBZUs2cHNvTlpTek9lTEV1TFNOMy9IUW5rMUswL0JsOThicnJnZFdIckVBY1ZqMHg2TmRpMTFlSVdEMDl1b0l3WEpobktBPT0iLCJmb3JtYXQiOiJTdWJqZWN0UHVibGljS2V5SW5mbyIsImFsZ29yaXRobSI6IkVTMjU2In0sInNpZ25pbmdLZXlBdXRoIjp7ImFkZHJlc3MiOiIweDc4M2FkMDE4ZmNjOTk5OTA5ZjQ1N2U1YjcwMDJhYzQ3YTliZWZjZWUiLCJzaWduaW5nS2V5U2lnbmF0dXJlIjoiMHgzNWUyNzMwOGI3MjcwYWZmNTg3OThhZmI2NTQ3MTNjMmE4ZWQ1YTlkYjAwNGI4ZTkwZGQ0NWQwNGE0Zjk1OTJkNzZkMDg1OWY5OGMwNGNlNGRhZTUxNTMzNjI0Nzk0NTYzMmE1NTc0MDgzNWNiNWUzZGQ2MTQ1NjczMmFiNjdjMzFjIiwic2lnbmluZ0tleU1lc3NhZ2UiOiJJIGF1dGhvcml6ZSBBdGVtUmV2aWV3IGZyb20gdGhpcyBkZXZpY2UgdXNpbmcgc2lnbmluZyBrZXk6XG5NRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUVIMTZUdHpjNGZ3dXUyL1kxQWVLNnBzb05aU3pPZUxFdUxTTjMvSFFuazFLMC9CbDk4YnJyZ2RXSHJFQWNWajB4Nk5kaTExZUlXRDA5dW9Jd1hKaG5LQT09In19AQBxhpl8y0ozf5WWfEVZ84ZG04LDhATmwWm-yoZ_B_tNYr2801oGNkRFt9NdgvoKRISgguKgDT7CVS3Gz5h-ko0rGEH5drgJKfHdBda4iVv0ygGut5EQxmMkYTqmJCnhxytF1mub9B_R3KqtVPhP24lwndDBZ6U1IVWbH_19lCTmd2lERWLzxlONBh39y84klGd1fWCYsNKOvjIvB9X7opR8Wqm8NjrhWACTCBY6BSC1bZYRBAKMVG1vZgHXB4OjlbdVGKkkLrrbwLVKr8TRLeKyy2eMhbYH7N-aN_Qz0ghPlGHwfk5c9KP-_Zi8xSTLrVaPm9iHysRyxRyWaKzGtbyEmR6R6M3pF5GdIdCzU7RrCfwXDrdCEkcG1FZ6r3ZlCIp2Vamv-6xQI283BbS_lQk_X4dLx7H9tWJRGASSN5en52HryAxux_PKpAQcy4nYR2RuNVW31ls8tGayrxiyoSNHOmCX9fbt1I09BltymCGYNJ11x7ewpJdWMaf6iWa45ogR1rQQkIBHhKGvmEfkF_0ZHJe9WgH6TCWzpM5li313QzZNoa-K12YyRu1rtUM1UVV3OgHYqyt9GK3HkBzelTP_xcWf_9nTjtkzzq4LeZG8iZ7XlmIsIPLbN4JYEPr4h3W2pzRCOLWdejC7kwQWTFs0UVpIwaeQIrbPYhnRiGcvRJz4F-1slaE508RbcjB8yv4skPYyk7kzbz2Q76Sl8q2iLoze8XAuDbyd2ifM7LFCxUDYKoguXENqKWxToYNAOxiyAZFzcElcA-QQXxxwrIlfpsI46nbo5Zc8vqUeQQr71dhWeD5VQILMV_IQhEFDVaTuf4CEkhP0ni7kVl5YXUkUSOHRhTVpuxO-WSc3jp_wuYWQrkIyHYEv2vjv_-b9jKgUJSg1HbcOeKV54lJGQOFIT1zYHBsFb3QQ7MmwiXjP_2pFQ4Q1q2Op6hjqMx36yFEtVUfwnaOCz-ew5UpDzsH2_NTAwZGI8z7tR2DUyxFAnFojbcNPmFe4-Hg8f2uaenrDYiGSJ1ytwyRsNmuDWu3vRckS1s0jT7XeeGLNKo3BmE1cCSb5eHuqBO2zD1ykqbQInojt44QpwxUTpeFptzV9mtSBOA2WH5NYUY4YuO6fU4G2ZgZMPP9cua7p3gG-GZjsjtY4jsUOpkAgTvgEKaKB52nDZULYIctOZUUeZKnSbAxHGWbkqaeJ7kCU-35AY5kTm8NZTqp6cgwcKxBSkP93LddraDyyjeo303WFO52jmNMXvTfw7lq1Zc1mQ475LnIi2duT-lSOCOK60WybsFQJOUVwT1eEXF7h_vEmT5bopUOrX8oCwxFUHhfJbZa0TMRJo6FDfRipD435smc7HpZpAAAIAAAAAAAAAH0BAAAAAAAAD_IFGENvbnRlbnQtVHlwZSBhcHBsaWNhdGlvbi9qc29uFkFwcGxpY2F0aW9uGEN5YmVyQ29ubmVjdAxTb3VyY2VIMTU1MzFmYTItMTIwNS00ZjYxLWI2ZTQtYzlmNjhlY2Y4MWY3FENvbnRlbnQtSWSAAWFjMGRiMmMyZGJiMWRiYTg4NGNkMTE5YmU3OWViYjRiMjJiZjg3MjZiN2JiNGRiNWE5M2U5NzE4MzUzYjA1MTUcQ29udGVudC1EaWdlc3SAAWFjMGRiMmMyZGJiMWRiYTg4NGNkMTE5YmU3OWViYjRiMjJiZjg3MjZiN2JiNGRiNWE5M2U5NzE4MzUzYjA1MTUcQ29udGVudC1BdXRob3IYZzdzZDA3cmk4ZXc5DkNoYWluSWQENTYcQ29udGVudC1UYXJnZXSAATM5ZjAyMTg4MWU3Mzg2ZjhkNzNkNmVmMjU1MzNlNjA5MWYyYTAyNTZlNDIyYjRiM2M0ZTNkMzM1Y2NhZTE0N2UAeyJjb250ZW50Ijoie1wib3BcIjpcImNvbW1lbnRcIixcImFkZHJlc3NcIjpcIjB4Y2VhNDk4MTA5OGVmMDc5MWMxYmFiMmUyYWM4MTQxNGYzYmRjMTdmN1wiLFwidHNcIjoxNjkxNDYwNjI0MTc3LFwiY2hhaW5JZFwiOjU2LFwiaGFuZGxlXCI6XCJnN3NkMDdyaThldzlcIixcInRhcmdldFwiOlwiMzlmMDIxODgxZTczODZmOGQ3M2Q2ZWYyNTUzM2U2MDkxZjJhMDI1NmU0MjJiNGIzYzRlM2QzMzVjY2FlMTQ3ZVwiLFwidGl0bGVcIjpcIkZsYXBweU1vb25iaXJkXCIsXCJib2R5XCI6XCJTbyBmdW4gdG8gcGxheSBpbiBteSBzcGFyZSB0aW1lLlwifSIsImRpZ2VzdCI6ImFjMGRiMmMyZGJiMWRiYTg4NGNkMTE5YmU3OWViYjRiMjJiZjg3MjZiN2JiNGRiNWE5M2U5NzE4MzUzYjA1MTUiLCJzaWduYXR1cmUiOiIweDY2MTRmOGFhNDE2NzgyZGMyYzY0NWE2MjBhYjk4NGMzNjAxNTc1MThlMjg3ZTUwMzYxOWQ3NjI5ZDI5OTBhNGM1NDVjNjNmNTFhMWY0ZWIyN2I3NzM1OTYwMGZkY2Y5Nzk5YzYxOGQ5MGM2ZTQwYmMxYjg1ZjZlNzE5ZDAyMDZjIiwic2lnbmluZ0tleSI6eyJwdWJsaWNLZXkiOiJNRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUVWWE93Z2RhVFEveXZGTXQ5emI3em5LeTBlbURhZis3aXdMR0V1ZEc4SHZLWCtlaUE1Yk9XMmc2c3BqaVdUaDJIUnFPZ0Z4QkNOMGtidnltd2c3NDl2UT09IiwiZm9ybWF0IjoiU3ViamVjdFB1YmxpY0tleUluZm8iLCJhbGdvcml0aG0iOiJFUzI1NiJ9LCJzaWduaW5nS2V5QXV0aCI6eyJhZGRyZXNzIjoiMHhjZWE0OTgxMDk4ZWYwNzkxYzFiYWIyZTJhYzgxNDE0ZjNiZGMxN2Y3Iiwic2lnbmluZ0tleVNpZ25hdHVyZSI6IjB4ZWJkYjdjMmM1MmU2NDhjMmViOWJmNjcyZDVjNWY1NDRiMzAyYWFkMzNjZWNjNzg5NTA0YTA0NzdhMzgwM2ZjZDY0NGRiNTE5YzhhY2RiZjdmN2UyYzU3YTM2MTAxNTczNjFjMzQ3OTFlODUyODhhYWM5ZmVmNzMyMWM5ZWFiY2IxYiIsInNpZ25pbmdLZXlNZXNzYWdlIjoiSSBhdXRob3JpemUgQ3liZXJDb25uZWN0IGZyb20gdGhpcyBkZXZpY2UgdXNpbmcgc2lnbmluZyBrZXk6XG5NRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUVWWE93Z2RhVFEveXZGTXQ5emI3em5LeTBlbURhZis3aXdMR0V1ZEc4SHZLWCtlaUE1Yk9XMmc2c3BqaVdUaDJIUnFPZ0Z4QkNOMGtidnltd2c3NDl2UT09In19AQBt-Ss9rOo3E7ACINl8XRf-Qyhdtb4cvvYWXPWNSg06NRAhAsLOuHBTw3cVSEAWAWywNsIQ_IsauJG1pv81nv_Uq7enrCGnUy3yCr9oFonD0dWxDU2mNaBEzJkDM73YhoRWRsTDNixdeRqBOEoQZIM02PoNnJJ2_2YRZgHXmNX6YG_WI_4gwEjyfyEIbKh8M8dOlw7XPTTE_8ONiQ_YixwsJIjAFwHWUEefQgzVEohlSzKUl7OIsHSnxxCe6xS24UqSD6Zne8SSGl9DU4oj9b9jc0_V8umJfCngMzYxab4lYKcGLuJTHZK0dS-TsiR0eaeMXecVrU8sK9SlGI8TmGyGq-stT9lWYyI52Ky73N9tQn5XbkH1DYg7g9o1HiPnede-N5Wperxfiz6WD4qerY103KCAZMFJdg6MX3FLTwh07G-4QJqXbsTRrPbOOM0Kz3N0njp-1bYngKuV8sQf5bx8jIN0uErlW_O6_0k4B6vs9lbmpLcWeTI50wQzDQlhQFmwHw_OiPSk_pJ5vJHT75KzQAnV8Nd2EpRvC7FNUBaLx55vgTj5BNfgVwPlMn3QTd11tnz39gXjLOMX3Dr6JZscdv8hvW0GerJK8wWTftxD5qXAFtDqGCPm8mrlSrANqbqjhlqVgJEeLPOrqnVW4zDgJ6aOOGaHsP1A9uloN1TUnZz4F-1slaE508RbcjB8yv4skPYyk7kzbz2Q76Sl8q2iLoze8XAuDbyd2ifM7LFCxUDYKoguXENqKWxToYNAOxiyAZFzcElcA-QQXxxwrIlfpsI46nbo5Zc8vqUeQQr71dhWeD5VQILMV_IQhEFDVaTuf4CEkhP0ni7kVl5YXUkUSOHRhTVpuxO-WSc3jp_wuYWQrkIyHYEv2vjv_-b9jKgUJSg1HbcOeKV54lJGQOFIT1zYHBsFb3QQ7MmwiXjP_2pFQ4Q1q2Op6hjqMx36yFEtVUfwnaOCz-ew5UpDzsH2_NTAwZGI8z7tR2DUyxFAnFojbcNPmFe4-Hg8f2uaenrDYiGSJ1ytwyRsNmuDWu3vRckS1s0jT7XeeGLNKo3BmE1cCSb5eHuqBO2zD1ykqbQInojt44QpwxUTpeFptzV9mtSBOA2WH5NYUY4YuO6fU4G2ZgZMPP9cua7p3gG-GZjsjtY4jsUOpkAgTvgEKaKB52nDZULYIctOZUUeZKnSbAxHGWbkqaeJ7kCU-35AY5kTm8NZTqp6cgwcKxBSkP93LddraDyyjeo303WFO52jmNMXvTfw7lq1Zc1mQ475LnIi2duT-lSOCOK60WybsFQJOUVwT1eEXF7h_vEmT5bopUOrX8oCwxFUHhfJbZa0TMRJo6FDfRipD435smc7HpZpAAAHAAAAAAAAABIBAAAAAAAADZwEGENvbnRlbnQtVHlwZSBhcHBsaWNhdGlvbi9qc29uFkFwcGxpY2F0aW9uGEN5YmVyQ29ubmVjdBRDb250ZW50LUlkgAEzN2ZjODkzNDNkMmFhNzVlYTc4MTlhNGNlM2M5NDU0MDg4ZmQ1NGY5MjRiZDdjMmMzYjNiZDI5OTQ2MDg0ZDg1HENvbnRlbnQtRGlnZXN0gAEzN2ZjODkzNDNkMmFhNzVlYTc4MTlhNGNlM2M5NDU0MDg4ZmQ1NGY5MjRiZDdjMmMzYjNiZDI5OTQ2MDg0ZDg1HENvbnRlbnQtQXV0aG9yJGphaXJvYmVybmFyZGI4YWpnNA5DaGFpbklkBDU2DFNvdXJjZQhhdGVtAHsiY29udGVudCI6IntcIm9wXCI6XCJwb3N0XCIsXCJhZGRyZXNzXCI6XCIweDc4OTRjYTBkYWYzODA1YTFhNTk3NmZjNWU4YWY5NThlZTBlNTIwMzZcIixcInRzXCI6MTY5MTQ2MDYyNDkzMyxcImNoYWluSWRcIjo1NixcImhhbmRsZVwiOlwiamFpcm9iZXJuYXJkYjhhamc0XCIsXCJ0aXRsZVwiOlwiVGhlIElzbGFuZCBvZiB0aGUgQmx1ZSBEb2xwaGluc1wiLFwiYm9keVwiOlwiU3VwZXIgVG9wLW5vdGNoXCJ9IiwiZGlnZXN0IjoiMzdmYzg5MzQzZDJhYTc1ZWE3ODE5YTRjZTNjOTQ1NDA4OGZkNTRmOTI0YmQ3YzJjM2IzYmQyOTk0NjA4NGQ4NSIsInNpZ25hdHVyZSI6IjB4MmZiMjU5OGI4Zjc0MmU0YmYxZjZhZDNiMmY5NWQyZjQ0NTViYWNlZmZjNzdiYjUyNDU3ODNjNmQ4NzZhYTY1NmVmZmNmYzgyN2E2NTVlMDVmMmUwNjZhZjRkZmZiNmM4NWM5YjBlMzMyNjU1OWExNzExODkzZWI5N2ZhN2I1YzYiLCJzaWduaW5nS2V5Ijp7InB1YmxpY0tleSI6Ik1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRWxCdTZXK2hEZmtId2FTOEdKaXkybURHZHlwdFlUdmhUV3BJR3VsTWtZSTV3UDhJNWYrZGs0N2RHeTQySnVTQkhHOWFzK2pWUzl0NEZBbHV6d01IT05RPT0iLCJmb3JtYXQiOiJTdWJqZWN0UHVibGljS2V5SW5mbyIsImFsZ29yaXRobSI6IkVTMjU2In0sInNpZ25pbmdLZXlBdXRoIjp7ImFkZHJlc3MiOiIweDc4OTRjYTBkYWYzODA1YTFhNTk3NmZjNWU4YWY5NThlZTBlNTIwMzYiLCJzaWduaW5nS2V5U2lnbmF0dXJlIjoiMHgyNDU4ZGY1MmViZjE5ZGVlYzlkMjQyYzJhODI0NTBmNDE3YWNlMjljYWY0ZDg2ODlhNmI0ZGU1OTQ3MjJjOTk2NzBkYzM3OTdjZTczMWEwOTM4NGQ3YTU4NWFjNmZhOGU3Y2Y3N2Y1NjYzNmFiNTE2ODA1ZjA1OGE2YTgyYjJmZTFiIiwic2lnbmluZ0tleU1lc3NhZ2UiOiJJIGF1dGhvcml6ZSBBdGVtUmV2aWV3IGZyb20gdGhpcyBkZXZpY2UgdXNpbmcgc2lnbmluZyBrZXk6XG5NRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUVsQnU2VytoRGZrSHdhUzhHSml5Mm1ER2R5cHRZVHZoVFdwSUd1bE1rWUk1d1A4STVmK2RrNDdkR3k0Mkp1U0JIRzlhcytqVlM5dDRGQWx1endNSE9OUT09In19AQCKY755ww4SGy2v6rU36pvHqHGXe5tjRr1thowZhxqlR2iz07nFrECVHmBaCr_vyn-tLx7917SmutWAaxB8Vyd5a9dgluO1cJ7rH1KYEs8Zjg6kv-f3l8vAsUhHhk4QHPIr0ju8Rdg77Z4fSPhlRQ4cEJ6fDyjdnwSrlUCCqbSo_eb_rRFn6imjxPf16RRZzusxtoAm2_zd_R34_0I9zaz7dmkTUXdf20jDa4R28t5uAXPlTf7xT9wJU-va11Y7dSp7kCAmQjBBE3UlnT8eCbILX8LpJu8J3_76ZnAI8DqPrYOCS0l4Q1Glk7UvTllhTupZ9xbj65YGZRy3OENxJeOF719FV50_LFj0II-McU1F1SIAmyvSAbAITef3b7VN3Br_AGfdSZhN-Cjaqv1Yo4ye5Mnr_LaU-gE2xDZayb0ufxdLXR2K0SN5OzwyW99_o6rdaXjkpOWWnkikAk5_R3Qy5Y-didNLMm67R7axxKWSoNpUELTRajHlr-0gonrSuSqcJnt30VQF_bpVg1TptZOmxDwf9j1gC4fIFo4PTLWJGGl35ehwdQxm5xUq1Q5WzVwi3LAdbRTrih_aQthbX9cGlaUe6002UH3W74MWxRU52dXiOKlLBzRkt-LGNz6RE_0TiY5G8ydGyf7vjQ-qpAud8t56AtZjtdH-gXV4EVTZ7Jz4F-1slaE508RbcjB8yv4skPYyk7kzbz2Q76Sl8q2iLoze8XAuDbyd2ifM7LFCxUDYKoguXENqKWxToYNAOxiyAZFzcElcA-QQXxxwrIlfpsI46nbo5Zc8vqUeQQr71dhWeD5VQILMV_IQhEFDVaTuf4CEkhP0ni7kVl5YXUkUSOHRhTVpuxO-WSc3jp_wuYWQrkIyHYEv2vjv_-b9jKgUJSg1HbcOeKV54lJGQOFIT1zYHBsFb3QQ7MmwiXjP_2pFQ4Q1q2Op6hjqMx36yFEtVUfwnaOCz-ew5UpDzsH2_NTAwZGI8z7tR2DUyxFAnFojbcNPmFe4-Hg8f2uaenrDYiGSJ1ytwyRsNmuDWu3vRckS1s0jT7XeeGLNKo3BmE1cCSb5eHuqBO2zD1ykqbQInojt44QpwxUTpeFptzV9mtSBOA2WH5NYUY4YuO6fU4G2ZgZMPP9cua7p3gG-GZjsjtY4jsUOpkAgTvgEKaKB52nDZULYIctOZUUeZKnSbAxHGWbkqaeJ7kCU-35AY5kTm8NZTqp6cgwcKxBSkP93LddraDyyjeo303WFO52jmNMXvTfw7lq1Zc1mQ475LnIi2duT-lSOCOK60WybsFQJOUVwT1eEXF7h_vEmT5bopUOrX8oCwxFUHhfJbZa0TMRJo6FDfRipD435smc7HpZpAAAHAAAAAAAAAA0BAAAAAAAADZIEGENvbnRlbnQtVHlwZSBhcHBsaWNhdGlvbi9qc29uFkFwcGxpY2F0aW9uGEN5YmVyQ29ubmVjdBRDb250ZW50LUlkgAE3ZDAwMGNiNTI5NTc4N2I3MWU5YThhM2M1NGY5MjdjNGRkZDA2MTg1MGMxYzMwYTU0MWEyMzlhNmQwYTlmNDdlHENvbnRlbnQtRGlnZXN0gAE3ZDAwMGNiNTI5NTc4N2I3MWU5YThhM2M1NGY5MjdjNGRkZDA2MTg1MGMxYzMwYTU0MWEyMzlhNmQwYTlmNDdlHENvbnRlbnQtQXV0aG9yGjg0NjkyODI2NjYwNjEOQ2hhaW5JZAQ1NgxTb3VyY2UIYXRlbQB7ImNvbnRlbnQiOiJ7XCJvcFwiOlwicG9zdFwiLFwiYWRkcmVzc1wiOlwiMHg3MTc4Zjg4MzAyOTc4ZTFhMTIzMjBjY2U1Njg2Y2MxYTE2MDgyZDBkXCIsXCJ0c1wiOjE2OTE0NjA2MjUxOTIsXCJjaGFpbklkXCI6NTYsXCJoYW5kbGVcIjpcIjg0NjkyODI2NjYwNjFcIixcInRpdGxlXCI6XCIxMTExMlwiLFwiYm9keVwiOlwiMjIyMjIyMjIyMjIyMjIyMjIyXCJ9IiwiZGlnZXN0IjoiN2QwMDBjYjUyOTU3ODdiNzFlOWE4YTNjNTRmOTI3YzRkZGQwNjE4NTBjMWMzMGE1NDFhMjM5YTZkMGE5ZjQ3ZSIsInNpZ25hdHVyZSI6IjB4YjRjNTRiNzFjZWE0NGE2ZjBhNTUyMzlhNTEzYmU1NTg2ZWQyMDY2N2M0M2UxYjU1MTJlY2ZiMDFmMWI3ZWM5OWIzYzM3NzlmMjU1NGE2YTNlNzBmYTEzYTQ4YzAyYmM5ZjQyYjRhODljNGEyMTY3ZGFjMzQwMTcxMzllMWE3OTciLCJzaWduaW5nS2V5Ijp7InB1YmxpY0tleSI6Ik1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRUpTMXM5MHBTVlFnWWRYOTJIZGVXaDJjWnA0WHVvNjRmRERYVnF6QWtvb1NJeXhzVmkrRU54a1RINHVDckhuSVpGZ244c1hpQXdaSHVDTWp6bjRZVkp3PT0iLCJmb3JtYXQiOiJTdWJqZWN0UHVibGljS2V5SW5mbyIsImFsZ29yaXRobSI6IkVTMjU2In0sInNpZ25pbmdLZXlBdXRoIjp7ImFkZHJlc3MiOiIweDcxNzhmODgzMDI5NzhlMWExMjMyMGNjZTU2ODZjYzFhMTYwODJkMGQiLCJzaWduaW5nS2V5U2lnbmF0dXJlIjoiMHhlMzhhMWE1OGY3Y2ViMDI1NDA5OTkwYmYxYTk1NzVlMmEyNWZmODZlMjBkOTA4N2I0ZWMzMzQ1ZWE3NjBkOTUzMGM1Y2IzNDA2ZTFiOTE2Mjk5MjcxZDczOWVhZDFhYTgyYmRiMTllNzVmMDVhZjZlZDY4NTJlNjliN2UyNTA1OTFjIiwic2lnbmluZ0tleU1lc3NhZ2UiOiJJIGF1dGhvcml6ZSBBdGVtUmV2aWV3IGZyb20gdGhpcyBkZXZpY2UgdXNpbmcgc2lnbmluZyBrZXk6XG5NRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUVKUzFzOTBwU1ZRZ1lkWDkySGRlV2gyY1pwNFh1bzY0ZkREWFZxekFrb29TSXl4c1ZpK0VOeGtUSDR1Q3JIbklaRmduOHNYaUF3Wkh1Q01qem40WVZKdz09In19AQB3a49J0vHj4Q-1T7Rz-8moRKNbXX9gw0IpzLTuxog0ckxHr6JHo1H_meRPKX_kFUJoqBgZw2eVoirnXcE1rCKFaMAqY8fK10_w8eTWogoBuHqO6GP3iHS868TNIkSuZh9KCZ61bX2sOwOKQWWA681EQCMvjZELkOrAhzPwT93p3cErQmcc1jm9gv9LcACSI46uxTvv_glmWSXWgyozti9lXQmiEmeGuUP5bS8pbFKR155XogDOmoBrns4EgP4GJypBABX80UEgtJyfLC-yBM49W9nSkyxLJZ7hIsZIwSdULWhRhqVtrSJY-R38JJLeu16WitQJiCmgGo3H_6Rpg5rI08wagVWJMM9RX8QL_4w6D9j0wdguT5xzzVM0Xaw2WV50pM1INErpW3at0odfIkuFeN1NGkZYmecnZwzbXjeioUerQfuVmBqBwfB5UskJdDTZfpXgAKLk_VcZsnre1P53Pae8JvFUFheqs_NUkwTe2dMCtLntYynntF3vt-HJVaEok7pfr7SZFJe50-ReUCQvTTSKXW1Nv-oOwCBlhY0Uy2_6cMjybeuBnVkPLy0M8IBUhYH4bjH8os-asOrKtW9qRevFwedxvx7zlAZOMjzpyTZ6aWQu5e1mvmPgzc-VEQJzPv2YlHaK0o0LGO0RnyST9ZSQs-Fybs3jxxdlJA6pO5z4F-1slaE508RbcjB8yv4skPYyk7kzbz2Q76Sl8q2iLoze8XAuDbyd2ifM7LFCxUDYKoguXENqKWxToYNAOxiyAZFzcElcA-QQXxxwrIlfpsI46nbo5Zc8vqUeQQr71dhWeD5VQILMV_IQhEFDVaTuf4CEkhP0ni7kVl5YXUkUSOHRhTVpuxO-WSc3jp_wuYWQrkIyHYEv2vjv_-b9jKgUJSg1HbcOeKV54lJGQOFIT1zYHBsFb3QQ7MmwiXjP_2pFQ4Q1q2Op6hjqMx36yFEtVUfwnaOCz-ew5UpDzsH2_NTAwZGI8z7tR2DUyxFAnFojbcNPmFe4-Hg8f2uaenrDYiGSJ1ytwyRsNmuDWu3vRckS1s0jT7XeeGLNKo3BmE1cCSb5eHuqBO2zD1ykqbQInojt44QpwxUTpeFptzV9mtSBOA2WH5NYUY4YuO6fU4G2ZgZMPP9cua7p3gG-GZjsjtY4jsUOpkAgTvgEKaKB52nDZULYIctOZUUeZKnSbAxHGWbkqaeJ7kCU-35AY5kTm8NZTqp6cgwcKxBSkP93LddraDyyjeo303WFO52jmNMXvTfw7lq1Zc1mQ475LnIi2duT-lSOCOK60WybsFQJOUVwT1eEXF7h_vEmT5bopUOrX8oCwxFUHhfJbZa0TMRJo6FDfRipD435smc7HpZpAAAHAAAAAAAAAAwBAAAAAAAADZAEGENvbnRlbnQtVHlwZSBhcHBsaWNhdGlvbi9qc29uFkFwcGxpY2F0aW9uGEN5YmVyQ29ubmVjdBxDb250ZW50LUF1dGhvchgxaWR1azc2Y3BmZnYOQ2hhaW5JZAQ1NgxTb3VyY2UIYXRlbRRDb250ZW50LUlkgAE0OWE5ZGFkM2UzNWY0YmE4ZGJlYmQ2ZTRhNDIyMmI4MjhhNDcwZDE5YzNjNjk4ODNiNTBlMmE2MjEzNzYxZjIxHENvbnRlbnQtRGlnZXN0gAE0OWE5ZGFkM2UzNWY0YmE4ZGJlYmQ2ZTRhNDIyMmI4MjhhNDcwZDE5YzNjNjk4ODNiNTBlMmE2MjEzNzYxZjIxAHsiY29udGVudCI6IntcIm9wXCI6XCJwb3N0XCIsXCJhZGRyZXNzXCI6XCIweDIyYWZlYThhMzc2MjJkOWNmYzU0MGY2ZGM3MDI2MjBiZTMzNjJhMWJcIixcInRzXCI6MTY5MTQ2MDYyNDM2MCxcImNoYWluSWRcIjo1NixcImhhbmRsZVwiOlwiMWlkdWs3NmNwZmZ2XCIsXCJ0aXRsZVwiOlwiMTExMTJcIixcImJvZHlcIjpcIjIyMjIyMjIyMjIyMjIyMjIyMlwifSIsImRpZ2VzdCI6IjQ5YTlkYWQzZTM1ZjRiYThkYmViZDZlNGE0MjIyYjgyOGE0NzBkMTljM2M2OTg4M2I1MGUyYTYyMTM3NjFmMjEiLCJzaWduYXR1cmUiOiIweDM4OTM1OTk4NjBlZjc2ZTRmMWRhZTI5Yzg5YjI4ZDZmNjk5Njc2NzA4MjhiYjAyYmEyY2FhZmUxMjllNTZjNTk2MDI5OTg0OTUwYTc1NDY3YWRiN2I2ZmVhZTQxMTVkZTllYjM2ZmNhMzQ4ODEyYmJmMDZkMTRiNDEzOWU0NWJjIiwic2lnbmluZ0tleSI6eyJwdWJsaWNLZXkiOiJNRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUVvKzQ0d0tBVWp4SkVtZWRLY2NvUXMwTG5LWnlOU1FiRXdoVzloTEFPMnBKdnFpcHgwREdSRVFMd1VCalNQNy9Bb0JCdkVRV1ltRWptd01JTlF1Z3NlUT09IiwiZm9ybWF0IjoiU3ViamVjdFB1YmxpY0tleUluZm8iLCJhbGdvcml0aG0iOiJFUzI1NiJ9LCJzaWduaW5nS2V5QXV0aCI6eyJhZGRyZXNzIjoiMHgyMmFmZWE4YTM3NjIyZDljZmM1NDBmNmRjNzAyNjIwYmUzMzYyYTFiIiwic2lnbmluZ0tleVNpZ25hdHVyZSI6IjB4ZTMzYThlOTZlZDY5ZTgzM2QyOGRkY2VlM2UxM2ZkZjg0ZjIwNDAyMmVhNzhhMjNhMjkzOGNkOTdlMDRlMjYwYjA3MTczYTBlZWQ5ODJhNmM2NzU4M2JmYjhkYTViOWYzMTQwN2UyMjVhMjdmZjYxNzMwNjkxYWY1OTU0ZmU4Y2IxYiIsInNpZ25pbmdLZXlNZXNzYWdlIjoiSSBhdXRob3JpemUgQXRlbVJldmlldyBmcm9tIHRoaXMgZGV2aWNlIHVzaW5nIHNpZ25pbmcga2V5OlxuTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFbys0NHdLQVVqeEpFbWVkS2Njb1FzMExuS1p5TlNRYkV3aFc5aExBTzJwSnZxaXB4MERHUkVRTHdVQmpTUDcvQW9CQnZFUVdZbUVqbXdNSU5RdWdzZVE9PSJ9fQEAJwJV3hib-IwMbV1jamYLZYLWtpxOqf_GiSGXG4UD0xYsTvPNFwE2w3mvKU8m4-pIFjKqSKxaduOj8ZHbXpDLAZBL_o6UUZiWqr6bz_r3btFS4WZ52F9eM6jICx5ahMbnbKsMTPfAY5q4653HuYgs51g4BAH0OPA0yhMR_mXkQemFF0uf1s2s7WLjbehBmnTMI_fXXIwe-dauJfWlSu6pyzqZLAC3YgqEm6vPTdlW0jdw7OGeVakBCVxYsNq8O9Rznojkn0lpW5hNIpVD6nfCMqJL1uj0cH2vJ_t6wkGSBmUbSbPuedVyAMdCszSu1dK_r6ryqM3Bn1T3qGO4hBphKUnJb5j4-2gAzSibZDFp5sCHpaxdt92VlAbhDMh1skcHuJ2vc49j06k4KA4fOv9pxrruZ-QW_dLkKBjdlPq1GW3Fx5coEB5bNNd635nmK2Q6xp-zLgikQ-0ACb9SO1EedLfApZra8uNOzIHZx2ZQ4h-W5hzo31Ad2XQrz6XhUwVZ3iNNeTvAgZLVM2wS1jtohSiv_lphCXFcgnrOYT0uRSzdsx9ctE4Ry2X5oDgPGR96vxdX43Roj2jQ3Wa-CZtLXI_8Vinx2RskpClvyRC37iaMVAvSTZgL68WYFy9YcirXS6sDj_GD7a0FScQ2r32vQG5J2-cDoPp3MAZ0LMoZMrmc-BftbJWhOdPEW3IwfMr-LJD2MpO5M289kO-kpfKtoi6M3vFwLg28ndonzOyxQsVA2CqILlxDailsU6GDQDsYsgGRc3BJXAPkEF8ccKyJX6bCOOp26OWXPL6lHkEK-9XYVng-VUCCzFfyEIRBQ1Wk7n-AhJIT9J4u5FZeWF1JFEjh0YU1absTvlknN46f8LmFkK5CMh2BL9r47__m_YyoFCUoNR23DnileeJSRkDhSE9c2BwbBW90EOzJsIl4z_9qRUOENatjqeoY6jMd-shRLVVH8J2jgs_nsOVKQ87B9vzUwMGRiPM-7Udg1MsRQJxaI23DT5hXuPh4PH9rmnp6w2IhkidcrcMkbDZrg1rt70XJEtbNI0-13nhizSqNwZhNXAkm-Xh7qgTtsw9cpKm0CJ6I7eOEKcMVE6Xhabc1fZrUgTgNlh-TWFGOGLjun1OBtmYGTDz_XLmu6d4BvhmY7I7WOI7FDqZAIE74BCmigedpw2VC2CHLTmVFHmSp0mwMRxlm5Kmnie5AlPt-QGOZE5vDWU6qenIMHCsQUpD_dy3Xa2g8so3qN9N1hTudo5jTF7038O5atWXNZkOO-S5yItnbk_pUjgjiutFsm7BUCTlFcE9XhFxe4f7xJk-W6KVDq1_KAsMRVB4XyW2WtEzESaOhQ30YqQ-N-bJnOx6WaQAABwAAAAAAAAAUAQAAAAAAAA2gBBhDb250ZW50LVR5cGUgYXBwbGljYXRpb24vanNvbhZBcHBsaWNhdGlvbhhDeWJlckNvbm5lY3QcQ29udGVudC1BdXRob3Ieamxnb3Fua3huYXBiczM3DkNoYWluSWQENTYMU291cmNlEmN5YmVydHVuZRRDb250ZW50LUlkgAE3OWEzMDgxMTVmMTVhY2MxOWY2NjE0ZDZkMWMzYjFhN2JiM2M3ZTA3YWYyMDg5MzYzMjE0NzNjZDBhNmMwMjhmHENvbnRlbnQtRGlnZXN0gAE3OWEzMDgxMTVmMTVhY2MxOWY2NjE0ZDZkMWMzYjFhN2JiM2M3ZTA3YWYyMDg5MzYzMjE0NzNjZDBhNmMwMjhmAHsiY29udGVudCI6IntcIm9wXCI6XCJwb3N0XCIsXCJhZGRyZXNzXCI6XCIweGI4NTAzYWM1YWJhMWMzNDZjNGVkZjRhNDNlNjUxZGRlOTg5YzNjODVcIixcInRzXCI6MTY5MTQ2MDYyNTEwNCxcImNoYWluSWRcIjo1NixcImhhbmRsZVwiOlwiamxnb3Fua3huYXBiczM3XCIsXCJ0aXRsZVwiOlwiVGhlIFNlY3JldCBvZiB0aGUgSGlkZGVuIFRlbXBsZVwiLFwiYm9keVwiOlwiVGhpcyBwb3N0IGlzIHNvIGluZm9ybWF0aXZlLCBpdCdzIGEgZ3JlYXQgcmVzb3VyY2UgZm9yIGFueW9uZVwifSIsImRpZ2VzdCI6Ijc5YTMwODExNWYxNWFjYzE5ZjY2MTRkNmQxYzNiMWE3YmIzYzdlMDdhZjIwODkzNjMyMTQ3M2NkMGE2YzAyOGYiLCJzaWduYXR1cmUiOiIweDhmYjJkMTE3MDZmZjliNjMzZTc0YWY1YmZhNWM5OTczYjNkZWEzMGFmNDEwMmZhM2VlMDg5MWY3ODMzZTIyNDk3ZDg4MDJjZWE4YWZkMjIxNjhiZDIwYmRhMmQ2YjM5ODZhNDY1NDg4ZjMyMzAwYTdjNGIxMzE4MjU0ZmEwNzhkIiwic2lnbmluZ0tleSI6eyJwdWJsaWNLZXkiOiJNRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUVLU1FFQ1pESlNYdXMvZWMzcWp0My9uVmFPYW9YT2QwdTJnUFpMZDlvNThoRnR5cFRXU3hWVWFyWkpSUnNtaDdYT3RucXZ5Wk93YTFkYnlrWnpmdEdtZz09IiwiZm9ybWF0IjoiU3ViamVjdFB1YmxpY0tleUluZm8iLCJhbGdvcml0aG0iOiJFUzI1NiJ9LCJzaWduaW5nS2V5QXV0aCI6eyJhZGRyZXNzIjoiMHhiODUwM2FjNWFiYTFjMzQ2YzRlZGY0YTQzZTY1MWRkZTk4OWMzYzg1Iiwic2lnbmluZ0tleVNpZ25hdHVyZSI6IjB4Mjc0ZmI4YmE4N2Y5YmI5OGQ2ZTNkZTRjYzY0ZWMyM2E4ZDE0OGRiZjEwZWMxYjlhMjhlOWE1OWZkMWNkZjZiYzQ4YjU5ODljZTY1ZTI2YmE1YzY5ZGZmZmZmMTZiODU1YTYzMWFmZWEyN2E3MzYyZjk0NDMzMGM1MzJkMTliYTcxYyIsInNpZ25pbmdLZXlNZXNzYWdlIjoiSSBhdXRob3JpemUgSSBhdXRob3JpemUgQ3liZXJUdW5lLnh5eiBmcm9tIHRoaXMgZGV2aWNlIHVzaW5nIHNpZ25pbmcga2V5OlxuTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFS1NRRUNaREpTWHVzL2VjM3FqdDMvblZhT2FvWE9kMHUyZ1BaTGQ5bzU4aEZ0eXBUV1N4VlVhclpKUlJzbWg3WE90bnF2eVpPd2ExZGJ5a1p6ZnRHbWc9PSJ9fQEAI1xudZk174FLDQ2lzbA5-NskHBM435n5AUULzVDYVEJgCP9zfbkrkpeqcAP7XJe7VwQo9_07yVOEns0PaH-jJXwCKxi195D6-5a7sVf8HTgCRY0dtlv0-3Zbnij16vRvbfY08CFQ8Oq1qqOPpgP58fm3sRVoT2j-1TvCSrdjwFUFVcjSk07P3JkdvpLMXfEZ9O58rIAU4ILnMKQlCEy5_xcur8mGthP0VwRYimR5Te-RlLRe-6IrTVLR3RgnKItwzcd7nRjgZZPgcJxbp_eb_07MSmGeXS7B5Ndpp2TgPVRe--wZIEOTD0rCBctdUHioeuyk_08oi3b3bKcYBxVTq-IP0reVy3CygDdAsfy7mebH2uHplhB3aHWB5JY2brNyps2PP-yLRenVg0LwnnDK9k9eLc65zgvuR-9OWffRgch19RssLpXykJ8Ov2OG2JBONn9KeJiIJNh0MzTJzDH3lUAh1eTsw5LxfdP_gx_Nr7ARQrYaxBe26urVzOlhn9CWFEOR30bkD3raPvOXjRZwgf6iKNTvgBtnryvSgPBI5Jg2hK_xfTB6Jqn8ihc_Ri7YAJhtFwXWoZYLpqeL2bhUZjwnt1oP1-Q7bBXQ--H2PsbJPwxdREFZJ-sl9BbGXWd3RG4LHJ69RqDG3LRDGBYagFHIqb4sTSCM8yinxkXVTKWc-BftbJWhOdPEW3IwfMr-LJD2MpO5M289kO-kpfKtoi6M3vFwLg28ndonzOyxQsVA2CqILlxDailsU6GDQDsYsgGRc3BJXAPkEF8ccKyJX6bCOOp26OWXPL6lHkEK-9XYVng-VUCCzFfyEIRBQ1Wk7n-AhJIT9J4u5FZeWF1JFEjh0YU1absTvlknN46f8LmFkK5CMh2BL9r47__m_YyoFCUoNR23DnileeJSRkDhSE9c2BwbBW90EOzJsIl4z_9qRUOENatjqeoY6jMd-shRLVVH8J2jgs_nsOVKQ87B9vzUwMGRiPM-7Udg1MsRQJxaI23DT5hXuPh4PH9rmnp6w2IhkidcrcMkbDZrg1rt70XJEtbNI0-13nhizSqNwZhNXAkm-Xh7qgTtsw9cpKm0CJ6I7eOEKcMVE6Xhabc1fZrUgTgNlh-TWFGOGLjun1OBtmYGTDz_XLmu6d4BvhmY7I7WOI7FDqZAIE74BCmigedpw2VC2CHLTmVFHmSp0mwMRxlm5Kmnie5AlPt-QGOZE5vDWU6qenIMHCsQUpD_dy3Xa2g8so3qN9N1hTudo5jTF7038O5atWXNZkOO-S5yItnbk_pUjgjiutFsm7BUCTlFcE9XhFxe4f7xJk-W6KVDq1_KAsMRVB4XyW2WtEzESaOhQ30YqQ-N-bJnOx6WaQAACAAAAAAAAAB9AQAAAAAAAA_yBRhDb250ZW50LVR5cGUgYXBwbGljYXRpb24vanNvbhZBcHBsaWNhdGlvbhhDeWJlckNvbm5lY3QUQ29udGVudC1JZIABNjkwZTc4YWUwM2ZhMjFhZGQyY2E1YjA1ZGFlNjg3YTc1OWRkODFkN2U3YzljM2MzOTA0YzQ0ZjFkZjFiOTUwNxxDb250ZW50LURpZ2VzdIABNjkwZTc4YWUwM2ZhMjFhZGQyY2E1YjA1ZGFlNjg3YTc1OWRkODFkN2U3YzljM2MzOTA0YzQ0ZjFkZjFiOTUwNxxDb250ZW50LUF1dGhvchg5a3dsZ3ViZXd3aXcOQ2hhaW5JZAQ1NhxDb250ZW50LVRhcmdldIABMzlmMDIxODgxZTczODZmOGQ3M2Q2ZWYyNTUzM2U2MDkxZjJhMDI1NmU0MjJiNGIzYzRlM2QzMzVjY2FlMTQ3ZQxTb3VyY2VIMTU1MzFmYTItMTIwNS00ZjYxLWI2ZTQtYzlmNjhlY2Y4MWY3AHsiY29udGVudCI6IntcIm9wXCI6XCJjb21tZW50XCIsXCJhZGRyZXNzXCI6XCIweGFlOWM4MmZhMTk2NjU4YjRjOGE5ZmMyZjc1MTUyN2U1YmUzZWY3ZjJcIixcInRzXCI6MTY5MTQ2MDYyNDQ2NCxcImNoYWluSWRcIjo1NixcImhhbmRsZVwiOlwiOWt3bGd1YmV3d2l3XCIsXCJ0YXJnZXRcIjpcIjM5ZjAyMTg4MWU3Mzg2ZjhkNzNkNmVmMjU1MzNlNjA5MWYyYTAyNTZlNDIyYjRiM2M0ZTNkMzM1Y2NhZTE0N2VcIixcInRpdGxlXCI6XCJGbGFwcHlNb29uYmlyZFwiLFwiYm9keVwiOlwiU28gZnVuIHRvIHBsYXkgaW4gbXkgc3BhcmUgdGltZS5cIn0iLCJkaWdlc3QiOiI2OTBlNzhhZTAzZmEyMWFkZDJjYTViMDVkYWU2ODdhNzU5ZGQ4MWQ3ZTdjOWMzYzM5MDRjNDRmMWRmMWI5NTA3Iiwic2lnbmF0dXJlIjoiMHg2NzU5MzkwNzIzZDRkNjllZjNhZTk5MGNiMDcyNDA0M2RiNjlkNDA0MTZmMTExNmMxMGFhYWI5OTYxNzJjYjAyMmIyMDVmYTk4ODVlZTVkZWY0NDU1ZmI4ZjFkYTVkZGZkMjgwY2U0MzhlYTgwMjFmN2U4N2VmNzQxYTc1YWFkNyIsInNpZ25pbmdLZXkiOnsicHVibGljS2V5IjoiTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFdDdxY1N3MXdpSlMrUUJhRy9CWjRnM2JBWE1DOE1UUWhNcWhKZTNpLzJnSGlsdlpocHk5YnkzQ0JoZmxTQm12WDdVT0xhTVA5OGtNTDV1L1ROV2p5S0E9PSIsImZvcm1hdCI6IlN1YmplY3RQdWJsaWNLZXlJbmZvIiwiYWxnb3JpdGhtIjoiRVMyNTYifSwic2lnbmluZ0tleUF1dGgiOnsiYWRkcmVzcyI6IjB4YWU5YzgyZmExOTY2NThiNGM4YTlmYzJmNzUxNTI3ZTViZTNlZjdmMiIsInNpZ25pbmdLZXlTaWduYXR1cmUiOiIweDNmZDhmNzVlMzRhNzcwYmEyYTBkYmU0NzcyZWVjZmIxNWMwZGYyYzRjMTI0NTZmNzc4ZmE1NjdmM2UwNmRlMTY3Njg2OTM5MWU5NzY0MGU5MDkyYWEzMWZhMzUyNGZlYWIxYzZkMzQ1MDU0M2RjYTUwNTQ4MjdmN2M2OGM4NzllMWIiLCJzaWduaW5nS2V5TWVzc2FnZSI6IkkgYXV0aG9yaXplIEN5YmVyQ29ubmVjdCBmcm9tIHRoaXMgZGV2aWNlIHVzaW5nIHNpZ25pbmcga2V5OlxuTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFdDdxY1N3MXdpSlMrUUJhRy9CWjRnM2JBWE1DOE1UUWhNcWhKZTNpLzJnSGlsdlpocHk5YnkzQ0JoZmxTQm12WDdVT0xhTVA5OGtNTDV1L1ROV2p5S0E9PSJ9fQEAdrY2G6okB1SF17TjOpTTJhh6QluX1bafe4D2fYsw1hJ_FmfJoTfsC9CzJ1_5cSlHd4j5CFTOqXO_J94oz8ZdNNd7zDGloi-q4w9cDNdUutFWGNuwdAZm-f-L01W32c3T_euDCIwmSnr2eBMSDsx31pMpFldFSB1NNndiuiaL55wKes0YC2xcVGXt--K_TQgB-qk9087J5hB8FNuH-4x8NteLvb7xCQcFGOjyjXmJnrIRqqAylYwXfQUeOsgIHfCAaUnEsKssRpUG_93w5Wx60PXjWn_wv86r08Q331vasbiJoLydWLrRl8ANEKPLmfmJSSf3oUPRN2jOH8B8iZZA3R0GrrZ4JFcgFMtEs6dHxG09cHJu_RXBhqt3n3YyhRxJAh8EJdBorlPQbIjrmgQW3ZVk9xbZexdIIRmpUyPEuAOPgAHBYTWPMhQa4XHUw-8J6VrhCiQAhEFRnnc20N0UncCTcFZCYZS7qBFvTsjMq3_OQF4FsR-c-8Z2-7n9u8lscFGra-3ojYHHDXDXmeNXS-Dy18CDtx-LdQ2cBIygBDaM3x2zpr8H3ikDbBDX5jRnnoJmNNIKaKWje2VnQREkUIbMEod8aa0keOfA7WyU_wuFGIPr6VpQ3ZPOBuSjY_kiOLhWrcwBPcYhF0TxxQ1QS64MkD98QKJ5pfuX3V7DF4ic-BftbJWhOdPEW3IwfMr-LJD2MpO5M289kO-kpfKtoi6M3vFwLg28ndonzOyxQsVA2CqILlxDailsU6GDQDsYsgGRc3BJXAPkEF8ccKyJX6bCOOp26OWXPL6lHkEK-9XYVng-VUCCzFfyEIRBQ1Wk7n-AhJIT9J4u5FZeWF1JFEjh0YU1absTvlknN46f8LmFkK5CMh2BL9r47__m_YyoFCUoNR23DnileeJSRkDhSE9c2BwbBW90EOzJsIl4z_9qRUOENatjqeoY6jMd-shRLVVH8J2jgs_nsOVKQ87B9vzUwMGRiPM-7Udg1MsRQJxaI23DT5hXuPh4PH9rmnp6w2IhkidcrcMkbDZrg1rt70XJEtbNI0-13nhizSqNwZhNXAkm-Xh7qgTtsw9cpKm0CJ6I7eOEKcMVE6Xhabc1fZrUgTgNlh-TWFGOGLjun1OBtmYGTDz_XLmu6d4BvhmY7I7WOI7FDqZAIE74BCmigedpw2VC2CHLTmVFHmSp0mwMRxlm5Kmnie5AlPt-QGOZE5vDWU6qenIMHCsQUpD_dy3Xa2g8so3qN9N1hTudo5jTF7038O5atWXNZkOO-S5yItnbk_pUjgjiutFsm7BUCTlFcE9XhFxe4f7xJk-W6KVDq1_KAsMRVB4XyW2WtEzESaOhQ30YqQ-N-bJnOx6WaQAABwAAAAAAAAAMAQAAAAAAAA2QBBhDb250ZW50LVR5cGUgYXBwbGljYXRpb24vanNvbhZBcHBsaWNhdGlvbhhDeWJlckNvbm5lY3QUQ29udGVudC1JZIABYzZmZDM1ZTY4MDlkNWY2MGNjZDMyOTgyMWFjNWM5ODAxODI1YjlhYWYzMGM0ZDdlYTk1OGRhYzg3Mjk5MTAxZRxDb250ZW50LURpZ2VzdIABYzZmZDM1ZTY4MDlkNWY2MGNjZDMyOTgyMWFjNWM5ODAxODI1YjlhYWYzMGM0ZDdlYTk1OGRhYzg3Mjk5MTAxZRxDb250ZW50LUF1dGhvchhpN25ybHViNnF5dm0OQ2hhaW5JZAQ1NgxTb3VyY2UIYXRlbQB7ImNvbnRlbnQiOiJ7XCJvcFwiOlwicG9zdFwiLFwiYWRkcmVzc1wiOlwiMHhmNTlkOTY1YTQ5ZjFlZmQxZTA2ZGVmZjUxOTRmZWE4OTQ1NzEwOWUwXCIsXCJ0c1wiOjE2OTE0NjA2MjUxNTEsXCJjaGFpbklkXCI6NTYsXCJoYW5kbGVcIjpcImk3bnJsdWI2cXl2bVwiLFwidGl0bGVcIjpcIjExMTEyXCIsXCJib2R5XCI6XCIyMjIyMjIyMjIyMjIyMjIyMjJcIn0iLCJkaWdlc3QiOiJjNmZkMzVlNjgwOWQ1ZjYwY2NkMzI5ODIxYWM1Yzk4MDE4MjViOWFhZjMwYzRkN2VhOTU4ZGFjODcyOTkxMDFlIiwic2lnbmF0dXJlIjoiMHg1YzRmMzJjNjczZjhlNDlmNzRiYTRkNGI4MDA5NThiMDM2N2JhMWNlMWZlMDRjZWYxNzAxY2IyZmIzZmMzNDg4OGE2YWZkY2MzNDU0MzkxZTRlNzQ4ZmY3ODU3MWQ0YTRmYTg5Y2IwOGNhNjQyZDdmMzg5YjE1MGZiOTJlYmMyYSIsInNpZ25pbmdLZXkiOnsicHVibGljS2V5IjoiTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFcTJtRWR6TGNRZ2RKQitLZ3VZYWJKOXkyNzRnYTlNeGpuR3RmSGpZbjdNZHFIM2xvc1pNYmR4L3ZnN3ZoVHNJTm1MSWNscmNvV2VLMHl0NDd1V2FkQ3c9PSIsImZvcm1hdCI6IlN1YmplY3RQdWJsaWNLZXlJbmZvIiwiYWxnb3JpdGhtIjoiRVMyNTYifSwic2lnbmluZ0tleUF1dGgiOnsiYWRkcmVzcyI6IjB4ZjU5ZDk2NWE0OWYxZWZkMWUwNmRlZmY1MTk0ZmVhODk0NTcxMDllMCIsInNpZ25pbmdLZXlTaWduYXR1cmUiOiIweDFmMGVmNTgyYjU2ZGM3NWVjMjVmZDUyNWY3OWNkZTA2Yzg2ZDg2MTI0ZGYwZmQxYjA2NzE1ZDhhOTQxN2RlMjA1NWUwM2E1YmVjNGQ4OGUxYmVmMTRkMWM1ZWY5YTNmZjUzYjNkZmNmM2NjNjUxNDY1OTQxNDJhMmUxNTExNTM5MWIiLCJzaWduaW5nS2V5TWVzc2FnZSI6IkkgYXV0aG9yaXplIEF0ZW1SZXZpZXcgZnJvbSB0aGlzIGRldmljZSB1c2luZyBzaWduaW5nIGtleTpcbk1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRXEybUVkekxjUWdkSkIrS2d1WWFiSjl5Mjc0Z2E5TXhqbkd0ZkhqWW43TWRxSDNsb3NaTWJkeC92Zzd2aFRzSU5tTEljbHJjb1dlSzB5dDQ3dVdhZEN3PT0ifX0BAEN3lSFhRWQTLbY50NrVDdAoJs1sJl2j1XRaF1Y97l5CDGnRgobkpIA5zeOcA6573rJ_dNrklZdGiHq4UF16_SJWIwkcyi8yJzRTgHC7ipCC8ZVPyAVW6qYX6LVQoRjgKrwcpTIR5nSsIV7aBpZCS4BUfh_SL0yv-zkWLTDGw38jHJOhUlt-TneBe7RW2eGsHzHUoC00zUXmnvjx0liUQmSoZ3VELO-6Jd7clG8oqnY5g36gTdhJT4NSDAuG56I4kpL8ZQuamdbuTImNqnlgoZg9a2nS6YdANyMUmL84yK-zV8DFQ9Kvea_RjYAF3Sy0hYXddmmwRziBDPMzb1GRhGDrDSSrVR0UFRC6oRKqxv2G0JoLgrzFDFi3vsPgjGB5EtMjkhH_Q3iGMUhGXkIduAAU_qnH1BayZLLp1QrEjDlvMMePw-eXG6ringwB7-9vbDDDVsbSZ32ZKfOuXGJ1RngM65zuFMaMMNux8p3rHLsMvT9EbcAnPDJNut2g_4Ev9h6aiPzp-yNSDX1C0s8fwzRPOrizTYEl5m0lbwjhOGOcioO438UnN4rGd7lNO6_nE0fTlgeWcT6laxtN8sz6_gEkciggQNPu8TdAecSddJHDnY_OYPqdM0VQOmor9gV92ZbNEyMVNxB_YMjH4wX2cQg1mh7_b2ssKhLGr-lzJoBNnPgX7WyVoTnTxFtyMHzK_iyQ9jKTuTNvPZDvpKXyraIujN7xcC4NvJ3aJ8zssULFQNgqiC5cQ2opbFOhg0A7GLIBkXNwSVwD5BBfHHCsiV-mwjjqdujllzy-pR5BCvvV2FZ4PlVAgsxX8hCEQUNVpO5_gISSE_SeLuRWXlhdSRRI4dGFNWm7E75ZJzeOn_C5hZCuQjIdgS_a-O__5v2MqBQlKDUdtw54pXniUkZA4UhPXNgcGwVvdBDsybCJeM__akVDhDWrY6nqGOozHfrIUS1VR_Cdo4LP57DlSkPOwfb81MDBkYjzPu1HYNTLEUCcWiNtw0-YV7j4eDx_a5p6esNiIZInXK3DJGw2a4Na7e9FyRLWzSNPtd54Ys0qjcGYTVwJJvl4e6oE7bMPXKSptAieiO3jhCnDFROl4Wm3NX2a1IE4DZYfk1hRjhi47p9TgbZmBkw8_1y5runeAb4ZmOyO1jiOxQ6mQCBO-AQpooHnacNlQtghy05lRR5kqdJsDEcZZuSpp4nuQJT7fkBjmRObw1lOqnpyDBwrEFKQ_3ct12toPLKN6jfTdYU7naOY0xe9N_DuWrVlzWZDjvkuciLZ25P6VI4I4rrRbJuwVAk5RXBPV4RcXuH-8SZPluilQ6tfygLDEVQeF8ltlrRMxEmjoUN9GKkPjfmyZzselmkAAAcAAAAAAAAADAEAAAAAAAANkAQYQ29udGVudC1UeXBlIGFwcGxpY2F0aW9uL2pzb24WQXBwbGljYXRpb24YQ3liZXJDb25uZWN0DFNvdXJjZQhhdGVtFENvbnRlbnQtSWSAAWQzNTAyYThmODQzZmRkZDg3MTFmZThhOThhNzM2MTI2ODNlZWRkZmI5NjgzYTJlZmY0YzJjNDk0NjM5ZDQ3YTMcQ29udGVudC1EaWdlc3SAAWQzNTAyYThmODQzZmRkZDg3MTFmZThhOThhNzM2MTI2ODNlZWRkZmI5NjgzYTJlZmY0YzJjNDk0NjM5ZDQ3YTMcQ29udGVudC1BdXRob3IYejNibG1rNDNkdndwDkNoYWluSWQENTYAeyJjb250ZW50Ijoie1wib3BcIjpcInBvc3RcIixcImFkZHJlc3NcIjpcIjB4ZWM1MDI3YjA4ODM0NDc3ZTFhYWEwYTlkNmNiMDQ4MGM0MzFjYzQ4Y1wiLFwidHNcIjoxNjkxNDYwNjI0MjM4LFwiY2hhaW5JZFwiOjU2LFwiaGFuZGxlXCI6XCJ6M2JsbWs0M2R2d3BcIixcInRpdGxlXCI6XCIxMTExMlwiLFwiYm9keVwiOlwiMjIyMjIyMjIyMjIyMjIyMjIyXCJ9IiwiZGlnZXN0IjoiZDM1MDJhOGY4NDNmZGRkODcxMWZlOGE5OGE3MzYxMjY4M2VlZGRmYjk2ODNhMmVmZjRjMmM0OTQ2MzlkNDdhMyIsInNpZ25hdHVyZSI6IjB4ODY1OWM3OGI5ZmE5ZWYwNGYxNGZjN2MzNDIyOWI1MmE4YjQ2ZGY5ZDc0OWNiZTViZTg2MDIwODY2MzY0MDE3NWEzNzFhY2RjOWE0ZTA3NmVmMDBlZTIyMWFjYzRkMjBjMGZjYTI4ODExMzFjODYxNjNmZmEwZDMwODBiZDlkOTMiLCJzaWduaW5nS2V5Ijp7InB1YmxpY0tleSI6Ik1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRStLaUJBbWlOeEo1M1psbmk0Z2xDUFhTd2F6MmlNU0xVUURIOVhJS3J6aGpoKzdiQVZVZys1U0dIZzVxRXdsajBuRlUxcVkxcTJaQnpMZlVIMmZhblFBPT0iLCJmb3JtYXQiOiJTdWJqZWN0UHVibGljS2V5SW5mbyIsImFsZ29yaXRobSI6IkVTMjU2In0sInNpZ25pbmdLZXlBdXRoIjp7ImFkZHJlc3MiOiIweGVjNTAyN2IwODgzNDQ3N2UxYWFhMGE5ZDZjYjA0ODBjNDMxY2M0OGMiLCJzaWduaW5nS2V5U2lnbmF0dXJlIjoiMHgxZTk2ZGExMWNjNjgzMTlkMTBhZTEzMWEwOTk0OWYxMThjZWMwNjhiYWM5ZTRhOWE0NThkYTkzN2IwYzQ4ZGVlNWQ2YmJhOGFkMGFhY2M3MjlhYTFhNzIxOGUzOTljZDMzM2JlYTAwMWYzZTFlODJkOGU0M2Q5MDU1OTJlZTgzYjFjIiwic2lnbmluZ0tleU1lc3NhZ2UiOiJJIGF1dGhvcml6ZSBBdGVtUmV2aWV3IGZyb20gdGhpcyBkZXZpY2UgdXNpbmcgc2lnbmluZyBrZXk6XG5NRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUUrS2lCQW1pTnhKNTNabG5pNGdsQ1BYU3dhejJpTVNMVVFESDlYSUtyemhqaCs3YkFWVWcrNVNHSGc1cUV3bGowbkZVMXFZMXEyWkJ6TGZVSDJmYW5RQT09In19AQAAP1Ftt9FdlOx7JsKC9l6OnE1iz5Mys04Nk40kwpS-lXb_lQNELUDep4BY1VO1d3Ebm58WNwcVy8qVFmQkmO66LosN9eCq_cMBFw3AFc4ogD0qHlnRq6QiEm6YWJvHyiXKrb7Eymes8T39SJz09ryu0aoipe686GejZDeJ2k-FYs-LBoIejfYVm5bUfqz8_bB6oSebZJqNWeuKq42ghxJQDqDOHCPg7PWHKZrYg61rmIfnVFKHTHHspzMesZgXOtm2jGz2n1oOucQXc9AVb1NCnCV7N4QNQ3xbdATEErzdZfcZoRquvbYl-GLEKqy0hO6b57YbbV_TocfC53QVk-Xk3W9omRER9BaBqo5Iji7Ge1Ju2t-cAlMQzEoN_w5Bf3PVAnwgejFGAmry2N_GpWR7hXz-pjdtrMoCJKfQJc0dwN6y129PZjL2V6TJa4mDIPjs-TcM-Z0wtQ-sHW8bKbQucjPSABHQlEM0nsxZWDD0Xh9yFWbAzq91iar3GvFzr4fJ60FBI829hhhLedq16HiWNcEMsy3XLT3RsK3ADQUxfkNbDQOxOsh5Us7S8dLkpjycPdpqG5H23Dwc0XG3Kvqdl0t_o-K-FbNN-zb_2jzTV41yGngPeKirqGtqEYWuotjIEyyXPnr_hEFKuroknx5UAHsjoJyuJHrqHiBr4iyb5Jz4F-1slaE508RbcjB8yv4skPYyk7kzbz2Q76Sl8q2iLoze8XAuDbyd2ifM7LFCxUDYKoguXENqKWxToYNAOxiyAZFzcElcA-QQXxxwrIlfpsI46nbo5Zc8vqUeQQr71dhWeD5VQILMV_IQhEFDVaTuf4CEkhP0ni7kVl5YXUkUSOHRhTVpuxO-WSc3jp_wuYWQrkIyHYEv2vjv_-b9jKgUJSg1HbcOeKV54lJGQOFIT1zYHBsFb3QQ7MmwiXjP_2pFQ4Q1q2Op6hjqMx36yFEtVUfwnaOCz-ew5UpDzsH2_NTAwZGI8z7tR2DUyxFAnFojbcNPmFe4-Hg8f2uaenrDYiGSJ1ytwyRsNmuDWu3vRckS1s0jT7XeeGLNKo3BmE1cCSb5eHuqBO2zD1ykqbQInojt44QpwxUTpeFptzV9mtSBOA2WH5NYUY4YuO6fU4G2ZgZMPP9cua7p3gG-GZjsjtY4jsUOpkAgTvgEKaKB52nDZULYIctOZUUeZKnSbAxHGWbkqaeJ7kCU-35AY5kTm8NZTqp6cgwcKxBSkP93LddraDyyjeo303WFO52jmNMXvTfw7lq1Zc1mQ475LnIi2duT-lSOCOK60WybsFQJOUVwT1eEXF7h_vEmT5bopUOrX8oCwxFUHhfJbZa0TMRJo6FDfRipD435smc7HpZpAAAIAAAAAAAAAH4BAAAAAAAAD_QFGENvbnRlbnQtVHlwZSBhcHBsaWNhdGlvbi9qc29uFkFwcGxpY2F0aW9uGEN5YmVyQ29ubmVjdAxTb3VyY2VIMTU1MzFmYTItMTIwNS00ZjYxLWI2ZTQtYzlmNjhlY2Y4MWY3FENvbnRlbnQtSWSAATIzNzVmNjg5ZmY1YWI2Yjg3ZWY0YzQ1MTU1YjY3OWE0ZmU5OTY0YTVlZTZkYzUyOWFhMWVkODBiNjM1MWNkNTAcQ29udGVudC1EaWdlc3SAATIzNzVmNjg5ZmY1YWI2Yjg3ZWY0YzQ1MTU1YjY3OWE0ZmU5OTY0YTVlZTZkYzUyOWFhMWVkODBiNjM1MWNkNTAcQ29udGVudC1BdXRob3IaNDA4NTQ5NjE0ODM1MQ5DaGFpbklkBDU2HENvbnRlbnQtVGFyZ2V0gAEzOWYwMjE4ODFlNzM4NmY4ZDczZDZlZjI1NTMzZTYwOTFmMmEwMjU2ZTQyMmI0YjNjNGUzZDMzNWNjYWUxNDdlAHsiY29udGVudCI6IntcIm9wXCI6XCJjb21tZW50XCIsXCJhZGRyZXNzXCI6XCIweGNmNDY0MGE1N2M1NzI3Y2U4MWE5ODg3NmMyMjE5Yjg0Mjk4ZTA5ODdcIixcInRzXCI6MTY5MTQ2MDYyNTI5NixcImNoYWluSWRcIjo1NixcImhhbmRsZVwiOlwiNDA4NTQ5NjE0ODM1MVwiLFwidGFyZ2V0XCI6XCIzOWYwMjE4ODFlNzM4NmY4ZDczZDZlZjI1NTMzZTYwOTFmMmEwMjU2ZTQyMmI0YjNjNGUzZDMzNWNjYWUxNDdlXCIsXCJ0aXRsZVwiOlwiRmxhcHB5TW9vbmJpcmRcIixcImJvZHlcIjpcIlNvIGZ1biB0byBwbGF5IGluIG15IHNwYXJlIHRpbWUuXCJ9IiwiZGlnZXN0IjoiMjM3NWY2ODlmZjVhYjZiODdlZjRjNDUxNTViNjc5YTRmZTk5NjRhNWVlNmRjNTI5YWExZWQ4MGI2MzUxY2Q1MCIsInNpZ25hdHVyZSI6IjB4OWYwNjE5Y2ZmMTJlOWI1MWJkMTg5NTA0YjdmMGY4Yjc3ODY0YjhjZTc5ZWU0MDEwZWRjZjRiZmM3ODg0ZWEzZWFlZTFmYjM0OWE4NGU2MGJlMGQ4ZTEwZGI0ZDE5OTNmMGZmY2RhMzFiZTY0MDIyZGE4MDcwMmZlNzY4YTljMTAiLCJzaWduaW5nS2V5Ijp7InB1YmxpY0tleSI6Ik1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRTBBRWNKbHgzdS8wTk9kUWxxWmN3UExwd0NRWkdMUUs0OEN0TzFmanFSMk8vRTdsQUE3RGNHcVNNQ2lJTlhkKzdIQ203dzUvZGl6T3ZoSmNZU0s5NENnPT0iLCJmb3JtYXQiOiJTdWJqZWN0UHVibGljS2V5SW5mbyIsImFsZ29yaXRobSI6IkVTMjU2In0sInNpZ25pbmdLZXlBdXRoIjp7ImFkZHJlc3MiOiIweGNmNDY0MGE1N2M1NzI3Y2U4MWE5ODg3NmMyMjE5Yjg0Mjk4ZTA5ODciLCJzaWduaW5nS2V5U2lnbmF0dXJlIjoiMHg1NTQ0NzkzZjU0Nzg4OTcxMTI3ZTI4Y2QzY2EyYjI3NTczOGQwNzZhYTIxZjQ3MmM4Y2E0NzMxNDQwYzdlYjkwMjljNjAzOWUyMTg4ZWE4NzQ3ZGE3MGJhOGRjNzQzZWQ4NjY1ZjNhN2YzZWY1MWIzYzZiNmU0MDYxMzQ1ZDc2NzFiIiwic2lnbmluZ0tleU1lc3NhZ2UiOiJJIGF1dGhvcml6ZSBDeWJlckNvbm5lY3QgZnJvbSB0aGlzIGRldmljZSB1c2luZyBzaWduaW5nIGtleTpcbk1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRTBBRWNKbHgzdS8wTk9kUWxxWmN3UExwd0NRWkdMUUs0OEN0TzFmanFSMk8vRTdsQUE3RGNHcVNNQ2lJTlhkKzdIQ203dzUvZGl6T3ZoSmNZU0s5NENnPT0ifX0BADnYqxaB1rm_Sszh4zu92BwhN-9msI6_sfUosEnCfA9hnpjr81Gi5C5JMoUZi9yath1Vf72Tw0Y2huq83wdPQ7DXm_6YfnP7KfOQ5XkQfcX81raV1fXz_Lq5PIFE5E2Cc1Omwt1eJ1eOHtQokVTS__OIm13ne00lRrw-LW3_iRWwNFSMobjBZE0gDORgxlDW43yN_QJKKl0VjXcvRbWrdp8LAEG40UjNIb_oXT7S_fxsPJbn_IPVHl_w2JkLMCWCXNoqEtb1av-xjuTyP-oRw5k5npr-HzE9AND1V9wIq41iiumKrQCyHyl3Oo_-rj5o705xSZxOrlCXBdqzOkv2Dgl7XFahrbnUV-RuHE9SBr7akzZBmeaCEBgW_UO6WoJxy3BsRf4aSfIM9dl4x5aiAJTkwMi2CYhfmrSL2-oVn9QdBiwj4LTFSKGlLxypDbW_k8DNlioWgb6FWEgdQtzh8kjlj-IlTOZGgbgJTy7tFkQXJ5nOuFORG8n_9eYWA-SyIm1l6P6v15MOB5wYyuc25YRV6MgVTvyxw-Y6TpOtT4S7gVe5IG0EnL_-Sr_uX35IBtU-vEVvFIezad4oRfax1PItdy76RSS4aMvIEPmTlwqK0m8SUbH4t_pn8eB3ngUruU9f4HmfGN2M60qbAzRCNsEWlveaknilVGPAUsJuSKJnnPgX7WyVoTnTxFtyMHzK_iyQ9jKTuTNvPZDvpKXyraIujN7xcC4NvJ3aJ8zssULFQNgqiC5cQ2opbFOhg0A7GLIBkXNwSVwD5BBfHHCsiV-mwjjqdujllzy-pR5BCvvV2FZ4PlVAgsxX8hCEQUNVpO5_gISSE_SeLuRWXlhdSRRI4dGFNWm7E75ZJzeOn_C5hZCuQjIdgS_a-O__5v2MqBQlKDUdtw54pXniUkZA4UhPXNgcGwVvdBDsybCJeM__akVDhDWrY6nqGOozHfrIUS1VR_Cdo4LP57DlSkPOwfb81MDBkYjzPu1HYNTLEUCcWiNtw0-YV7j4eDx_a5p6esNiIZInXK3DJGw2a4Na7e9FyRLWzSNPtd54Ys0qjcGYTVwJJvl4e6oE7bMPXKSptAieiO3jhCnDFROl4Wm3NX2a1IE4DZYfk1hRjhi47p9TgbZmBkw8_1y5runeAb4ZmOyO1jiOxQ6mQCBO-AQpooHnacNlQtghy05lRR5kqdJsDEcZZuSpp4nuQJT7fkBjmRObw1lOqnpyDBwrEFKQ_3ct12toPLKN6jfTdYU7naOY0xe9N_DuWrVlzWZDjvkuciLZ25P6VI4I4rrRbJuwVAk5RXBPV4RcXuH-8SZPluilQ6tfygLDEVQeF8ltlrRMxEmjoUN9GKkPjfmyZzselmkAAAcAAAAAAAAAEgEAAAAAAAANnAQYQ29udGVudC1UeXBlIGFwcGxpY2F0aW9uL2pzb24WQXBwbGljYXRpb24YQ3liZXJDb25uZWN0FENvbnRlbnQtSWSAAWE0MzI2ZGU4Y2EzOWY5Nzg1YThkNzczNjRkNDJiZjlmOGRlOTRmMWE3ZGZhZmFhYWFiMmY4NDQ3YTkwZTI0MWQcQ29udGVudC1EaWdlc3SAAWE0MzI2ZGU4Y2EzOWY5Nzg1YThkNzczNjRkNDJiZjlmOGRlOTRmMWE3ZGZhZmFhYWFiMmY4NDQ3YTkwZTI0MWQcQ29udGVudC1BdXRob3IkZGFyY2lhbWJlcnBmdGRjNGl0DkNoYWluSWQENTYMU291cmNlCGF0ZW0AeyJjb250ZW50Ijoie1wib3BcIjpcInBvc3RcIixcImFkZHJlc3NcIjpcIjB4NmE2MWFmNzc4OTYzODhkNDQ0ZDRlOTA0NjdkNmIxMDQxZDQ1NGVkMlwiLFwidHNcIjoxNjkxNDYwNjI1MzQ0LFwiY2hhaW5JZFwiOjU2LFwiaGFuZGxlXCI6XCJkYXJjaWFtYmVycGZ0ZGM0aXRcIixcInRpdGxlXCI6XCJUaGUgTWVtb2lycyBvZiBhIFJlbHVjdGFudCBTcHlcIixcImJvZHlcIjpcIlRoaXMgcG9zdCB3YXMgYSBncmVhdCByZWFkISBJIGFwcHJlY2lhdGUgdGhlIGVmZm9ydCB5b3UgcHV0IGludG8gaXQuXCJ9IiwiZGlnZXN0IjoiYTQzMjZkZThjYTM5Zjk3ODVhOGQ3NzM2NGQ0MmJmOWY4ZGU5NGYxYTdkZmFmYWFhYWIyZjg0NDdhOTBlMjQxZCIsInNpZ25hdHVyZSI6IjB4ZDcwMmM5Mjg1YzYyMWZkYjk2ZTE0YWMxMjc0MDAzYmJlZGM1ODZhYmNlODc3ZjU0MzE0ZmJlMDRlYjY5MzZjZGE5NDljYjM5NDNkZDgwMDdiZmY1ZDIzMTY4MmNjZTkxNGFhZWM2N2RkOTUwOTcxZjFmNTU0YTM0N2Y5NDcyNWQiLCJzaWduaW5nS2V5Ijp7InB1YmxpY0tleSI6Ik1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRVFsWFFtSGZLNU8rbDZkRGNsYWdoOHBvMDdnajFVRFdocTJjTk5ja21mY2hoeVBkSkFHYTZ1Z1pXRTFXcmZnRUR2R1p3bG5zcFRXYTNUcGpmVENkRlN3PT0iLCJmb3JtYXQiOiJTdWJqZWN0UHVibGljS2V5SW5mbyIsImFsZ29yaXRobSI6IkVTMjU2In0sInNpZ25pbmdLZXlBdXRoIjp7ImFkZHJlc3MiOiIweDZhNjFhZjc3ODk2Mzg4ZDQ0NGQ0ZTkwNDY3ZDZiMTA0MWQ0NTRlZDIiLCJzaWduaW5nS2V5U2lnbmF0dXJlIjoiMHgzMzk3MDJiZGM4ZTdjMTY1M2VlZWE0ODk0NzMzNDdhNzg3MzViYjQzNjM5NTFmMTYyMmY1ZTAxZTUwY2NiNzllMjUzN2QwMDVlMjMxMjI0ODNmNWUxYzA4ZTUxOTNjMDkyYjJmM2NkOWE5MWUyMGFmY2ZmYjU2Mzg4OTQ2MWFkYTFiIiwic2lnbmluZ0tleU1lc3NhZ2UiOiJJIGF1dGhvcml6ZSBBdGVtUmV2aWV3IGZyb20gdGhpcyBkZXZpY2UgdXNpbmcgc2lnbmluZyBrZXk6XG5NRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUVRbFhRbUhmSzVPK2w2ZERjbGFnaDhwbzA3Z2oxVURXaHEyY05OY2ttZmNoaHlQZEpBR2E2dWdaV0UxV3JmZ0VEdkdad2xuc3BUV2EzVHBqZlRDZEZTdz09In19AQCHPMikfO8Yby2Og-Xzj6XEFbdl_jRLlmwU99wXcrI3yuiK7v70lpQGMprWhY4d4vF3RlKI7sMToEEVFlsmg9MsRx43g06dC8r-ZCE3m018Qtw4kU8yld5dVIj5IUlcexd2MtkFt4JnJNuKMNPD0vQCaCIyjHZW4z1yW74idHvTgTAAdUWsUKgqpMGFUKsejb41_QVfgqFHRmIum6tbMvzehKkqYCTbLPwN20-NjLpoUCgSdYY8YZTzevuG3llQikc99RqfAl149ODHGfzv9GIIhiQyHGZzxh873PT1u61N5AvmrEt8v6prmJZn_UhGGx-nHpVEH2zAqHILtW-2tBoSskQjNCgrhhB0Gy6fSsBQbjlkCYRm8lxoDFIBHDc6yEELuQHieepUTY8RPyFYhZwM_nHzJsV6trbV62433wCJ5P88cdcjxr5vPvq1bFOxlDMH8fP3fGs06ycdea9wD1Iy1q2cRxVqmK_X5YPY-PhB__5E_A7-7OTRYCkovPEzSKHkhPrzZP-sUaku320vQsDxl1s1-Eg8-8eqYRUiQOwRLm9bpaMKOzqS70I_gBCt9xDULQeZj0gujgqrJoFOfZRkFa3KQIEyiHqtV-R3l_YVS4LFkWAXWocXLlwVnmgMi6RRV6BW0eDeGFa0NxFdSAM5zym35nibQAO88qYsl4WlcZz4F-1slaE508RbcjB8yv4skPYyk7kzbz2Q76Sl8q2iLoze8XAuDbyd2ifM7LFCxUDYKoguXENqKWxToYNAOxiyAZFzcElcA-QQXxxwrIlfpsI46nbo5Zc8vqUeQQr71dhWeD5VQILMV_IQhEFDVaTuf4CEkhP0ni7kVl5YXUkUSOHRhTVpuxO-WSc3jp_wuYWQrkIyHYEv2vjv_-b9jKgUJSg1HbcOeKV54lJGQOFIT1zYHBsFb3QQ7MmwiXjP_2pFQ4Q1q2Op6hjqMx36yFEtVUfwnaOCz-ew5UpDzsH2_NTAwZGI8z7tR2DUyxFAnFojbcNPmFe4-Hg8f2uaenrDYiGSJ1ytwyRsNmuDWu3vRckS1s0jT7XeeGLNKo3BmE1cCSb5eHuqBO2zD1ykqbQInojt44QpwxUTpeFptzV9mtSBOA2WH5NYUY4YuO6fU4G2ZgZMPP9cua7p3gG-GZjsjtY4jsUOpkAgTvgEKaKB52nDZULYIctOZUUeZKnSbAxHGWbkqaeJ7kCU-35AY5kTm8NZTqp6cgwcKxBSkP93LddraDyyjeo303WFO52jmNMXvTfw7lq1Zc1mQ475LnIi2duT-lSOCOK60WybsFQJOUVwT1eEXF7h_vEmT5bopUOrX8oCwxFUHhfJbZa0TMRJo6FDfRipD435smc7HpZpAAAHAAAAAAAAAAwBAAAAAAAADZAEGENvbnRlbnQtVHlwZSBhcHBsaWNhdGlvbi9qc29uFkFwcGxpY2F0aW9uGEN5YmVyQ29ubmVjdBxDb250ZW50LURpZ2VzdIABMjhiZjU3NWU4YTQxYmRjYmQxN2E1NGVmZGU0ODQ2MTUwODQyZTFkYjExNjNhZTJjZTkyNzAzMDU5YTc2ZTNkNxxDb250ZW50LUF1dGhvchhlZm9qdXl5NGF2NncOQ2hhaW5JZAQ1NgxTb3VyY2UIYXRlbRRDb250ZW50LUlkgAEyOGJmNTc1ZThhNDFiZGNiZDE3YTU0ZWZkZTQ4NDYxNTA4NDJlMWRiMTE2M2FlMmNlOTI3MDMwNTlhNzZlM2Q3AHsiY29udGVudCI6IntcIm9wXCI6XCJwb3N0XCIsXCJhZGRyZXNzXCI6XCIweDNhMDA2NWVhMjU3MDYzMDY5NTI5MjU2MjkyZDE5NDQ2YjA1MjY0ODBcIixcInRzXCI6MTY5MTQ2MDYyNDQ1NCxcImNoYWluSWRcIjo1NixcImhhbmRsZVwiOlwiZWZvanV5eTRhdjZ3XCIsXCJ0aXRsZVwiOlwiMTExMTJcIixcImJvZHlcIjpcIjIyMjIyMjIyMjIyMjIyMjIyMlwifSIsImRpZ2VzdCI6IjI4YmY1NzVlOGE0MWJkY2JkMTdhNTRlZmRlNDg0NjE1MDg0MmUxZGIxMTYzYWUyY2U5MjcwMzA1OWE3NmUzZDciLCJzaWduYXR1cmUiOiIweDE0NGM0OGQ4YjBlMWQyZWEwNDdkN2E4YTExOTRjZTBiNDlhNWU0Mzk2NTU0ZTVlOTFhYjZiOTY3NTNiNGZiNTExMjY5NjJhZDc0Y2RjOGQyNzdiOGQxMmNlM2I4ZWQ2ZGUyODYzODMyM2QxNTViODkzZTA0NjkzZDk0MzgwYzRlIiwic2lnbmluZ0tleSI6eyJwdWJsaWNLZXkiOiJNRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUVzZVp4Rnlkd2tOOVFOOEI0T3E3Ump1aUhRWnc3R1ZiYWIzcjh3ZWlwU1hrUXkrTDVwTm5KMXgwbEExS25RWGExb3NhNDVNRzMxVXYzclBldlF1Y1VLZz09IiwiZm9ybWF0IjoiU3ViamVjdFB1YmxpY0tleUluZm8iLCJhbGdvcml0aG0iOiJFUzI1NiJ9LCJzaWduaW5nS2V5QXV0aCI6eyJhZGRyZXNzIjoiMHgzYTAwNjVlYTI1NzA2MzA2OTUyOTI1NjI5MmQxOTQ0NmIwNTI2NDgwIiwic2lnbmluZ0tleVNpZ25hdHVyZSI6IjB4YzhlMDFiMjcwNWVkNTM4MjAwNTRjYjlhZGFhMGE1N2VhZjk3NmJlMjIwNDNkZmE5YmEyMWFjMjczMjg1MmFhYTY3ZDYwNGIzMmE0OThkOWQ1NDg2Y2JhMjllZjE4ZWFlYjMyYmQ3ZjFlZmEzOTg1ODRlOThkZjI4YTA5NDQ0OWExYiIsInNpZ25pbmdLZXlNZXNzYWdlIjoiSSBhdXRob3JpemUgQXRlbVJldmlldyBmcm9tIHRoaXMgZGV2aWNlIHVzaW5nIHNpZ25pbmcga2V5OlxuTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFc2VaeEZ5ZHdrTjlRTjhCNE9xN1JqdWlIUVp3N0dWYmFiM3I4d2VpcFNYa1F5K0w1cE5uSjF4MGxBMUtuUVhhMW9zYTQ1TUczMVV2M3JQZXZRdWNVS2c9PSJ9fQEAWWXuHeBgyqNLL1XKiT35u5qGkKSggiQgkqe1j92w802RFG8OUjTx_ST6YfubfF8E23Y1rZHtzgEjRIrTep9Ju0kvQ52o0GQrzIdyGGPqrz240G5MAn-tUR1BEZSM6pa7AqXVyt8OJU5zFHTYxLmGeCiv1UXJeWAZr-o-PokyDe0-c3XKcjQ6dvntr2Z8tSNSbYpbx8pd32QZxXQEHCqC7QQ1wuSFN0kX-TsNFamUkk6NcPbPds6WgIUNNi22G64Dw2Fsmq40g4RdviUglxrfGSPq2xprPKCvN8Rtnji8Ja1hXl_PNhskd0L-jBp_XtTLgHvET6tjieAfOAd3fYQh0LqFlqanl6NzqdkK50wkiDdUJIFdJNmbVoby_0FnyFyWkoPD0ixSvcK9bQjTiXSlTtWfoYv9kpWx7iGKEhOpO4N7uHm9qQVILR2e7ProiFubEiyl3aV70OQA7rE2kYBcw31apWoA_07gYmawaenCxUINXcbz_u003MKpRKc05D37QBQYHlYXkmWsmOWsB2BAAtdp1tpQOEYixP_0GeU8uIibmv39_ur3nyYrbU_86QPouJXuDmnRnshdb1O1gEq7PFTuJCWW3p4HRJg7SMaG2CxlAssw3FexhoBs-S0Su9-JTOYVhtB3ZfeP2qKdfbCPH8Y3Iy7S3ctSadMDw_WJWNKc-BftbJWhOdPEW3IwfMr-LJD2MpO5M289kO-kpfKtoi6M3vFwLg28ndonzOyxQsVA2CqILlxDailsU6GDQDsYsgGRc3BJXAPkEF8ccKyJX6bCOOp26OWXPL6lHkEK-9XYVng-VUCCzFfyEIRBQ1Wk7n-AhJIT9J4u5FZeWF1JFEjh0YU1absTvlknN46f8LmFkK5CMh2BL9r47__m_YyoFCUoNR23DnileeJSRkDhSE9c2BwbBW90EOzJsIl4z_9qRUOENatjqeoY6jMd-shRLVVH8J2jgs_nsOVKQ87B9vzUwMGRiPM-7Udg1MsRQJxaI23DT5hXuPh4PH9rmnp6w2IhkidcrcMkbDZrg1rt70XJEtbNI0-13nhizSqNwZhNXAkm-Xh7qgTtsw9cpKm0CJ6I7eOEKcMVE6Xhabc1fZrUgTgNlh-TWFGOGLjun1OBtmYGTDz_XLmu6d4BvhmY7I7WOI7FDqZAIE74BCmigedpw2VC2CHLTmVFHmSp0mwMRxlm5Kmnie5AlPt-QGOZE5vDWU6qenIMHCsQUpD_dy3Xa2g8so3qN9N1hTudo5jTF7038O5atWXNZkOO-S5yItnbk_pUjgjiutFsm7BUCTlFcE9XhFxe4f7xJk-W6KVDq1_KAsMRVB4XyW2WtEzESaOhQ30YqQ-N-bJnOx6WaQAACAAAAAAAAACCAQAAAAAAAA_8BRhDb250ZW50LVR5cGUgYXBwbGljYXRpb24vanNvbhZBcHBsaWNhdGlvbhhDeWJlckNvbm5lY3QcQ29udGVudC1EaWdlc3SAAWRjNjM4NjgwZTE0ZTcxNGM2NjM1MDk3OGI2Zjc0YzJkMmI4ZTQwNDU4YjkzYzMxYTFkZWQyMWMzNjNhOWIzMTYcQ29udGVudC1BdXRob3IiYWRnbXRxcG1vaXVjc2h0NzMOQ2hhaW5JZAQ1NhxDb250ZW50LVRhcmdldIABMzlmMDIxODgxZTczODZmOGQ3M2Q2ZWYyNTUzM2U2MDkxZjJhMDI1NmU0MjJiNGIzYzRlM2QzMzVjY2FlMTQ3ZQxTb3VyY2VIMTU1MzFmYTItMTIwNS00ZjYxLWI2ZTQtYzlmNjhlY2Y4MWY3FENvbnRlbnQtSWSAAWRjNjM4NjgwZTE0ZTcxNGM2NjM1MDk3OGI2Zjc0YzJkMmI4ZTQwNDU4YjkzYzMxYTFkZWQyMWMzNjNhOWIzMTYAeyJjb250ZW50Ijoie1wib3BcIjpcImNvbW1lbnRcIixcImFkZHJlc3NcIjpcIjB4YzNkMDczYzI0NTZhMWJmNTc5ZjAyOTAyZWY0YzgyNDQ4MDhhNzc0MlwiLFwidHNcIjoxNjkxNDYwNjI1NjQ1LFwiY2hhaW5JZFwiOjU2LFwiaGFuZGxlXCI6XCJhZGdtdHFwbW9pdWNzaHQ3M1wiLFwidGFyZ2V0XCI6XCIzOWYwMjE4ODFlNzM4NmY4ZDczZDZlZjI1NTMzZTYwOTFmMmEwMjU2ZTQyMmI0YjNjNGUzZDMzNWNjYWUxNDdlXCIsXCJ0aXRsZVwiOlwiRmxhcHB5TW9vbmJpcmRcIixcImJvZHlcIjpcIldvbnQgYmxpbmsgd2hpbGUgcGxheWluZyBoYWhhaGFcIn0iLCJkaWdlc3QiOiJkYzYzODY4MGUxNGU3MTRjNjYzNTA5NzhiNmY3NGMyZDJiOGU0MDQ1OGI5M2MzMWExZGVkMjFjMzYzYTliMzE2Iiwic2lnbmF0dXJlIjoiMHgzMjlkNjM0ODg4ODljMDhkZmMxMjJhMjlkM2Y2NTQ4MjdiMzExMjhhZWZlNjY3NzZkYzU5Mzg4OTJlY2UzMTJjNDlmZTRiMjFiMjdmMTFlNDdmZDU2MGZhMTA0MzQ3ZTgzYTRhNjYyNTNiMTI1NTFkYTY5OGVkZTU2YmExYmVmZSIsInNpZ25pbmdLZXkiOnsicHVibGljS2V5IjoiTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFZzZFelhDUjVKZzVJV05OTnhrZ1piMks3cTQ2YzZvRndnOHJCb0Z6S0FPekhoWFUvYlQ3L04xL3FPL2dLQkg5NU9TR3F6UFdWVWNsby9ISnJEUUgwK1E9PSIsImZvcm1hdCI6IlN1YmplY3RQdWJsaWNLZXlJbmZvIiwiYWxnb3JpdGhtIjoiRVMyNTYifSwic2lnbmluZ0tleUF1dGgiOnsiYWRkcmVzcyI6IjB4YzNkMDczYzI0NTZhMWJmNTc5ZjAyOTAyZWY0YzgyNDQ4MDhhNzc0MiIsInNpZ25pbmdLZXlTaWduYXR1cmUiOiIweDEyNmRlNmE0MTJhMDgxNTU1ZDU3MTNmN2RkYmZiN2U2NTYzNTExNTQ2NzE5MzhjYTkzYzYyYTcyMTY4YWIwMGQwZjFhMDZlYjNmNmNmNDE5OTIyNTg5OGUyODJlMzYzOWE0MmQ1ZDAwYTkwZDljODg0Zjg5MzQ5MDkzZDZmYzE1MWIiLCJzaWduaW5nS2V5TWVzc2FnZSI6IkkgYXV0aG9yaXplIEN5YmVyQ29ubmVjdCBmcm9tIHRoaXMgZGV2aWNlIHVzaW5nIHNpZ25pbmcga2V5OlxuTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFZzZFelhDUjVKZzVJV05OTnhrZ1piMks3cTQ2YzZvRndnOHJCb0Z6S0FPekhoWFUvYlQ3L04xL3FPL2dLQkg5NU9TR3F6UFdWVWNsby9ISnJEUUgwK1E9PSJ9fQEAI-gvC4U3JMxA6Mg2xTs3oAuPx1nfChQvPt6xrxFiKPPMUXhSziDAsB1OfdKFOq9YXGghXVhoRqAELh_PTZj0_MjWvEcF0RZ-gB4eSawzt3u3DzEHlL1g6B8P1Ilml2l-1hj2NE1Ycn-2_zET2LoUSEPPokO7uIWbFPnI6Tkt3pP7J_CA3R_3xcJW1_8iXNSxIrwFFjIEdv34Ti80rI-6QwXIbkfgSNj-LAmsEWKp-zgwx52OOp5RkCQal9SXBIfhnbFlGfd5CfmxpXjQVfS3G5wfwvK-vPFLFQh1js4uU84A7zfAGBYV2OSUUU-vWldmvskxs2kLtZWoHQthCMphE4KlHQKKnjlZaprsbVx8-Lbv5p7t-6eNmlAM1MsFJ2HwXkBF_GtrKdd9DjeoCvoyws2nEEwCC8Ux_cB-4VRgM1DcpZSsqtzp5HmZkt3VxLzQCB_DU5BYhoqtHwOfpqudBXdU-wJnrM5kkOosM4ibN-Ai22UiFDWEACOxMUR7rvOahvCdotYBFVayVQiyGUpXISmqg5hMIvXURAmNYlSIgoiyeUYFp3C5vAmIKPHcqzUyvm28xookr7fZbKkck8Bz-Kuy5KvRdBtDXjmBPma_voiGVW9d44g8deOLQy6JZKd5P953uOxOXspxR27xR8Q3ShVKz9ohOStMQjvngMYcJYCc-BftbJWhOdPEW3IwfMr-LJD2MpO5M289kO-kpfKtoi6M3vFwLg28ndonzOyxQsVA2CqILlxDailsU6GDQDsYsgGRc3BJXAPkEF8ccKyJX6bCOOp26OWXPL6lHkEK-9XYVng-VUCCzFfyEIRBQ1Wk7n-AhJIT9J4u5FZeWF1JFEjh0YU1absTvlknN46f8LmFkK5CMh2BL9r47__m_YyoFCUoNR23DnileeJSRkDhSE9c2BwbBW90EOzJsIl4z_9qRUOENatjqeoY6jMd-shRLVVH8J2jgs_nsOVKQ87B9vzUwMGRiPM-7Udg1MsRQJxaI23DT5hXuPh4PH9rmnp6w2IhkidcrcMkbDZrg1rt70XJEtbNI0-13nhizSqNwZhNXAkm-Xh7qgTtsw9cpKm0CJ6I7eOEKcMVE6Xhabc1fZrUgTgNlh-TWFGOGLjun1OBtmYGTDz_XLmu6d4BvhmY7I7WOI7FDqZAIE74BCmigedpw2VC2CHLTmVFHmSp0mwMRxlm5Kmnie5AlPt-QGOZE5vDWU6qenIMHCsQUpD_dy3Xa2g8so3qN9N1hTudo5jTF7038O5atWXNZkOO-S5yItnbk_pUjgjiutFsm7BUCTlFcE9XhFxe4f7xJk-W6KVDq1_KAsMRVB4XyW2WtEzESaOhQ30YqQ-N-bJnOx6WaQAABwAAAAAAAAAMAQAAAAAAAA2QBBhDb250ZW50LVR5cGUgYXBwbGljYXRpb24vanNvbhZBcHBsaWNhdGlvbhhDeWJlckNvbm5lY3QUQ29udGVudC1JZIABZjFkMmQ1NzJkZGRlZjNjYzRlZDNkZWI3MzY0MmE2YmMzOTBiOGVmNTJkMWQ3YjViNzc2MWMxYWI0MjFmZTIzMhxDb250ZW50LURpZ2VzdIABZjFkMmQ1NzJkZGRlZjNjYzRlZDNkZWI3MzY0MmE2YmMzOTBiOGVmNTJkMWQ3YjViNzc2MWMxYWI0MjFmZTIzMhxDb250ZW50LUF1dGhvchhrNjI5NzI3MTI5OHEOQ2hhaW5JZAQ1NgxTb3VyY2UIYXRlbQB7ImNvbnRlbnQiOiJ7XCJvcFwiOlwicG9zdFwiLFwiYWRkcmVzc1wiOlwiMHg4ZDJhMzU2MWQ5OGNkMGJmYzUwNDY0NjQzNGY3OWJmMzM1NDRmOGQzXCIsXCJ0c1wiOjE2OTE0NjA2MjUxMDQsXCJjaGFpbklkXCI6NTYsXCJoYW5kbGVcIjpcIms2Mjk3MjcxMjk4cVwiLFwidGl0bGVcIjpcIjExMTEyXCIsXCJib2R5XCI6XCIyMjIyMjIyMjIyMjIyMjIyMjJcIn0iLCJkaWdlc3QiOiJmMWQyZDU3MmRkZGVmM2NjNGVkM2RlYjczNjQyYTZiYzM5MGI4ZWY1MmQxZDdiNWI3NzYxYzFhYjQyMWZlMjMyIiwic2lnbmF0dXJlIjoiMHhjNDZkZGE2ZWQ1ZTk0OTI5Y2E0NWExYWU0MGFmY2YzMTFmYzQyOWViOTQ3OGNmNzBmMTBkMTAzZWMyODgxNTFjMmJkNzllNzgwNjBlMDZmMGY3MDlhNmQyY2E4YTBmYmEwY2ViMWNiYjVmNmFlOTY3YzE1ZDJhNWQ5NDNhYmZlNyIsInNpZ25pbmdLZXkiOnsicHVibGljS2V5IjoiTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFRm1nRDNhT1dCbmVUNXh6bHJVcGxQQ1lsSHhvdnhUc0MrSk9UNDErWWVSeHZya2lrcEZWck9mb25WQUFXbyt1T1cxNDBTemdEWFhjUjM3NStLRHhuV1E9PSIsImZvcm1hdCI6IlN1YmplY3RQdWJsaWNLZXlJbmZvIiwiYWxnb3JpdGhtIjoiRVMyNTYifSwic2lnbmluZ0tleUF1dGgiOnsiYWRkcmVzcyI6IjB4OGQyYTM1NjFkOThjZDBiZmM1MDQ2NDY0MzRmNzliZjMzNTQ0ZjhkMyIsInNpZ25pbmdLZXlTaWduYXR1cmUiOiIweDNlYmU4NWJjZDY5YTc1M2RiMDdmYzdkMTQ3MmI5YzQ4OTY1ZmE1YzEyODI0MTlhZDMzMjJhZWJjYjc1ZmExMDU0ZDBlMjljODU5MzMwMDMyZDYzMDhiM2M5YmEwODFhYWQxOWUwZmJlYmU4YTFkYjczYjk3ZGNhMWI2Njg2NGQ1MWMiLCJzaWduaW5nS2V5TWVzc2FnZSI6IkkgYXV0aG9yaXplIEF0ZW1SZXZpZXcgZnJvbSB0aGlzIGRldmljZSB1c2luZyBzaWduaW5nIGtleTpcbk1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRUZtZ0QzYU9XQm5lVDV4emxyVXBsUENZbEh4b3Z4VHNDK0pPVDQxK1llUnh2cmtpa3BGVnJPZm9uVkFBV28rdU9XMTQwU3pnRFhYY1IzNzUrS0R4bldRPT0ifX0BAIPqwBXWj3YR0HZqZCbrsjzIsLo57TYIStspGZ0AJHAGOCa5A_xrd-nk33NOT4lKButT8bfyNynEfsSBkEsIK1XGKGi9CvVPKuCu7ZpBoIORLYwyM-YvJBwuiLyVaixmVGEZAYhSsiOUjHbMwJATccLKSUrmqz7UX_tVe5DwLqeBgd-UDT9sy8RjTmFsU4fMVgZoyj8k0OpXBy1iJHmJGOuW2LoMe5rr3OUVXucaXjFLXuo4A5bEbldbd3hotfhMiPu_3gB75zsbVm8T4c-J4g-x8b2XUT-in8tsX7jRQ1TS53quXio8zBmGcspuY8ohm-E7S6L93FTmf1P3Qr0n4qL_Vkw7KFExou9PyeYOMpVVBjjN8xDLm8FdM45BbKjChvI_pi8DOmLV2WjtV3qDBC45WSLYLOHY_LmOc1X5zbgcAAVhhr9rd4jp7pb0-1lFZSO2T29UXuQ3uTwTbEKIQPJ_m2B2YsFoDS6nGmNLk70AHo77DQCj2WPeijOxxkTNfwHT_aIPwVVwU7h96vxIeXO9jjwfB69Pn-RnC59tFEMi-6T0e9zpo6l0Hez3Hdi_XjaehYu-FjQChkoERvP95CNikjx5QEFV2g7Y12M1Iftk-630krEu-GswmXPyw3OxgMcnN1-iDjxOuu8ZPDmx2FnE7xUKZ_Y--l8ZNIcyOf74nPgX7WyVoTnTxFtyMHzK_iyQ9jKTuTNvPZDvpKXyraIujN7xcC4NvJ3aJ8zssULFQNgqiC5cQ2opbFOhg0A7GLIBkXNwSVwD5BBfHHCsiV-mwjjqdujllzy-pR5BCvvV2FZ4PlVAgsxX8hCEQUNVpO5_gISSE_SeLuRWXlhdSRRI4dGFNWm7E75ZJzeOn_C5hZCuQjIdgS_a-O__5v2MqBQlKDUdtw54pXniUkZA4UhPXNgcGwVvdBDsybCJeM__akVDhDWrY6nqGOozHfrIUS1VR_Cdo4LP57DlSkPOwfb81MDBkYjzPu1HYNTLEUCcWiNtw0-YV7j4eDx_a5p6esNiIZInXK3DJGw2a4Na7e9FyRLWzSNPtd54Ys0qjcGYTVwJJvl4e6oE7bMPXKSptAieiO3jhCnDFROl4Wm3NX2a1IE4DZYfk1hRjhi47p9TgbZmBkw8_1y5runeAb4ZmOyO1jiOxQ6mQCBO-AQpooHnacNlQtghy05lRR5kqdJsDEcZZuSpp4nuQJT7fkBjmRObw1lOqnpyDBwrEFKQ_3ct12toPLKN6jfTdYU7naOY0xe9N_DuWrVlzWZDjvkuciLZ25P6VI4I4rrRbJuwVAk5RXBPV4RcXuH-8SZPluilQ6tfygLDEVQeF8ltlrRMxEmjoUN9GKkPjfmyZzselmkAAAgAAAAAAAAAfQEAAAAAAAAP8gUYQ29udGVudC1UeXBlIGFwcGxpY2F0aW9uL2pzb24WQXBwbGljYXRpb24YQ3liZXJDb25uZWN0HENvbnRlbnQtVGFyZ2V0gAEzOWYwMjE4ODFlNzM4NmY4ZDczZDZlZjI1NTMzZTYwOTFmMmEwMjU2ZTQyMmI0YjNjNGUzZDMzNWNjYWUxNDdlDFNvdXJjZUgxNTUzMWZhMi0xMjA1LTRmNjEtYjZlNC1jOWY2OGVjZjgxZjcUQ29udGVudC1JZIABN2FmZmViZjg3M2E5NzUyYWY5ODYxMDVhYjE0MmE4ZWJiZTZkODIzMGM3YjMzYjAxNjFlNzdhMjVmOWNiZGRlZRxDb250ZW50LURpZ2VzdIABN2FmZmViZjg3M2E5NzUyYWY5ODYxMDVhYjE0MmE4ZWJiZTZkODIzMGM3YjMzYjAxNjFlNzdhMjVmOWNiZGRlZRxDb250ZW50LUF1dGhvchhya3pjaWhkdXJoeWwOQ2hhaW5JZAQ1NgB7ImNvbnRlbnQiOiJ7XCJvcFwiOlwiY29tbWVudFwiLFwiYWRkcmVzc1wiOlwiMHhlOTg0NjE1ODI2ZmNjMmEwY2IxODJlZjE5OWQ5OGZiOTU4MDMzOTEzXCIsXCJ0c1wiOjE2OTE0NjA2MjQ5MzEsXCJjaGFpbklkXCI6NTYsXCJoYW5kbGVcIjpcInJremNpaGR1cmh5bFwiLFwidGFyZ2V0XCI6XCIzOWYwMjE4ODFlNzM4NmY4ZDczZDZlZjI1NTMzZTYwOTFmMmEwMjU2ZTQyMmI0YjNjNGUzZDMzNWNjYWUxNDdlXCIsXCJ0aXRsZVwiOlwiRmxhcHB5TW9vbmJpcmRcIixcImJvZHlcIjpcIlNvIGZ1biB0byBwbGF5IGluIG15IHNwYXJlIHRpbWUuXCJ9IiwiZGlnZXN0IjoiN2FmZmViZjg3M2E5NzUyYWY5ODYxMDVhYjE0MmE4ZWJiZTZkODIzMGM3YjMzYjAxNjFlNzdhMjVmOWNiZGRlZSIsInNpZ25hdHVyZSI6IjB4MWE4OGQ3OTAwMjRmNDQ3YTFhNjkzZjNiZWFlNTViMTVjOWI1ZTQ3YzIwMDljMTYwNDdlYmNiMmUxOTQ4ZGVjMWVlYWRmODUzNmM3ZDJmNzk1NzQ3MzA0N2ZkZGZmMWI2OTJkYTQ1YjM5NjVjMTM4OTE0YjJjY2NmYWE2NzhlODQiLCJzaWduaW5nS2V5Ijp7InB1YmxpY0tleSI6Ik1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRVV1MDNFVmJnVkRZdGRZYmxZeHY3NHNxMXpqZTZQTXdUQkxSK1ErckJDWURNb0t1TlFXR2FtdjkxdHdGWUx6VUxBT2pMUmxTOTlQYXlqM3J1RmFqVmdBPT0iLCJmb3JtYXQiOiJTdWJqZWN0UHVibGljS2V5SW5mbyIsImFsZ29yaXRobSI6IkVTMjU2In0sInNpZ25pbmdLZXlBdXRoIjp7ImFkZHJlc3MiOiIweGU5ODQ2MTU4MjZmY2MyYTBjYjE4MmVmMTk5ZDk4ZmI5NTgwMzM5MTMiLCJzaWduaW5nS2V5U2lnbmF0dXJlIjoiMHg2MTFiYjRlMzIzOGRhYTQ5ZTgyNzQ3NjM1MjQzZjhmMWY2ZjkyYTZjODI0MTI1MTFjNjg5YzhiMjhiMTllODBiMDFjN2Q1OWMyOWY5MDMyYjYxODlhZjc4OTk4NzdhYmE5YzQwNjk0OWQwNzc2NjQ1ZWJkNzc5NDdmYzNjYmY4MjFjIiwic2lnbmluZ0tleU1lc3NhZ2UiOiJJIGF1dGhvcml6ZSBDeWJlckNvbm5lY3QgZnJvbSB0aGlzIGRldmljZSB1c2luZyBzaWduaW5nIGtleTpcbk1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRVV1MDNFVmJnVkRZdGRZYmxZeHY3NHNxMXpqZTZQTXdUQkxSK1ErckJDWURNb0t1TlFXR2FtdjkxdHdGWUx6VUxBT2pMUmxTOTlQYXlqM3J1RmFqVmdBPT0ifX0BAAf3gikvLrCOlnI0HMhzN4uSuS6LKsTTDSROVpUFVR-P97E3EAoB-6G9qKq5ksGmj0kWARn8I-Tih6SYcAy5sfVghMGKcXhjCyCTAUbu9oxl_xYE8cVzGwwNwjEAp52k_SWG6p1IJtmWkStZsxlCUIZCBW9g-iJvT1ctKeZSIXRwP6HiiaZskZqgqoypw-0KVdOdf2PKfQooVmblB8jfyZjBbnE62NpJCbbWbWVoQcyRsgfjGV84bD2Y07fZlh1S0gJYdbh7doc19wa7MtWSL0nwVHTqP-R5y2qTwnfmMIHoiSgPYbl-Ivfxkng9vFe8LXsQcWOoJtmhMqDzTKlVUqxjie_CoXnLoaKyrqdT9JTBaRRawrsWU8EjNn_5L6ryo__LZVC6mwSOLFTlmTsqM048yAknAgypkdziSJC5Bpq1NjyMDksYizY5GsoLf7WELkTLctzU99a0hc6VYmcU203jHx2MuelIgRLHEqkE3K9YsxCxWaSOiIHdekoYILtZJOFQHMDa3ujP_aM1dKHXHDX1yLDp7GmFHJrzKK5Pc8zxbxr2m5VXm4W3nUI0I0MHqrd-zJFOHBIQV2JsOapzD9QFgjn3iHvQJXemZWVt2gqDOzlr-K-pT3RfM2hTvctx6JHG9ElANt_N94jHU9hgTjeORvQfpnhzfZrxZtv5gu5NnPgX7WyVoTnTxFtyMHzK_iyQ9jKTuTNvPZDvpKXyraIujN7xcC4NvJ3aJ8zssULFQNgqiC5cQ2opbFOhg0A7GLIBkXNwSVwD5BBfHHCsiV-mwjjqdujllzy-pR5BCvvV2FZ4PlVAgsxX8hCEQUNVpO5_gISSE_SeLuRWXlhdSRRI4dGFNWm7E75ZJzeOn_C5hZCuQjIdgS_a-O__5v2MqBQlKDUdtw54pXniUkZA4UhPXNgcGwVvdBDsybCJeM__akVDhDWrY6nqGOozHfrIUS1VR_Cdo4LP57DlSkPOwfb81MDBkYjzPu1HYNTLEUCcWiNtw0-YV7j4eDx_a5p6esNiIZInXK3DJGw2a4Na7e9FyRLWzSNPtd54Ys0qjcGYTVwJJvl4e6oE7bMPXKSptAieiO3jhCnDFROl4Wm3NX2a1IE4DZYfk1hRjhi47p9TgbZmBkw8_1y5runeAb4ZmOyO1jiOxQ6mQCBO-AQpooHnacNlQtghy05lRR5kqdJsDEcZZuSpp4nuQJT7fkBjmRObw1lOqnpyDBwrEFKQ_3ct12toPLKN6jfTdYU7naOY0xe9N_DuWrVlzWZDjvkuciLZ25P6VI4I4rrRbJuwVAk5RXBPV4RcXuH-8SZPluilQ6tfygLDEVQeF8ltlrRMxEmjoUN9GKkPjfmyZzselmkAAAcAAAAAAAAADAEAAAAAAAANkAQYQ29udGVudC1UeXBlIGFwcGxpY2F0aW9uL2pzb24WQXBwbGljYXRpb24YQ3liZXJDb25uZWN0FENvbnRlbnQtSWSAAWEwMTBjODJlZGU2OTliZjFkZDIwMWQ3YjU0ZTZmYjQ5Y2Y4OTJmOTljMTRmNjMzZTM3ZTY3YzRhY2FiYjk4M2McQ29udGVudC1EaWdlc3SAAWEwMTBjODJlZGU2OTliZjFkZDIwMWQ3YjU0ZTZmYjQ5Y2Y4OTJmOTljMTRmNjMzZTM3ZTY3YzRhY2FiYjk4M2McQ29udGVudC1BdXRob3IYN3dtYXBucTBuMTRsDkNoYWluSWQENTYMU291cmNlCGF0ZW0AeyJjb250ZW50Ijoie1wib3BcIjpcInBvc3RcIixcImFkZHJlc3NcIjpcIjB4ZDRhOTgwOTgyMTEyZjQ0NmE1YzI4MDc4YjBjYmVmYTM0YTZkZTY5ZVwiLFwidHNcIjoxNjkxNDYwNjI0NzE5LFwiY2hhaW5JZFwiOjU2LFwiaGFuZGxlXCI6XCI3d21hcG5xMG4xNGxcIixcInRpdGxlXCI6XCIxMTExMlwiLFwiYm9keVwiOlwiMjIyMjIyMjIyMjIyMjIyMjIyXCJ9IiwiZGlnZXN0IjoiYTAxMGM4MmVkZTY5OWJmMWRkMjAxZDdiNTRlNmZiNDljZjg5MmY5OWMxNGY2MzNlMzdlNjdjNGFjYWJiOTgzYyIsInNpZ25hdHVyZSI6IjB4NDllYTU3NmJhYzViNTc4ZmE0MWZlODY4N2ViZTlkYjY0ZjY2N2Q1YTNlY2M4ZmQ2NThkNjlmM2ZiMzExYzlmODE0MWY0NzcwZDU2ZWI0YmU4YzI0ZWQ1MmUwOThjNDc2YmFiNzRjMjgwYTQ3NTc4MDdmYTYxOWFlM2QyMGI3NjIiLCJzaWduaW5nS2V5Ijp7InB1YmxpY0tleSI6Ik1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRXdDR2N2Q3llQkRoM2F1Tm5Na0RjNWNkQm8zVTdyNlc4ZHl2SGNWRTVQaS9LeU5LVHdwcHYrOVJvMFdaM0ZmK0hGUzlqQ1crdGhrNDZMbTF5NW9EaHFRPT0iLCJmb3JtYXQiOiJTdWJqZWN0UHVibGljS2V5SW5mbyIsImFsZ29yaXRobSI6IkVTMjU2In0sInNpZ25pbmdLZXlBdXRoIjp7ImFkZHJlc3MiOiIweGQ0YTk4MDk4MjExMmY0NDZhNWMyODA3OGIwY2JlZmEzNGE2ZGU2OWUiLCJzaWduaW5nS2V5U2lnbmF0dXJlIjoiMHg1Njg4ZWUwOThiOGYwOTc2NGNhMzkyMTEyZTM2ZmU0NjQ4ZjEzMWM0OTZmMzk4Njg0MjM3MDVkMmZjMDgyNjA2NmMwY2E1ODkxN2E5YzhiZTJjMDQ3NTE1NDEwYzVmYTlmNjEzNWUxZjM2ZWE0YjBmZTE4OGE5OTdmNWExODYyZTFjIiwic2lnbmluZ0tleU1lc3NhZ2UiOiJJIGF1dGhvcml6ZSBBdGVtUmV2aWV3IGZyb20gdGhpcyBkZXZpY2UgdXNpbmcgc2lnbmluZyBrZXk6XG5NRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUV3Q0djdkN5ZUJEaDNhdU5uTWtEYzVjZEJvM1U3cjZXOGR5dkhjVkU1UGkvS3lOS1R3cHB2KzlSbzBXWjNGZitIRlM5akNXK3RoazQ2TG0xeTVvRGhxUT09In19AQAa7WfTjI3NOCSe0ZSb57FWgXmeXB-0tBxPOQm0PZc_LWx_O3OiQk8aFUkpN2idbvkwl8QZru0TXu_yhYTJcseEvVcZdqMS-isNmKFa6F9wkqZHcUBXL5gKlH9DrY4rx61G60xV-w-DVu19Xb8QXmo3go2vhcZn_TekS-VReBGiJUb2HiCM8r1swXAbg4fwII6SvlXcqF-U5RUfD3lFt33lj_POR98qCDIW5TjEVtiAQFm2KvNVjoqgJeJo8k4I7kc8yh-xnzwPBZcVxZRVU_HTnvO5ILqarrn8Mho6Klz5_n-uibw2Jc6NTfBFkKMSFfBOkBQmFgIfetxhLPYKX7ecd6x-5kL9K79cVbhtroJq3aPxV_NMc91en_XFR3gdxloUwQcO5GY08t_DFMCvzsYTPYvpuxHi1zp9eV9ayfJ4o3L6cZAk10Y5m_m2H954mD2vW3iBeMeX59zFNbkA3oiUeKrwBH2s3FVhugig4tADmrKV5K83NoWdJd4A4g3qo4vthDgR1hT__b91ayYlw1GkacJpubkkFOYCE4b07oV-AGjyYgFgU8tI7thORlax9i7qRc1Y3-6I4tEy0odz_Fd9lO_HBvVkDyoVHGgAds_oAQB-NRvW1xrNQN6tkL_MqRc5HkREBTc47Y3-Eld5aqDF4KnbzWzER3YEwlKYYcJa7Zz4F-1slaE508RbcjB8yv4skPYyk7kzbz2Q76Sl8q2iLoze8XAuDbyd2ifM7LFCxUDYKoguXENqKWxToYNAOxiyAZFzcElcA-QQXxxwrIlfpsI46nbo5Zc8vqUeQQr71dhWeD5VQILMV_IQhEFDVaTuf4CEkhP0ni7kVl5YXUkUSOHRhTVpuxO-WSc3jp_wuYWQrkIyHYEv2vjv_-b9jKgUJSg1HbcOeKV54lJGQOFIT1zYHBsFb3QQ7MmwiXjP_2pFQ4Q1q2Op6hjqMx36yFEtVUfwnaOCz-ew5UpDzsH2_NTAwZGI8z7tR2DUyxFAnFojbcNPmFe4-Hg8f2uaenrDYiGSJ1ytwyRsNmuDWu3vRckS1s0jT7XeeGLNKo3BmE1cCSb5eHuqBO2zD1ykqbQInojt44QpwxUTpeFptzV9mtSBOA2WH5NYUY4YuO6fU4G2ZgZMPP9cua7p3gG-GZjsjtY4jsUOpkAgTvgEKaKB52nDZULYIctOZUUeZKnSbAxHGWbkqaeJ7kCU-35AY5kTm8NZTqp6cgwcKxBSkP93LddraDyyjeo303WFO52jmNMXvTfw7lq1Zc1mQ475LnIi2duT-lSOCOK60WybsFQJOUVwT1eEXF7h_vEmT5bopUOrX8oCwxFUHhfJbZa0TMRJo6FDfRipD435smc7HpZpAAAIAAAAAAAAAH0BAAAAAAAAD_IFGENvbnRlbnQtVHlwZSBhcHBsaWNhdGlvbi9qc29uFkFwcGxpY2F0aW9uGEN5YmVyQ29ubmVjdBRDb250ZW50LUlkgAE4YWYwOTQwNzNiZTFjMTI0ZjQ0OTlkMmY0NDA4MDAzZjgzZDQ2MDczNThkZDY4OTRhMmRmMTMzMjc4M2Y3MjYxHENvbnRlbnQtRGlnZXN0gAE4YWYwOTQwNzNiZTFjMTI0ZjQ0OTlkMmY0NDA4MDAzZjgzZDQ2MDczNThkZDY4OTRhMmRmMTMzMjc4M2Y3MjYxHENvbnRlbnQtQXV0aG9yGG8zcHRwbzI3aWZnaQ5DaGFpbklkBDU2HENvbnRlbnQtVGFyZ2V0gAEzOWYwMjE4ODFlNzM4NmY4ZDczZDZlZjI1NTMzZTYwOTFmMmEwMjU2ZTQyMmI0YjNjNGUzZDMzNWNjYWUxNDdlDFNvdXJjZUgxNTUzMWZhMi0xMjA1LTRmNjEtYjZlNC1jOWY2OGVjZjgxZjcAeyJjb250ZW50Ijoie1wib3BcIjpcImNvbW1lbnRcIixcImFkZHJlc3NcIjpcIjB4OGYzZDIwNDE5ODczZDRkZTE2NzI4NTc3MTA0NWE5NmRhODc5NzVjOVwiLFwidHNcIjoxNjkxNDYwNjI0ODg3LFwiY2hhaW5JZFwiOjU2LFwiaGFuZGxlXCI6XCJvM3B0cG8yN2lmZ2lcIixcInRhcmdldFwiOlwiMzlmMDIxODgxZTczODZmOGQ3M2Q2ZWYyNTUzM2U2MDkxZjJhMDI1NmU0MjJiNGIzYzRlM2QzMzVjY2FlMTQ3ZVwiLFwidGl0bGVcIjpcIkZsYXBweU1vb25iaXJkXCIsXCJib2R5XCI6XCJTbyBmdW4gdG8gcGxheSBpbiBteSBzcGFyZSB0aW1lLlwifSIsImRpZ2VzdCI6IjhhZjA5NDA3M2JlMWMxMjRmNDQ5OWQyZjQ0MDgwMDNmODNkNDYwNzM1OGRkNjg5NGEyZGYxMzMyNzgzZjcyNjEiLCJzaWduYXR1cmUiOiIweGM0YTY4MTJiODBmNjNjZmVmNDAzODFkYmQ3MzMxNTM5MmFmZThiNmZmMWFiMzM3YWFjOTIzMDhmYjExN2QzNDA0MWQwNzFjZWM1OTc2NDk5YTdkNTc4NmZkZDJlNDY2NDBkMDExYTUyMWIwNjk0MTAzZDRlMzMzZTAxNDM5ODc1Iiwic2lnbmluZ0tleSI6eyJwdWJsaWNLZXkiOiJNRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUVaMG5CaW15bVNJbEpnTUZOTjA4Z0FsWngxRkFnOFUwbFIwU3RHUEtvVTFzbVlVS2psYzd4TVA2ZUNyRU1DVzVQZFZrbVZqTmN6dUkzSXo5dlB4aTVkUT09IiwiZm9ybWF0IjoiU3ViamVjdFB1YmxpY0tleUluZm8iLCJhbGdvcml0aG0iOiJFUzI1NiJ9LCJzaWduaW5nS2V5QXV0aCI6eyJhZGRyZXNzIjoiMHg4ZjNkMjA0MTk4NzNkNGRlMTY3Mjg1NzcxMDQ1YTk2ZGE4Nzk3NWM5Iiwic2lnbmluZ0tleVNpZ25hdHVyZSI6IjB4ODVjOGI5NDc2NjRkM2IyZGJlNDliMTYyNDM5ZmQ1YTAyOWE3ZGZmYWQ4OTMxYzNjMjY2MmU0ODNkMGFhZGY4ZTExMWMyNzAzYzU3YzAzOGI1OWU5MjdiNDIzYmU1MWM3OWFlYzFjMmU5NDYyZjM0ZDhlOWY0ODczODQxOTJhMzUxYyIsInNpZ25pbmdLZXlNZXNzYWdlIjoiSSBhdXRob3JpemUgQ3liZXJDb25uZWN0IGZyb20gdGhpcyBkZXZpY2UgdXNpbmcgc2lnbmluZyBrZXk6XG5NRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUVaMG5CaW15bVNJbEpnTUZOTjA4Z0FsWngxRkFnOFUwbFIwU3RHUEtvVTFzbVlVS2psYzd4TVA2ZUNyRU1DVzVQZFZrbVZqTmN6dUkzSXo5dlB4aTVkUT09In19AQBcXgn35qFYN5wckxB6DU_D3y5r57M8F8ySSJwA5GE1LUK-C_qZyiie5QajnZ-M0TAeJO5TtjNEoiQhMloDJJ4iRdgLLJAs0EmbBkEfu829ub-FlP-LHiOFhlzuV2uiATiA83RvGNEAPQoDyLoh3mPtN9avpSual3AQtbmpQYOHA40bnJTojSG6vnTnmqLQdaas3SaXoBSWczuTOEPXEbPnDISsnBGjxAy9niBq2FV5FaMCyunXt_OJ4jStgDkrHWpvYPzYRCE0Pcq2nlnufQIXAQWs9qZHSZbv71lL47pCUPNObVn_-_4NG5m5P5o-boZIlrCAV5-1f4gX75PFPU5aU1oOeJ3EZ_dVSECgGJVKQbGVNisDdpTTtZI03-e1B8uJXfu7K0FSm0dLPTA8JkqBKEYTrSXNOdHi5QPvcFmWpY6tFrSJYgs0fj1a-ZUhqvFLt-EmjfCrPaCYf7aLn4RZsBbsGdR_OagitCG3jpQjoE8j8WInh4j5hLCL-JgRcw1b3UTVMWjByhnw5FDqR_9Y56ix-UkSFkApZbWABhYIC5zHkJFPtygo7Io7X8QEjwUWPMAOA7ZBAF5vamzv6Ui8ItIj5Kf8SMRSGsx_QCOMakZXsdufxA717Q2I3pQ2Z7E-ExtgsBnQjWU-sO5EIBbZsQrY4A57D_ORbeJ9qk_lFJz4F-1slaE508RbcjB8yv4skPYyk7kzbz2Q76Sl8q2iLoze8XAuDbyd2ifM7LFCxUDYKoguXENqKWxToYNAOxiyAZFzcElcA-QQXxxwrIlfpsI46nbo5Zc8vqUeQQr71dhWeD5VQILMV_IQhEFDVaTuf4CEkhP0ni7kVl5YXUkUSOHRhTVpuxO-WSc3jp_wuYWQrkIyHYEv2vjv_-b9jKgUJSg1HbcOeKV54lJGQOFIT1zYHBsFb3QQ7MmwiXjP_2pFQ4Q1q2Op6hjqMx36yFEtVUfwnaOCz-ew5UpDzsH2_NTAwZGI8z7tR2DUyxFAnFojbcNPmFe4-Hg8f2uaenrDYiGSJ1ytwyRsNmuDWu3vRckS1s0jT7XeeGLNKo3BmE1cCSb5eHuqBO2zD1ykqbQInojt44QpwxUTpeFptzV9mtSBOA2WH5NYUY4YuO6fU4G2ZgZMPP9cua7p3gG-GZjsjtY4jsUOpkAgTvgEKaKB52nDZULYIctOZUUeZKnSbAxHGWbkqaeJ7kCU-35AY5kTm8NZTqp6cgwcKxBSkP93LddraDyyjeo303WFO52jmNMXvTfw7lq1Zc1mQ475LnIi2duT-lSOCOK60WybsFQJOUVwT1eEXF7h_vEmT5bopUOrX8oCwxFUHhfJbZa0TMRJo6FDfRipD435smc7HpZpAAAHAAAAAAAAAAwBAAAAAAAADZAEGENvbnRlbnQtVHlwZSBhcHBsaWNhdGlvbi9qc29uFkFwcGxpY2F0aW9uGEN5YmVyQ29ubmVjdBxDb250ZW50LUF1dGhvchhmb3Z1ZXlwNHJtbWIOQ2hhaW5JZAQ1NgxTb3VyY2UIYXRlbRRDb250ZW50LUlkgAFkMmFmYzM0ZGQwZTMwNjI2MTVlOGE4ODMwNDRjZmQyZjNhNzNjYWNlYTcyNTA0Y2ViZGE3ZmNmYTJiMjBiNjIxHENvbnRlbnQtRGlnZXN0gAFkMmFmYzM0ZGQwZTMwNjI2MTVlOGE4ODMwNDRjZmQyZjNhNzNjYWNlYTcyNTA0Y2ViZGE3ZmNmYTJiMjBiNjIxAHsiY29udGVudCI6IntcIm9wXCI6XCJwb3N0XCIsXCJhZGRyZXNzXCI6XCIweGYxNzAxODdjOTg1MzA4ZGRlMzA3ZmM4N2MyZDM1NThmNmY2Y2UxNDBcIixcInRzXCI6MTY5MTQ2MDYyNDg2NyxcImNoYWluSWRcIjo1NixcImhhbmRsZVwiOlwiZm92dWV5cDRybW1iXCIsXCJ0aXRsZVwiOlwiMTExMTJcIixcImJvZHlcIjpcIjIyMjIyMjIyMjIyMjIyMjIyMlwifSIsImRpZ2VzdCI6ImQyYWZjMzRkZDBlMzA2MjYxNWU4YTg4MzA0NGNmZDJmM2E3M2NhY2VhNzI1MDRjZWJkYTdmY2ZhMmIyMGI2MjEiLCJzaWduYXR1cmUiOiIweDczMDZmYTE1Nzg0NjAxNzhkNjJkZDFmZDJjNGE1YTIyMDZmZDdmOTBkYTVlZDA4M2U2NGUyNzU4ZDllNDQ1OGEzM2ExZTBhNTQ2ZDVhYTM5Y2YxODg0ZGU1ZDI1OWRlNGJjZmUzMzc3NDRiYTYyNzgwNzVkOTlkOTA1MTcxMjliIiwic2lnbmluZ0tleSI6eyJwdWJsaWNLZXkiOiJNRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUVoNTRBT29tamV2dml0QXlIb1BvVDAxa1o5enkvK0lNS3FMVE9wdFpJUHpLcm84SjhOd1dlalBFWUFrYkkrdEg4MEJNYkNGSmo5ZndOMUF5dkNkekp5QT09IiwiZm9ybWF0IjoiU3ViamVjdFB1YmxpY0tleUluZm8iLCJhbGdvcml0aG0iOiJFUzI1NiJ9LCJzaWduaW5nS2V5QXV0aCI6eyJhZGRyZXNzIjoiMHhmMTcwMTg3Yzk4NTMwOGRkZTMwN2ZjODdjMmQzNTU4ZjZmNmNlMTQwIiwic2lnbmluZ0tleVNpZ25hdHVyZSI6IjB4ZjYwNjlkYmU5MTUzNjQ2MzNhNjc1OTE3ZDdmYzRhZmFkNjZmMWYxMDc2YjRjZTk4NWE3ODQwNjNlYmNhMjAyYjFjNTYxNGUzMzMyMGJjYzFmZjA4OTQ2ZGIzMjAzMGI2ODAwOTU4YjgxMzY0YWFlM2FjZjY2YmVkNmNkZTYwZjkxYiIsInNpZ25pbmdLZXlNZXNzYWdlIjoiSSBhdXRob3JpemUgQXRlbVJldmlldyBmcm9tIHRoaXMgZGV2aWNlIHVzaW5nIHNpZ25pbmcga2V5OlxuTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFaDU0QU9vbWpldnZpdEF5SG9Qb1QwMWtaOXp5LytJTUtxTFRPcHRaSVB6S3JvOEo4TndXZWpQRVlBa2JJK3RIODBCTWJDRkpqOWZ3TjFBeXZDZHpKeUE9PSJ9fQEAZOuIFNeBPIkEQwmUi4F-zHD11WpZ6skQqlK5FzKbhGBeWybzl59exXVhF46dcEo20Rt5Sq3L6ybSwODQGPo0R9p0AK7_rciV6wgk6nIhFQo-LkRZoCIvwvkcZNol1IoGYSdWsy54WnLyhdThY9dZtK2SQ5pHWZtgDBBVJF6m1L4HcGYTyFI69hWa3E4aHzWY7ZNHMTkU6LX2BhPXodCHE-L8IM1IG7m-XyCG9NOjzfx0y1q7amaoF8vMcRheqX7lUcK6rUftYk1QhcXjJO3YhQLzB11d6ByASjpohQ-35aZG6FH46hLOdREaHVvWQrCuzPSlux9HuqOJq9SXc7gT67j4bJsSKGiuq3X0hF5iOuky6HcQiUUFc6tpyR-gZy0mvt9hBqPD3aztzYSeNaY7RGkwmithwqF0Ey9-eMk-vG-dHuxQHf2zfiRtDzxQKQcUUBMgDMDZcvTliJmRrrT9GCsPE9t-qkFhlAww3dvjjJXCwrDTe7yzVasNVqpnTvVMOKtwOBkYjLkRoreqWxn_kwZebP6WzXwxiVFbIm-iXls--8ftnY2dgrYRSfr7aV6Mr3SybsiGtokQLUa9oDiqXZhVp71PWcevKwaImcKHiEW05xjNUeqBoPpoAQEuuFct2VynT2ZIsqVXSAkt2Mbc5efIKd6FxZqx4bzob6NxGKSc-BftbJWhOdPEW3IwfMr-LJD2MpO5M289kO-kpfKtoi6M3vFwLg28ndonzOyxQsVA2CqILlxDailsU6GDQDsYsgGRc3BJXAPkEF8ccKyJX6bCOOp26OWXPL6lHkEK-9XYVng-VUCCzFfyEIRBQ1Wk7n-AhJIT9J4u5FZeWF1JFEjh0YU1absTvlknN46f8LmFkK5CMh2BL9r47__m_YyoFCUoNR23DnileeJSRkDhSE9c2BwbBW90EOzJsIl4z_9qRUOENatjqeoY6jMd-shRLVVH8J2jgs_nsOVKQ87B9vzUwMGRiPM-7Udg1MsRQJxaI23DT5hXuPh4PH9rmnp6w2IhkidcrcMkbDZrg1rt70XJEtbNI0-13nhizSqNwZhNXAkm-Xh7qgTtsw9cpKm0CJ6I7eOEKcMVE6Xhabc1fZrUgTgNlh-TWFGOGLjun1OBtmYGTDz_XLmu6d4BvhmY7I7WOI7FDqZAIE74BCmigedpw2VC2CHLTmVFHmSp0mwMRxlm5Kmnie5AlPt-QGOZE5vDWU6qenIMHCsQUpD_dy3Xa2g8so3qN9N1hTudo5jTF7038O5atWXNZkOO-S5yItnbk_pUjgjiutFsm7BUCTlFcE9XhFxe4f7xJk-W6KVDq1_KAsMRVB4XyW2WtEzESaOhQ30YqQ-N-bJnOx6WaQAABwAAAAAAAAAMAQAAAAAAAA2QBBhDb250ZW50LVR5cGUgYXBwbGljYXRpb24vanNvbhZBcHBsaWNhdGlvbhhDeWJlckNvbm5lY3QcQ29udGVudC1BdXRob3IYaGxuam9vdXFiZ3loDkNoYWluSWQENTYMU291cmNlCGF0ZW0UQ29udGVudC1JZIABMDQ2NjFlMzYzYTJhNjdiNDU2NDcyNTEzZGVjNmIxYzg2ZmYzZDFjZmYyM2UyYTQ3YTYxNzg4ZGE1YzVmMzZkYxxDb250ZW50LURpZ2VzdIABMDQ2NjFlMzYzYTJhNjdiNDU2NDcyNTEzZGVjNmIxYzg2ZmYzZDFjZmYyM2UyYTQ3YTYxNzg4ZGE1YzVmMzZkYwB7ImNvbnRlbnQiOiJ7XCJvcFwiOlwicG9zdFwiLFwiYWRkcmVzc1wiOlwiMHg2YWY5NDViM2U0MjZlMmFhMjZjYmMzOTU2NjQ2ZTA4MDk5OTMzOWNlXCIsXCJ0c1wiOjE2OTE0NjA2MjQ4NDksXCJjaGFpbklkXCI6NTYsXCJoYW5kbGVcIjpcImhsbmpvb3VxYmd5aFwiLFwidGl0bGVcIjpcIjExMTEyXCIsXCJib2R5XCI6XCIyMjIyMjIyMjIyMjIyMjIyMjJcIn0iLCJkaWdlc3QiOiIwNDY2MWUzNjNhMmE2N2I0NTY0NzI1MTNkZWM2YjFjODZmZjNkMWNmZjIzZTJhNDdhNjE3ODhkYTVjNWYzNmRjIiwic2lnbmF0dXJlIjoiMHg3YWY2MjU4MzY3Yzc0MDFjOWE4NmI1MzU4OGU0ZDMwYTE2ZDY4ZjY1NWQzYzViY2ZjYjVlZjE4N2ViMGQ2YWVlYTExMThkMDhmYjg2OWM5YTk4MTY2NTliYWFkNjk5ZjI4NGM4NjI5OTAzM2I0OWQyMjNhNzdhYjUwMGRjYTlkNCIsInNpZ25pbmdLZXkiOnsicHVibGljS2V5IjoiTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFNURwMHRQUVZwb1NERmJIelhlT29sTnR3MUMzbTFISHVPeCswMVZWNXFLbUFZNEdGZHNaZUNEY08ra3FkT242Q3dWNWQ1V2hrY1pUSVVTT0RBK011aXc9PSIsImZvcm1hdCI6IlN1YmplY3RQdWJsaWNLZXlJbmZvIiwiYWxnb3JpdGhtIjoiRVMyNTYifSwic2lnbmluZ0tleUF1dGgiOnsiYWRkcmVzcyI6IjB4NmFmOTQ1YjNlNDI2ZTJhYTI2Y2JjMzk1NjY0NmUwODA5OTkzMzljZSIsInNpZ25pbmdLZXlTaWduYXR1cmUiOiIweGEwZjkxY2I5NDE3ODU0Y2JhNDEzYTk2MjM3NWI0NTRmM2YxNjBjNmJjYTA2N2M3N2RkYmRkNDcyNTQwZDQ0ZWU0Zjc0YjRkZGNmYmY1ODY4ZWQyYjdlOWMxYzAwN2RhMDg5OGVjOTAyZDZhZTYyNjI0ODYyMTY4OWExMTViYzYzMWMiLCJzaWduaW5nS2V5TWVzc2FnZSI6IkkgYXV0aG9yaXplIEF0ZW1SZXZpZXcgZnJvbSB0aGlzIGRldmljZSB1c2luZyBzaWduaW5nIGtleTpcbk1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRTVEcDB0UFFWcG9TREZiSHpYZU9vbE50dzFDM20xSEh1T3grMDFWVjVxS21BWTRHRmRzWmVDRGNPK2txZE9uNkN3VjVkNVdoa2NaVElVU09EQStNdWl3PT0ifX0"}
    - + diff --git a/gateways/ar-io-node/overview/index.html b/gateways/ar-io-node/overview/index.html index bf339cac..7dbc47b1 100644 --- a/gateways/ar-io-node/overview/index.html +++ b/gateways/ar-io-node/overview/index.html @@ -20,11 +20,11 @@ - + - + diff --git a/gateways/ar-io-node/release-notes.html b/gateways/ar-io-node/release-notes.html index c6459fcc..0a7c3f11 100644 --- a/gateways/ar-io-node/release-notes.html +++ b/gateways/ar-io-node/release-notes.html @@ -20,15 +20,49 @@ - + -
    ar.io Docs

    # ar.io Release Notes

    # Overview

    Welcome to the documentation page for the ar.io gateway release notes. Here, you will find detailed information about each version of the ar.io gateway, including the enhancements, bug fixes, and any other changes introduced in every release. This page serves as a comprehensive resource to keep you informed about the latest developments and updates in the ar.io gateway. For those interested in exploring the source code, each release's code is readily accessible at our GitHub repository: ar.io gateway change logs (opens new window). Stay updated with the continuous improvements and advancements in the ar.io gateway by referring to this page for all release-related information.

    # [Release 16] - 2024-08-09

    • Fixed

      • Fixed promise leak caused by missing await when saving data items to the DB.
      • Modified ArNS middleware to not attempt resolution when receiving requests for a different hostname than the one specified by ARNS_ROOT_HOST.

    • Added

      • Added support for returning Content-Encoding HTTP headers based on user specified Content-Encoding tags.
      • Added isNestedBundle filter enables that matches any nested bundle when indexing. This enables composite unbundling filters that match a set of L1 tags and bundles nested under them.
      • Added ability to skip writing ANS-104 signatures to the DB and load them based on offsets from the data instead. This significantly reduces the size of the bundles DB. It can be enabled by setting the WRITE_ANS104_DATA_ITEM_DB_SIGNATURES environment variable to false.
      • Added data_item_data_indexed_total Prometheus counter to count data items with data attributes indexed.

    • Changed

      • Queue data attributes writes when serving data rather than writing them syncronously.
      • Reduced the default data indexer count to 1 to lessen the load on the data DB.
      • Switched a number of overly verbose info logs to debug level.
      • Removed docker-compose on-failure restart limits to ensure that services restart no matter how many times they fail.
      • Modified the data_items_indexed_total Prometheus counter to count data items indexed for GraphQL querying instead of data attributes.
      • Increased aggressiveness of contiguous data cleanup. It now pauses 5 seconds instead of 10 seconds per batch and runs every 4 hours instead of every 24 hours.

    # [Release 15] - 2024-07-19

    • Fixed

      • Fixed query error that was preventing bundles from being marked as fully imported in the database.

    • Added

      • Adjusted data item indexing to record data item signature types in the DB. This helps distinguish between signatures using different key formats, and will enable querying by signature type in the future.
      • Adjusted data item indexing to record offsets for data items within bundles and signatures and owners within data items. In the future this will allow us to avoid saving owners and signatures in the DB and thus considerably reduce the size of the bundles DB.
      • Added ARNS_CACHE_TTL_MS environment variable to control the TTL of ARNS cache entries (defaults to 1 hour).
      • Added support for multiple ranges in a single HTTP range request.
      • Added experimental chunk POST endpoint that broadcasts chunks to the comma-separate list of URLS in the CHUNK_BROADCAST_URLS environment variable. It is available at /chunk on the internal gateway service port (4000 by default) but is not yet exposed through Envoy.
      • Added support for running an AO CU adjacent to the gateway (see README.md for details).
      • Added X-ArNS-Process-Id to ArNS resolved name headers.
      • Added a set of AO_... environment variables for specifying which AO URLs should be used (see docker-compose.yaml for the complete list). The AO_CU_URL is of particular use since the core and resolver services only perform AO reads and only the CU is needed for reads.

    • Changed

      • Split the monolithic docker-compose.yaml into docker-compose.yaml, docker-compose.bundler.yaml, and docker-compose.ao.yaml (see README for details).
      • Replaced references to 'docker-compose' with 'docker compose' in the docs since the former is mostly deprecated.
      • Reduce max fork depth from 50 to 18 inline to reflect Arweave 2.7.2 protocol changes.
      • Increased the aggressiveness of bundle reprocessing by reducing reprocessing interval from 10 minutes to 5 minutes and raising reprocessing batch size from 100 to 1000.
      • Use a patched version of Litestream to work around insufficient S3 multipart upload size in the upstream version.

    # [Release 14] - 2024-06-26

    • Fixed

      • Correctly handle manifest index after paths.

    # [Release 13] - 2024-06-24

    • Added

      • Added support for optimistically reading data items uploaded using the integrated Turbo bundler via the LocalStack S3 interface.
      • Added X-AR-IO-Origin-Node-Release header to outbound data requests.
      • Added hops, origin, and originNodeRelease query params to outbound data requests.
      • Added support for fallback in v0.2 manifests that is used if no path in the manifest is matched.

    • Changed

      • Updated Observer to read prescribed names from and write observations to the ar.io AO network process.
      • Updated Resolver to read from the ar.io AO network process.

    • Fixed

      • Modified optimistic indexing of data items to use a null parent_id when inserting into the DB instead of a placeholder value. This prevents unexpected non-null bundledIn values in GraphQL results for optimistically indexed data items.
      • Modified GraphQl query logic to require an ID for single block GraphQL queries. Previously queries missing an ID were returning an internal SQLite error. This represents a small departure from arweave.net's query logic which returns the latest block for these queries. We recommend querying blocks instead of block in cases where the latest block is desired.
      • Adjusted Observer health check to reflect port change to 5050.

    • Security

      • Modified docker-compose.yaml to only expose Redis, PostgreSQL, and LocalStack ports internally. This protects gateways that neglect to deploy behind a firewall, reverse proxy, or load balancer.

    # [Release 12] - 2024-06-05

    • Added

      • Added /ar-io/admin/queue-data-item endpoint for queuing data item headers for indexing before the bundles containing them are processed. This allows trusted bundlers to make their data items quickly available to be queried via GraphQL without having to wait for bundle data submission or unbundling.
      • Added experimental support for retrieving contiguous data from S3. See AWS_* environment variables documentation for configuration details. In conjuction with a local Turbo bundler this allows optimistic bundle (but not yet data item) retrieval.
      • Add experimental support for fetching data from gateway peers. It can be enabled by adding ario-peer to ON_DEMAND_RETRIEVAL_ORDER. Note: do not expect this work reliably yet! This functionality is in active development and will be improved in future releases.
      • Add import_attempt_count to bundle records to enable future bundle import retry optimizations.

    • Changed

      • Removed version from docker-compose.yaml to avoid warnings with recent versions of docker-compose.
      • Switched default observer port from 5000 to 5050 to avoid conflict on OS X. Since Envoy is used to provide external access to the observer API this should have no user visible effect.

    # [Release 11] - 2024-05-21

    • Added

      • Added arweave_tx_fetch_total Prometheus metric to track counts of transaction headers fetched from the trusted node and Arweave network peers.

    • Changed

      • Revert to using unnamed bind mounts due to cross platform issues with named volumes.

    # [Release 10] - 2024-05-20

    • Added

      • Added experimental support for streaming SQLite backups to S3 (and compatible services) using Litestream (opens new window). Start the service using the docker-compose "litestream" profile to use it, and see the AR_IO_SQLITE_BACKUP_* environment variables documentation (opens new window) for further details.
      • Added /ar-io/admin/queue-bundle endpoint for queueing bundles for import for import before they're in the mempool. In the future this will enable optimistic indexing when combined with a local trusted bundler.
      • Added support for triggering webhooks when blocks are imported matching the filter specified by the WEBHOOK_BLOCK_FILTER environment variable.
      • Added experimental support for indexing transactions and related data items from the mempool. Enable it by setting ENABLE_MEMPOOL_WATCHER to 'true'.
      • Made on-demand data caching circuit breakers configurable via the GET_DATA_CIRCUIT_BREAKER_TIMEOUT_MS environment variable. This allows gateway operators to decide how much latency they will tolerate when serving data in exchange for more complete data indexing and caching.
      • Rename cache header from X-Cached to X-Cache to mimic typical CDN practices.
      • Add X-AR-IO-Hops and X-AR-IO-Origin headers in preparation for future peer-to-peer functionality.
      • Upgrade to Node.js v20 and switch to native test runner.

    # [Release 9] - 2024-04-10

    • Added
      • Added experimental Farcaster Frames support, enabling simple Arweave based Frames with button navigation. Transaction and data item data is now served under /local/farcaster/frame/<ID>. /local is used as a prefix to indicate this functionality is both experimental and local to a particular gateway rather than part of the global gateway API. Both GET and POST requests are supported.
      • Added an experimental local ArNS resolver. When enabled it removes dependence on arweave.net for ArNS resolution! Enable it by setting RUN_RESOLVER=TRUE, TRUSTED_ARNS_RESOLVER_TYPE=resolver, and TRUSTED_ARNS_RESOLVER_URL=http://resolver:6000 in your .env file.
      • Added an X-Cached header to data responses to indicate when data is served from the local cache rather than being retrieved from an external source. This is helpful for interfacing with external systems, debugging, and end-to-end testing.
      • Save hashes for unbundled data items during indexing. This enables reduction in data storage via hash based deduplication as well as more efficient peer-to-peer data retrieval in the future.

    # [Release 8] - 2024-03-14

    • Added

      • Added GraphQL SQL query debug logging to support trouble-shooting and performance optimization.
      • Added support for indexing data items (not GraphQL querying) based solely on tag name. (example use case: indexing all IPFS CID tagged data items).

    • Changes

      • Observer data sampling now uses randomized ranges to generate content hashes.
      • Reference gateway ArNS resolutions are now cached to improve report generation performance.
      • Contract interactions are now tested before posting using dryWrite to avoid submitting interactions that would fail.
      • /ar-io/observer/info now reports INVALID for wallets that fail to load.

    • Fixed

      • Fix data caching failure caused by incorrect method name in getData circuit breakers.
      • Fix healthcheck when ARNS_ROOT_HOST includes a subdomain.

    # [Release 7] - 2024 - 02 - 14

    • Added

      • Add support for notifying other services of transactions and data items using webhooks (see README for details).
      • Add support for filter negation (particularly useful for excluding large bundles from indexint).
      • Improve unbundling throughput by decoupling data fetching from unbundling.
      • Add Envoy and core service ARM builds.

    • Changed

      • Improve resouce cleanup and shutdown behavior.
      • Don't save Redis data to disk by default to help prevent memory issues on startup for small gateways.
      • Reduce the amount of data sampled from large files by the observer.
      • Ensure block poa2 field is not chached to reduce memory consumption.

    # [Release 6] - 2024-01-29

    • Fixed
      • Update observer to improve reliability of contract state synchronization and evaluation.

    # [Release 5] - 2024-01-25

    • Added

      • Added transaction offset indexing to support future data retrieval capabilities.
      • Enabled IPv6 support in Envoy config.
      • Added ability to configure observer report generation interval via the REPORT_GENERATION_INTERVAL_MS environmental variable. (Intended primarily for development and testing)

    • Changed

      • Updated observer to properly handle FQDN conflicts.
      • Renamed most created_at columns to index to indexed_at for consistency and clarity.

    • Fixed

      • Updated LMDB version to remove Buffer workaround and fix occasional block cache errors.

    # [Release 4] - 2024-01-11

    • Added

      • Added circuit breakers around data index access to reduce impact of DB access contention under heavy requests loads.
      • Added support for configuring data source priority via the ON_DEMAND_RETRIEVAL_ORDER environment variable.
      • Updated observer to a version that retrieves epoch start and duration from contract state.

    • Changed

      • Set the Redis max memory eviction policy to allkeys-lru.
      • Reduced default Redis max memory from 2GB to 256MB.
      • Improved predictability and performance of GraphQL queries.
      • Eliminated unbundling worker threads when filters are configured to skip indexing ANS-104 bundles.
      • Reduced the default number of ANS-104 worker threads from 2 to 1 when unbundling is enabled to conserve memory.
      • Increased nodejs max old space size to 8GB when ANS-104 workers > 1.

    • Fixed

      • Adjusted paths for chunks indexed by data root to include the full data root.

    # [Release 3] - 2023-12-05

    • Added

      • Support range requests (PR 61 (opens new window), PR 64 (opens new window)) +
        ar.io Docs

        # ar.io Release Notes

        # Overview

        Welcome to the documentation page for the ar.io gateway release notes. Here, you will find detailed information about each version of the ar.io gateway, including the enhancements, bug fixes, and any other changes introduced in every release. This page serves as a comprehensive resource to keep you informed about the latest developments and updates in the ar.io gateway. For those interested in exploring the source code, each release's code is readily accessible at our GitHub repository: ar.io gateway change logs (opens new window). Stay updated with the continuous improvements and advancements in the ar.io gateway by referring to this page for all release-related information.

        # [Release 17] - 2024-09-09

        # Fixed

        • Use the correct environment variable to populate WEBHOOK_BLOCK_FILTER in +docker-compose.yaml.
        • Don't cache data regions retrieved to satisfy range requests to avoid +unnecessary storage overhead and prevent inserting invalid ID to hash +mappings into the data DB.

        # Added

        • Added a new ClickHouse based DB backend. It can be used in combination with +the SQLite DB backend to enable batch loading of historical data from +Parquet. It also opens up the possibility of higher DB performance and +scalability. In its current state it should be considered a technology +preview. It won't be useful to most users until we either provide Parquet +files to load into it or automate flushing of the SQLite DB to it (both are +planned in future release). It is not intended to be standalone solution. It +supports bulk loading and efficient GraphQL querying of transactions and data +items, but it relies on SQLite (or potentially another OLTP in the future) to +index recent data. These limitations allow greatly simplified schema and +query construction. Querying the new ClickHouse DB for transaction and data +items via GraphQL is enabled by setting the 'CLICKHOUSE_URL' environment +variable.
        • Added the ability to skip storing transaction signatures in the DB by setting +WRITE_TRANSACTION_DB_SIGNATURES to false. Missing signatures are fetched from +the trusted Arweave node when needed for GraphQL results.
        • Added a Redis backed signature cache to support retrieving optimistically +indexed data item signatures in GraphQL queries when writing data items +signatures to the DB has been disabled.
        • Added on-demand and composite ArNS resolvers. The on-demand resolver +fetches results directly from an AO CU. The composite resolver attempts +resolution in the order specified by the ARNS_RESOLVER_PRIORITY_ORDER +environment variable (defaults to 'on-demand,gateway').
        • Added a queue_length Prometheus metric to facilitate monitoring queues and +inform future optimizations
        • Added SQLite WAL cleanup worker to help manage the size of the data.db-wal +file. Future improvements to data.db usage are also planned to further +improve WAL management.

        # Changed

        • Handle data requests by ID on ArNS sites. This enables ArNS sites to use +relative links to data by ID.
        • Replaced ARNS_RESOLVER_TYPE with ARNS_RESOLVER_PRIORITY_ORDER (defaults to +'on-demand,gateway').
        • Introduced unbundling back pressure. When either data item data or GraphQL +indexing queue depths are more than the value specified by the +MAX_DATA_ITEM_QUEUE_SIZE environment variable (defaults to 100000), +unbundling is paused until the queues length falls bellow that threshold. +This prevents the gateway from running out of memory when the unbundling rate +exceeds the indexing rate while avoiding wasteful bundle reprocessing.
        • Prioritized optimistic data item indexing by inserting optimistic data items +at the front of the indexing queues.
        • Prioritized nested bundle indexing by inserting nested bundles at the front +of the unbundling queue.

        # [Release 16] - 2024-08-09

        • Fixed

          • Fixed promise leak caused by missing await when saving data items to the DB.
          • Modified ArNS middleware to not attempt resolution when receiving requests for a different hostname than the one specified by ARNS_ROOT_HOST.

        • Added

          • Added support for returning Content-Encoding HTTP headers based on user specified Content-Encoding tags.
          • Added isNestedBundle filter enables that matches any nested bundle when indexing. This enables composite unbundling filters that match a set of L1 tags and bundles nested under them.
          • Added ability to skip writing ANS-104 signatures to the DB and load them based on offsets from the data instead. This significantly reduces the size of the bundles DB. It can be enabled by setting the WRITE_ANS104_DATA_ITEM_DB_SIGNATURES environment variable to false.
          • Added data_item_data_indexed_total Prometheus counter to count data items with data attributes indexed.

        • Changed

          • Queue data attributes writes when serving data rather than writing them syncronously.
          • Reduced the default data indexer count to 1 to lessen the load on the data DB.
          • Switched a number of overly verbose info logs to debug level.
          • Removed docker-compose on-failure restart limits to ensure that services restart no matter how many times they fail.
          • Modified the data_items_indexed_total Prometheus counter to count data items indexed for GraphQL querying instead of data attributes.
          • Increased aggressiveness of contiguous data cleanup. It now pauses 5 seconds instead of 10 seconds per batch and runs every 4 hours instead of every 24 hours.

        # [Release 15] - 2024-07-19

        • Fixed

          • Fixed query error that was preventing bundles from being marked as fully imported in the database.

        • Added

          • Adjusted data item indexing to record data item signature types in the DB. This helps distinguish between signatures using different key formats, and will enable querying by signature type in the future.
          • Adjusted data item indexing to record offsets for data items within bundles and signatures and owners within data items. In the future this will allow us to avoid saving owners and signatures in the DB and thus considerably reduce the size of the bundles DB.
          • Added ARNS_CACHE_TTL_MS environment variable to control the TTL of ARNS cache entries (defaults to 1 hour).
          • Added support for multiple ranges in a single HTTP range request.
          • Added experimental chunk POST endpoint that broadcasts chunks to the comma-separate list of URLS in the CHUNK_BROADCAST_URLS environment variable. It is available at /chunk on the internal gateway service port (4000 by default) but is not yet exposed through Envoy.
          • Added support for running an AO CU adjacent to the gateway (see README.md for details).
          • Added X-ArNS-Process-Id to ArNS resolved name headers.
          • Added a set of AO_... environment variables for specifying which AO URLs should be used (see docker-compose.yaml for the complete list). The AO_CU_URL is of particular use since the core and resolver services only perform AO reads and only the CU is needed for reads.

        • Changed

          • Split the monolithic docker-compose.yaml into docker-compose.yaml, docker-compose.bundler.yaml, and docker-compose.ao.yaml (see README for details).
          • Replaced references to 'docker-compose' with 'docker compose' in the docs since the former is mostly deprecated.
          • Reduce max fork depth from 50 to 18 inline to reflect Arweave 2.7.2 protocol changes.
          • Increased the aggressiveness of bundle reprocessing by reducing reprocessing interval from 10 minutes to 5 minutes and raising reprocessing batch size from 100 to 1000.
          • Use a patched version of Litestream to work around insufficient S3 multipart upload size in the upstream version.

        # [Release 14] - 2024-06-26

        • Fixed

          • Correctly handle manifest index after paths.

        # [Release 13] - 2024-06-24

        • Added

          • Added support for optimistically reading data items uploaded using the integrated Turbo bundler via the LocalStack S3 interface.
          • Added X-AR-IO-Origin-Node-Release header to outbound data requests.
          • Added hops, origin, and originNodeRelease query params to outbound data requests.
          • Added support for fallback in v0.2 manifests that is used if no path in the manifest is matched.

        • Changed

          • Updated Observer to read prescribed names from and write observations to the ar.io AO network process.
          • Updated Resolver to read from the ar.io AO network process.

        • Fixed

          • Modified optimistic indexing of data items to use a null parent_id when inserting into the DB instead of a placeholder value. This prevents unexpected non-null bundledIn values in GraphQL results for optimistically indexed data items.
          • Modified GraphQl query logic to require an ID for single block GraphQL queries. Previously queries missing an ID were returning an internal SQLite error. This represents a small departure from arweave.net's query logic which returns the latest block for these queries. We recommend querying blocks instead of block in cases where the latest block is desired.
          • Adjusted Observer health check to reflect port change to 5050.

        • Security

          • Modified docker-compose.yaml to only expose Redis, PostgreSQL, and LocalStack ports internally. This protects gateways that neglect to deploy behind a firewall, reverse proxy, or load balancer.

        # [Release 12] - 2024-06-05

        • Added

          • Added /ar-io/admin/queue-data-item endpoint for queuing data item headers for indexing before the bundles containing them are processed. This allows trusted bundlers to make their data items quickly available to be queried via GraphQL without having to wait for bundle data submission or unbundling.
          • Added experimental support for retrieving contiguous data from S3. See AWS_* environment variables documentation for configuration details. In conjuction with a local Turbo bundler this allows optimistic bundle (but not yet data item) retrieval.
          • Add experimental support for fetching data from gateway peers. It can be enabled by adding ario-peer to ON_DEMAND_RETRIEVAL_ORDER. Note: do not expect this work reliably yet! This functionality is in active development and will be improved in future releases.
          • Add import_attempt_count to bundle records to enable future bundle import retry optimizations.

        • Changed

          • Removed version from docker-compose.yaml to avoid warnings with recent versions of docker-compose.
          • Switched default observer port from 5000 to 5050 to avoid conflict on OS X. Since Envoy is used to provide external access to the observer API this should have no user visible effect.

        # [Release 11] - 2024-05-21

        • Added

          • Added arweave_tx_fetch_total Prometheus metric to track counts of transaction headers fetched from the trusted node and Arweave network peers.

        • Changed

          • Revert to using unnamed bind mounts due to cross platform issues with named volumes.

        # [Release 10] - 2024-05-20

        • Added

          • Added experimental support for streaming SQLite backups to S3 (and compatible services) using Litestream (opens new window). Start the service using the docker-compose "litestream" profile to use it, and see the AR_IO_SQLITE_BACKUP_* environment variables documentation (opens new window) for further details.
          • Added /ar-io/admin/queue-bundle endpoint for queueing bundles for import for import before they're in the mempool. In the future this will enable optimistic indexing when combined with a local trusted bundler.
          • Added support for triggering webhooks when blocks are imported matching the filter specified by the WEBHOOK_BLOCK_FILTER environment variable.
          • Added experimental support for indexing transactions and related data items from the mempool. Enable it by setting ENABLE_MEMPOOL_WATCHER to 'true'.
          • Made on-demand data caching circuit breakers configurable via the GET_DATA_CIRCUIT_BREAKER_TIMEOUT_MS environment variable. This allows gateway operators to decide how much latency they will tolerate when serving data in exchange for more complete data indexing and caching.
          • Rename cache header from X-Cached to X-Cache to mimic typical CDN practices.
          • Add X-AR-IO-Hops and X-AR-IO-Origin headers in preparation for future peer-to-peer functionality.
          • Upgrade to Node.js v20 and switch to native test runner.

        # [Release 9] - 2024-04-10

        • Added
          • Added experimental Farcaster Frames support, enabling simple Arweave based Frames with button navigation. Transaction and data item data is now served under /local/farcaster/frame/<ID>. /local is used as a prefix to indicate this functionality is both experimental and local to a particular gateway rather than part of the global gateway API. Both GET and POST requests are supported.
          • Added an experimental local ArNS resolver. When enabled it removes dependence on arweave.net for ArNS resolution! Enable it by setting RUN_RESOLVER=TRUE, TRUSTED_ARNS_RESOLVER_TYPE=resolver, and TRUSTED_ARNS_RESOLVER_URL=http://resolver:6000 in your .env file.
          • Added an X-Cached header to data responses to indicate when data is served from the local cache rather than being retrieved from an external source. This is helpful for interfacing with external systems, debugging, and end-to-end testing.
          • Save hashes for unbundled data items during indexing. This enables reduction in data storage via hash based deduplication as well as more efficient peer-to-peer data retrieval in the future.

        # [Release 8] - 2024-03-14

        • Added

          • Added GraphQL SQL query debug logging to support trouble-shooting and performance optimization.
          • Added support for indexing data items (not GraphQL querying) based solely on tag name. (example use case: indexing all IPFS CID tagged data items).

        • Changes

          • Observer data sampling now uses randomized ranges to generate content hashes.
          • Reference gateway ArNS resolutions are now cached to improve report generation performance.
          • Contract interactions are now tested before posting using dryWrite to avoid submitting interactions that would fail.
          • /ar-io/observer/info now reports INVALID for wallets that fail to load.

        • Fixed

          • Fix data caching failure caused by incorrect method name in getData circuit breakers.
          • Fix healthcheck when ARNS_ROOT_HOST includes a subdomain.

        # [Release 7] - 2024 - 02 - 14

        • Added

          • Add support for notifying other services of transactions and data items using webhooks (see README for details).
          • Add support for filter negation (particularly useful for excluding large bundles from indexint).
          • Improve unbundling throughput by decoupling data fetching from unbundling.
          • Add Envoy and core service ARM builds.

        • Changed

          • Improve resouce cleanup and shutdown behavior.
          • Don't save Redis data to disk by default to help prevent memory issues on startup for small gateways.
          • Reduce the amount of data sampled from large files by the observer.
          • Ensure block poa2 field is not chached to reduce memory consumption.

        # [Release 6] - 2024-01-29

        • Fixed
          • Update observer to improve reliability of contract state synchronization and evaluation.

        # [Release 5] - 2024-01-25

        • Added

          • Added transaction offset indexing to support future data retrieval capabilities.
          • Enabled IPv6 support in Envoy config.
          • Added ability to configure observer report generation interval via the REPORT_GENERATION_INTERVAL_MS environmental variable. (Intended primarily for development and testing)

        • Changed

          • Updated observer to properly handle FQDN conflicts.
          • Renamed most created_at columns to index to indexed_at for consistency and clarity.

        • Fixed

          • Updated LMDB version to remove Buffer workaround and fix occasional block cache errors.

        # [Release 4] - 2024-01-11

        • Added

          • Added circuit breakers around data index access to reduce impact of DB access contention under heavy requests loads.
          • Added support for configuring data source priority via the ON_DEMAND_RETRIEVAL_ORDER environment variable.
          • Updated observer to a version that retrieves epoch start and duration from contract state.

        • Changed

          • Set the Redis max memory eviction policy to allkeys-lru.
          • Reduced default Redis max memory from 2GB to 256MB.
          • Improved predictability and performance of GraphQL queries.
          • Eliminated unbundling worker threads when filters are configured to skip indexing ANS-104 bundles.
          • Reduced the default number of ANS-104 worker threads from 2 to 1 when unbundling is enabled to conserve memory.
          • Increased nodejs max old space size to 8GB when ANS-104 workers > 1.

        • Fixed

          • Adjusted paths for chunks indexed by data root to include the full data root.

        # [Release 3] - 2023-12-05

        • Added

        • Changed

          • Used pinned container images tags for releases.
          • Default to Redis header cache when running via docker-compose.
          • Default to LMDB header cache when running via yarn start.

        • Fixed

          • Correct GraphQL pagination for transactions with duplicate tags.
        - + diff --git a/gateways/ar-io-node/windows-setup/index.html b/gateways/ar-io-node/windows-setup/index.html index 9e710f8b..696c9f8c 100644 --- a/gateways/ar-io-node/windows-setup/index.html +++ b/gateways/ar-io-node/windows-setup/index.html @@ -20,7 +20,7 @@ - + @@ -57,6 +57,6 @@
        • Use the cd command to change directories. For example, to navigate to the Documents directory:
          cd Documents
      • Run the following command:
        git clone -b main https://github.com/bobinstein/dockerized-nginx

      Note: This NGINX container was designed to easily automate many of the more technical aspects of setting up NGNIX and obtaining an ssl certificate so your node can be accessed with https. However, wildcard domain certifications cannot be universally automated due to significant security concerns. Be sure to follow the instructions in this project for obtaining wildcard domain certificates in order for your node to function properly.

    • Follow the instructions provided in the repository for setting up NGINX Docker.

      • Congratulations! Your AR.IO node is now running and connected to the internet. Test it by entering https://<your-domain>/3lyxgbgEvqNSvJrTX2J7CfRychUD5KClFhhVLyTPNCQ in your browser.

      Note: If you encounter any issues during the installation process, please seek assistance from the AR.IO community (opens new window).

    - + diff --git a/gateways/bundler/index.html b/gateways/bundler/index.html index 412f0625..add04a0f 100644 --- a/gateways/bundler/index.html +++ b/gateways/bundler/index.html @@ -20,7 +20,7 @@ - + @@ -44,6 +44,6 @@

    The -d flag runs the command in "detached" mode, so it will run in the background without requiring the terminal to remain active.

    # Stopping

    To spin the bundler service down, specify the docker-compose file in a docker compose down command:

    docker compose --file docker-compose.bundler.yaml down

    # logs

    While the bundler service is running in detached mode, logs can be checked by specifying the docker-compose file in a docker compose logs command:

    docker compose --file docker-compose.bundler.yaml logs -f --tail=0
    • -f runs the command in "follow" mode, so the terminal will continue to watch and display new logs.
    • --tail= defines the number of logs to display that existed prior to running the command. 0 displays only new logs.
    - + diff --git a/gateways/delegated-staking/index.html b/gateways/delegated-staking/index.html index eeac2828..82bc840a 100644 --- a/gateways/delegated-staking/index.html +++ b/gateways/delegated-staking/index.html @@ -20,11 +20,11 @@ - +
    ar.io Docs

    # Delegated Staking Settings

    # Overview

    Gateway operators can choose to allow other people to stake tokens on their gateway. This is called “delegated staking”, and it increases the number of tokens staked for a given gateway. The additionally staked tokens result in a greater stakeWeight for the gateway - increasing it’s likelihood chosen as an observer and potentially receive additional rewards for a given epoch (assuming that the gateway’s observer is working properly). To incentivize this, you can set a portion of your gateway and observer rewards to be given to the people who stake on your gateway.

    -->
    - + diff --git a/gateways/index.html b/gateways/index.html index 8cce07c1..7611c5c0 100644 --- a/gateways/index.html +++ b/gateways/index.html @@ -20,11 +20,11 @@ - +
    ar.io Docs

    # Gateway Architecture

    # Overview

    A gateway’s primary role in the Arweave ecosystem is to act as a bridge between the Arweave network and the outside world. This means that a gateway's main task is to make it easier for users to interact with the Arweave network by simplifying the technical processes of writing, reading, and discovering data on the blockweave in a trust-minimized fashion.

    The core functions of a general Arweave gateway are broken down into the following areas.

    Writing data involves:

    • Proxying Layer 1 transaction headers to one or more healthy and active Arweave nodes (miners) to facilitate inclusion in the mempools of as many nodes as possible.

    • Proxying chunks for Layer 1 Arweave transactions to Arweave nodes to help facilitate storage and replication of the chunks on the blockweave.

    • Receiving and bundling so-called Layer 2 data items (e.g., ANS-104 spec) as Layer 1 transactions.

    Reading involves retrieving:

    • Transaction headers for a Layer 1 Arweave transaction.

    • Individual data chunks for a Layer 1 Arweave transaction.

    • Blocks from the blockweave.

    • Storage pricing rates for data from the Arweave node network.

    • Contiguous streams of chunks representing an entire Layer 1 transaction.

    • Layer 2 bundled data items (e.g., ANS-104).

    • Wallet information (e.g., token balance).

    Discovering data involves:

    • Facilitating efficient, structured queries for Layer 1 and Layer 2 transaction and wallet data by:

      • examining incoming streams of data (i.e., directly ingested transactions and data items, blocks emitted by the chain, etc.).

      • managing index data in a database or analogous data store.

    • Parsing and executing user queries.

    • Facilitating friendly-path routing via Arweave manifest indexing.

    # AR.IO Gateway Benefits

    AR.IO gateways provide many new benefits and capabilities beyond general Arweave gateways:

    • Providing the modularity and configurability necessary for operating extensible gateways that can be deployed at small or large scales to meet the needs of specific applications, use cases, communities, or business models.

    • Providing pluggable means for consuming telemetry data for internal and external monitoring and alerting.

    • Facilitating friendly-subdomain-name routing to Arweave transactions via a direct integration with the Arweave Name System (ArNS).

    • Facilitating configurable content moderation policies.

    • Providing connectivity to a decentralized network of other AR.IO gateways, enabling data sharing and other shared workloads.

    # Gateway Modularity

    A design principle of AR.IO gateways is that their core components should be interchangeable with compatible implementations.

    The core services in the gateway are written in Typescript, with flexible interfaces to the various subsystems and databases. This allows operators to customize their gateway to meet their specific requirements. Gateway services can be turned on or off depending on the operator's needs. For example, an operator might choose to have their gateway serve data, but not actively index Layer 2 bundled data.

    This flexibility also allows operators to utilize the technologies that are appropriate for the scale and environments in which they operate.

    For example, small scale operators might want to use low-overhead relational databases to power their indexing while larger scale operators might opt to use cloud-native, horizontally scalable databases. Analogous examples for storage and caching exist as well.

    Gateway Tech Stack Options
    Topology Chain Index Bundle Index Data Index Data Store
    Small SQLite SQLite SQLite Local File System
    Large PostgreSQL Cassandra Cassandra S3 Compatible

    # ARNS Indexing and Routing

    The Arweave Name System’s (ArNS) state is managed by the IO token’s smart contract. AR.IO gateways shall perform the following minimum functions relative to ArNS:

    • Actively track state changes in the contract.

    • Maintain up-to-date indexes for routing configurations based on the state of the IO contract as well as the states of the Arweave Name Token (ANT) contracts to which each name is affiliated.

    • Manage the expiration of stale records.

    • Facilitate ArNS routing based on the subdomains specified on incoming requests where appropriate.

    • Provide a custom HTTP response header for ArNS requests indicating the corresponding Arweave transaction ID.

    # Content Moderation

    The AR.IO Network will adopt Arweave’s voluntary content moderation model whereby every participant of the network has the autonomy to decide which content they want to (or can legally) store, serve, and see. Each gateway operating on the network has the right and ability to blocklist any content (or address) that is deemed in violation of its content policies or non-compliant with local regulations.

    - + diff --git a/gateways/testnet/index.html b/gateways/testnet/index.html index 1329fdfc..a7e8e1b5 100644 --- a/gateways/testnet/index.html +++ b/gateways/testnet/index.html @@ -20,11 +20,11 @@ - +
    ar.io Docs

    # Join the AR.IO Testnet

    # Prerequisites

    1. Must have a fully functional AR.IO gateway.

    2. Gateway must be associated with an Arweave Wallet.

    3. Arweave wallet must be funded with enough AR tokens to pay for transaction gas.

    # Submit an Application

    Joining the ar.io Testnet requires staking a minimum of 50,000 Test IO Tokens. You must have Test IO Tokens before you are able to join. Test IO Tokens are currently not being distributed.

    New applications for joining the Testnet are not currently being accepted. Be sure to join the ar.io Discord (opens new window) to stay up to date on Testnet status and possible future availability prior to the launch of the Mainnet. -->

    - + diff --git a/gateways/upgrade/index.html b/gateways/upgrade/index.html index 2542467b..d3aa099c 100644 --- a/gateways/upgrade/index.html +++ b/gateways/upgrade/index.html @@ -20,7 +20,7 @@ - + @@ -38,6 +38,6 @@

  • Check for New Environmental Variables

    Read the update release change logs and community announcements to see if the new version includes any new environmental variables that you should set before restarting your gateway.

  • Restart the Docker container

    Finally, start the Docker container again to implement the changes:

    Linux 
    sudo docker-compose up -d
    Windows 
    docker-compose up -d

    NOTE: Effective with Release #3, it is no longer required to include the --build flag when starting your gateway. Docker will automatically build using the image specified in the docker-commpose.yaml file.

    • That's it! Your AR.IO Gateway is now upgraded to the latest version. Ensure to test and verify that everything is functioning as expected. If you encounter any issues, reach out to the AR.IO community (opens new window) for assistance.

    - + diff --git a/glossary.html b/glossary.html index af3b70fc..31d7b38a 100644 --- a/glossary.html +++ b/glossary.html @@ -20,11 +20,11 @@ - +
    ar.io Docs

    # Glossary

    Many novel terms and acronyms are used by the Arweave ecosystem as well as some new ones introduced by AR.IO. The list below is intended to serve as a non-exhaustive reference of those terms:

    # aoComputer (AO):

    The aoComputer is the actor oriented machine that emerges from the network of nodes that adhere to its core data protocol, running on the Arweave network. It is a single, unified computing environment, hosted on a heterogenous set of nodes in a distributed network. AO is designed to offer an environment in which an arbitrary number of parallel processes can be resident, coordinating through an open message passing layer. This message passing standard connects the machine's independently operating processes together into a 'web' -- in the same way that websites operate on independent servers but are conjoined into a cohesive, unified experience via hyperlinks.

    # Arweave Name System (ArNS):

    A decentralized and censorship-resistant naming system enabled by AR.IO gateways which connects friendly names to permaweb applications, pages, and data.

    # Arweave Name Token (ANT), “Name Token”:

    An aoComputer based token, that is connected to each registered ArNS Name. Each ANT gives the owner the ability to update the subdomains and Arweave transaction IDs used by the registered name as well as transfer ownership and other functions.

    # Arweave Network Standards (ANS):

    Drafts and finalized standards for data formats, tag formats, data protocols, custom gateway features and anything that is built on top the Arweave Network. Specific standards are denoted by an associated number, e.g., ANS-###.

    # Base Layer Transaction:

    Refers to one of up to 1,000 transactions that make up a single Arweave block. A base layer transaction may contain bundled data items.

    # Bundle, bundling:

    An Arweave concept introduced in ANS-104 that allows for a way of writing multiple independent data transactions into one base layer transaction. Bundled transactions contain multiple independent transactions, called data items, wrapped into one larger transaction. This offers two major network benefits:

    • A scaling solution for increasing the throughput of uploads to the Arweave network,

    • Allows delegation of payment for an upload to a third party, while maintaining the identity and signature of the person who created the upload, without them needing to have a wallet with funds.

    # Bundled Data Item (BDI):

    A data item / transaction nested within an ANS-104 bundled transaction.

    # Bundler:

    A third-party service and gateway feature that bundles data files on a user’s behalf.

    # Chunk:

    A chunk is a unit of data that is stored on the Arweave network. It represents a piece of a larger file that has been split into smaller, manageable segments for efficient storage and retrieval.

    # Decentralized, decentralization, etc:

    A nonbinary, many axis scale enabling a system or platform to be: permissionless, trustless, verifiable, transparent, open-source, composable, resilient, and censorship resistant. Ultimately, something that is decentralized is not prone to single points of failure or influence.

    # Epoch:

    A specific duration (e.g., one block-week) during which network activities and evaluations are conducted. It serves as a key time frame for processes such as observation duties, performance assessments, and reward distributions within the network's protocols.

    # Gateway:

    A node operating on the Arweave network that provides services for reading from, writing to, and indexing the data stored on the permaweb. Sometimes referred to as “permaweb nodes”.

    # Gateway Address Registry (GAR):

    A decentralized directory maintained in the AR.IO smart contract. It serves as the authoritative list of all registered gateways on the AR.IO Network. The registry provides detailed metadata about each gateway to facilitate discovery, health monitoring, and data sharing among permaweb apps and users. The GAR is designed to be easily queryable, sortable, and filterable by end users and clients, allowing for tailored selections based on various criteria to meet specific use cases.

    # Indexing:

    The act of organizing transaction data tags into queryable databases.

    # Layer 2 Infrastructure:

    Layer 2 refers to the technology / infrastructure stack built “above” a base layer. In this use, the AR.IO Network would be considered Layer 2 infrastructure to the base Arweave protocol.

    # Manifest (aka Path Manifest, Arweave Manifest):

    Special “aggregate” files uploaded to Arweave that map user-definable sub-paths with other Arweave transaction IDs. This allows users to create logical groups of content, for example a directory of related files, or the files and assets that make up a web page or application. Instead of having to manually collate these assets, manifests group them together so that an entire website or app can be launched from a single manifest file. Gateways can interpret this structure, so that users can then reference individual transactions by their file name and/or path.

    # Mempool:

    Short for "memory pool," is a component of Arweave mining nodes that temporarily stores valid transactions that have been broadcasted to the network but have not yet been added to a block.

    # Miner (aka Arweave Node):

    A node operating on the Arweave network responsible for data storage and recall.

    # Native Address:

    The way public addresses are commonly (or by spec) represented in their native blockchain. Arweave keys are 43 character base64url representations of the public key, while Ethereum keys use a different hashing algorithm and start with 0x etc.

    # Normalized Address:

    43 character base64url representation of the sha256 hash of a public key. Public keys for other chains can be normalized by this representation.

    # Observer:

    A gateway selected to evaluate the performance of peer gateways in resolving ArNS names. Observers assess and report on the operational efficacy of other gateways.

    # Optimistic Indexing:

    Indexing transaction or data item headers before the associated L1 transaction has been accepted and confirmed in a chain block.

    # Owner:

    Generally, the public key of the signer.

    # Owner Address:

    The normalized address of the owner

    # Period:

    Refers to a predefined time span (e.g., a block-day) that serves as a cycle for network activities such as dynamic pricing. It is a fundamental unit of time for operational and protocol processes within the network.

    # Permaweb:

    The permaweb is the permanent and decentralized web of files and applications built on top of Arweave.

    # Protocol Balance:

    The primary sink and source of IO tokens circulating through the AR.IO Network. This balance is akin to a central vault or wallet programmatically encoded into the network’s smart contract from which ArNS revenue is accumulated and incentive rewards are distributed.

    # Protocol Rewards:

    IO Token incentive rewards distributed by the protocol to the network’s eligible users and gateway operators.

    # Public Key:

    The publicly known keys for a signer (wallet). Public keys are different byte lengths depending on the signer type (e.g. Arweave vs. Ethereum (ECDSA), vs Solana, etc.)

    # Seeding:

    Refers to the act of propagating new data throughout the network. Miner nodes seed Arweave base layer transaction data to other miners, while gateways ensure that the transactions they receive reach the Arweave nodes. Both gateways and Arweave nodes seed base layer transactions and data chunks.

    # Staking (of tokens):

    Refers to the process of locking IO tokens into a protocol-facilitated vault, temporarily removing them from circulation until unlocked. This action represents an opportunity cost for the gateway operator and serves as a motivator to prioritize the network's collective interests.

    # Transaction ID (txID):

    Every transaction and data file uploaded to Arweave is assigned a unique identifier code known as the Transaction ID. These txID’s can be referenced by users to easily locate and retrieve files.

    # Trust-minimization:

    Relates to enacting network security by minimizing the number of entities and the degree to which they must be trusted to achieve reliable network interactions. A network with trust-minimizing mechanisms means that it has reduced exposure to undesirable third-party actions and built-in incentives to reward good behavior while punishing bad behavior.

    # Vault:

    Token vaults are protocol level mechanisms used to contain staked tokens over time. Each vault contains a starting block height, ending block height (if applicable), along with a balance of tokens.

    - + diff --git a/guides/arns/managing.html b/guides/arns/managing.html index 17b18037..de135235 100644 --- a/guides/arns/managing.html +++ b/guides/arns/managing.html @@ -20,13 +20,13 @@ - +
    ar.io Docs

    # Managing ArNS Assets

    # Overview

    From the Manage Assets page of arns.app, you can view details about your registered names, assign new Target IDs for your names to resolve to, or register new undernames for your ArNS names.

    Access the Manage Assets page by connecting your Arweave wallet, and clicking on the account button displaying your wallet address (the connect button if you are not connected), then selecting "Manage Assets" from the menu.

    The Manage Assets page features two important tabs. Names and ANTS.

    # Names

    The Names tab displays all of the ArNS names registered to the currently connected wallet. Each name has its own "details" button which allows you to view details about the name, extend the lease period, or increase the available undernames for that name.

    # ANTs

    The ANTs tab displays each ANT owned by the connected wallet (except for advanced use cases, each ArNS name will have its own ANT). You can view and create new undernames using the "Undernames" button, or access advanced management options by clicking on the "manage" icon (shaped like a gear).

    The Advanced manage page allows you to transfer ownership, add or remove controllers (other wallets who are able to manage an ANT) or set/modify a Target ID for a name to resolve to.

    - + diff --git a/guides/arns/overview.html b/guides/arns/overview.html index 052c55d3..b39d6212 100644 --- a/guides/arns/overview.html +++ b/guides/arns/overview.html @@ -20,11 +20,11 @@ - +
    ar.io Docs

    # Arweave Name System (ArNS)

    # Overview

    The Arweave Name System (ArNS) is a decentralized, censorship-resistant naming system on Arweave. It allows data on Arweave to be assigned to friendly domain names. Learn more about ArNS here.

    This guide will walk you through the process of purchasing and managing an ArNS name using arns.app (opens new window), the official ArNS portal from AR.IO.

    - + diff --git a/guides/arns/registering.html b/guides/arns/registering.html index 8598c274..1d4453ab 100644 --- a/guides/arns/registering.html +++ b/guides/arns/registering.html @@ -20,13 +20,13 @@ - +
    ar.io Docs

    # Registering an ArNS name

    # Overview

    There are two options when registering an ArNS name. You can purchase the name outright, or lease it for a period of 1 to 5 years. Registrations are further broken down into instant buys, and dutch auctions. Auctions are required for purchases of certain names in a specified character length range. Find more information about when an auction is required, as well as the rules an ArNS name must follow to be valid here.

    # Connect Your Wallet

    In order to purchase ArNS names, you will need to have a connected Arweave wallet in order to sign and pay for the transaction. Connect your wallet by clicking the "Connect" button in the top right, and following the prompts.

    # Checking Availability

    The home page of arns.app (opens new window) features a search box for checking if a specific ArNS name is available for registration. Indicators below the box can help to make sure you are complying with the technical requirements for name validity as you type.

    Simply type out the name you would like to register and click on the search icon next to the text box. A check will be performed to let you know if your chosen name is available or already in use.

    NOTE: 1 to 4 character names are not available during the testnet.

    or

    If a name is unavailable, information about the name's registration period and current owner will be displayed. If it is available, a "Register" button will appear, allowing you to move to the next step in registration.

    # Configure Your Purchase

    After clicking "Register" on a valid and available name, you will be prompted to connect a wallet using ArConnect (opens new window) if you have not already done so. Support for other wallets will be added in the future.

    Once you are connected, you will be shown a page to configure your purchase. You will be able to select if you want to lease or buy the name, and the length of the lease. A notice will appear if your purchase requires an auction.

    You can also use this page to assign the name to an existing Arweave Name Token (ANT), or set an Arweave Transaction ID (Target ID) for the name to resolve to. You will be able to set or change the Target ID after your purchase from the asset management page.

    Towards the bottom of the page, you can also see the cost of your currently configured purchase in IO tokens, and the AR required to pay for gas for the transaction.

    # Confirm Your Purchase

    The final page before submitting your purchase shows a summary of your purchase. If everything looks correct, click on the "confirm" button to finalize the transaction. Remain on the page while the transaction processes.


    # Auctions

    No additional steps are necessary to initiate a purchase that requires an auction. However, the name will not immediately become yours. Instead, confirming your purchase will begin the auction.

    The IO cost displayed on the confirmation page will be frozen by the aoComputer contract, and used to finalize the purchase once the the auction drops to the floor price. You, or anyone else, may purchase the name at any time for the current auction price. You can click on the "View Auction" button from your confirmation page, or find your auction in the "Live Auctions" tab at the top of the screen to view the current auction price, and how it will change over time. If someone else purchases the name prior to the auction reaching the floor price, your frozen tokens will be released to you.

    - + diff --git a/guides/delegated-staking/index.html b/guides/delegated-staking/index.html index 3a9cd55f..dd21cdbf 100644 --- a/guides/delegated-staking/index.html +++ b/guides/delegated-staking/index.html @@ -20,7 +20,7 @@ - + @@ -34,6 +34,6 @@

    # Running the Script

    Once the repo is installed and your wallet is provided, all that is left is to run the script. This can be done with a single command in your terminal.

    Make sure your terminal is in the root folder of the testnet-contract repo (the one named 'testnet-contract'), and run this command:

    yarn delegate-stake

    You will be prompted in your terminal for the number of tokens you want to stake, and the wallet address of the target gateway.

    # Withdrawing Stake

    If you want to take your staked tokens out of a gateway, the process is very similar. You will be running the decrease-delegate-stake script instead of the delegate-stake script.

    yarn decrease-delegate-stake

    You will again be prompted for the number of tokens you want to withdraw and the wallet address of the gateway you want to withdraw from.

    Only the wallet that owns the staked tokens can withdraw, so make sure you are using the same wallet to run the script as you used to stake the tokens initially.

    NOTE: Token withdrawals are not instant, and there is a period where the tokens will remain unavailable after you run the script. The length of this hold may vary a bit during testnet while optimal times are iterated upon.

    - + diff --git a/guides/experimental/ao-ant/index.html b/guides/experimental/ao-ant/index.html index 26158fca..dd1f9486 100644 --- a/guides/experimental/ao-ant/index.html +++ b/guides/experimental/ao-ant/index.html @@ -20,7 +20,7 @@ - + @@ -29,6 +29,6 @@

    From here, simply load the arns-resolver file into your process.

    .load ant.lua

    If things work successfully, your aos terminal will print "undefined".

    # Usage

    Simply loading the script into your process will set variables and handlers to make your process conform to the ant standard, but you will still need to send an initiate request to add your ANT into the ao registry.

    # Set Controller

    Only authorized people can make updates to your ArNS name. Because of this, you will need to add your process ID as a 'controller' under your ArNS name at arns.app (opens new window). This will give your process permissions needed to make these updates

    # Initiate Record Sync and Update

    When you purchase an ArNS name on arns.app, that name is not automatically synced to the ao-ArNS registry. Anyone can initiate a sync, which loads the data of an ArNS name from the aoComputer contract into the ao-ArNS registry:

    Send({ Target = "TyduW6spZTr3gkdIsdktduJhgtilaR_ex5JukK8gI9o", Tags = { Action = "Initiate-Record-Sync", Name = "<ArNS-name-to-sync>" }})

    Be sure to replace <ArNS-name-to-sync> with the correct ArNS name.

    Once your process is a controller, and you have loaded the ANT script, you can initiate an update to the ao-ArNS registry by running the following command:

    Send({ Target = ARNS_PROCESS_ID, Tags = { Action = "Initiate-Record-Update", Name = "<your-arns-name>", ProcessId = ao.id }})

    Make sure to change <your-arns-name to the ArNS name you are trying to update. When you load the arns.lua script, the variable ARNS_PROCESS_ID is set to TyduW6spZTr3gkdIsdktduJhgtilaR_ex5JukK8gI9o, which is the process id of the ao-ArNS registry.

    Once this is done, anyone will be able to resolve your ArNS name from inside ao and have easy access to your process Id.

    - + diff --git a/guides/experimental/ao-resolver/index.html b/guides/experimental/ao-resolver/index.html index bdd5cd42..7c0e74b2 100644 --- a/guides/experimental/ao-resolver/index.html +++ b/guides/experimental/ao-resolver/index.html @@ -20,7 +20,7 @@ - + @@ -139,6 +139,6 @@

    does not have the fields "contract" or "process", so if you tried to get ARNS.data('ardrive') it would return nil (or undefined). Using

    ARNS.id('ardrive')

    instead will get the contractTxId value from the top level, and return that value. Just like with data, a process id is prioritized over a contract id.

    # Clear

    ARNS.clear will reset your NAMES table, emptying your locally saved cache of ARNS data.

    # Sync

    When someone purchases an ArNS name on arns.app, that name is not automatically synced to the ao-ArNS registry. Anyone can initiate a sync, which loads the data of an ArNS name from the smartweave contract into the ao-ArNS registry:

    Send({ Target = "TyduW6spZTr3gkdIsdktduJhgtilaR_ex5JukK8gI9o", Tags = { Action = "Initiate-Record-Sync", Name = "<ArNS-name-to-sync>" }})

    Be sure to replace <ArNS-name-to-sync> with the correct ArNS name.

    NOTE: Syncing data from the ArNS smartweave contract relies on the Orbit Oracle (opens new window). ao and Orbit are still in early development, and may not perform exactly as expected.

    - + diff --git a/guides/graphql/index.html b/guides/graphql/index.html index ba9aee1c..fbff3ea8 100644 --- a/guides/graphql/index.html +++ b/guides/graphql/index.html @@ -20,7 +20,7 @@ - + @@ -120,6 +120,6 @@ console.error('Error:', error); });
    - + diff --git a/guides/perma-deploy/index.html b/guides/perma-deploy/index.html index b5b6c871..3a0131c5 100644 --- a/guides/perma-deploy/index.html +++ b/guides/perma-deploy/index.html @@ -20,7 +20,7 @@ - + @@ -63,6 +63,6 @@ npm install npm run deploy

    The above tells github to perform these actions when you push new code to the branch main

    It then sets up a vps with nodejs v 20. When that is complete, it installs dependencies for your project using npm (You will need to add a step to install yarn if that is your preferred package manager), and runs your deploy script, which builds your static folder and then runs permaweb-deploy. It also loads your github secrets into environmental variables that can be used by your deploy script.

    # Deploying App

    With the above setup complete, the only thing you need to do to deploy a new version of a permasite app to Arweave is push the updated code to branch main on github. Everything else is fully automated.

    - + diff --git a/guides/sdk-release-notes.html b/guides/sdk-release-notes.html index 62e2d50f..3407eab2 100644 --- a/guides/sdk-release-notes.html +++ b/guides/sdk-release-notes.html @@ -20,11 +20,11 @@ - +
    ar.io Docs

    # ar.io SDK Changelog

    # Overview

    Welcome to the documentation page for the ar.io SDK release notes. Here, you will find detailed information about each version of the ar.io SDK, including the enhancements, bug fixes, and any other changes introduced in every release. This page serves as a comprehensive resource to keep you informed about the latest developments and updates in the ar.io SDK. For those interested in exploring the source code, each release's code is readily accessible at our GitHub repository: ar.io SDK change logs (opens new window). Stay updated with the continuous improvements and advancements in the ar.io SDK by referring to this page for all release-related information.

    # 2.2.0 (opens new window) (2024-08-30)

    # Bug Fixes

    # Features

    # 2.1.0 (opens new window) (2024-08-07)

    # Bug Fixes

    # Features

    # 2.0.2 (opens new window) (2024-07-12)

    # Bug Fixes

    # 2.0.1 (opens new window) (2024-07-11)

    # Bug Fixes

    # 2.0.0 (opens new window) (2024-07-11)

    # Bug Fixes

    # Features

    # BREAKING CHANGES

    • deps: removes all smartweave implementations using warp-sdk. The result is an only AO compatible ANT and IO network contracts. Some utilities are preserved due to their usefulness.
    • imports: modifies web named exports to provide esm and cjs exports instead of minified bundle. The web bundle was causing issues in bundled projects, and polyfills are no longer provided by default. Refer to the README (opens new window) for specifications on how to use the SDK for a web project.

    # 1.2.2 (opens new window) (2024-07-11)

    # Bug Fixes

    # 1.2.1 (opens new window) (2024-07-04)

    # Bug Fixes

    # 1.2.0 (opens new window) (2024-07-03)

    # Bug Fixes

    # Features

    # 1.1.1 (opens new window) (2024-06-06)

    # Bug Fixes

    # 1.1.0 (opens new window) (2024-06-03)

    # Bug Fixes

    # Features

    # 1.0.8 (opens new window) (2024-05-29)

    # Bug Fixes

    # 1.0.7 (opens new window) (2024-05-23)

    # Bug Fixes

    # 1.0.6 (opens new window) (2024-05-07)

    # Bug Fixes

    # 1.0.5 (opens new window) (2024-05-02)

    # Bug Fixes

    # 1.0.4 (opens new window) (2024-04-30)

    # Bug Fixes

    # 1.0.3 (opens new window) (2024-04-26)

    # Bug Fixes

    # 1.0.2 (opens new window) (2024-04-25)

    # Bug Fixes

    # 1.0.1 (opens new window) (2024-04-23)

    # Bug Fixes

    # 1.0.0 (2024-04-23)

    # Bug Fixes

    # Features

    - + diff --git a/index.html b/index.html index 5193bd26..f971ccf0 100644 --- a/index.html +++ b/index.html @@ -20,11 +20,11 @@ - +
    ar.io Docs

    # Welcome to the Permaweb

    Data in paradise. The AR.IO ecosystem is dedicated to cultivating products and protocols for sustaining access to digital permanence, making the permaweb available to everyone. Powered by the IO Token, this global network of Gateways connects users to permanently stored data, files, applications, and web pages on the Arweave decentralized storage network.


    ar.io = Arweave Input & Output



    Questions? Join our Discord

    Discord Icon ar.io Discord
    - + diff --git a/introduction/index.html b/introduction/index.html index bc755e1c..b33a266e 100644 --- a/introduction/index.html +++ b/introduction/index.html @@ -20,11 +20,11 @@ - +
    ar.io Docs

    # Introduction

    # TL;DR

    The goal of AR.IO is to create a decentralized and incentivized gateway network aimed at attracting more gateways to the Arweave network therefore making the permaweb more accessible to all. At the core of AR.IO’s incentivization mechanism is the IO Token, a utility token used for joining the network, payments, and protocol incentives. The network features modular and composable gateway infrastructure in addition to the Arweave Name System (ArNS) – a system for assigning friendly domain names to permaweb data.

    # What is AR.IO

    AR.IO is a global network, protocol, and currency that enables the permaweb. It is the decentralized and incentivized gateway node network of the Arweave ecosystem. Comprised of operators, developers, and end users, this network leverages a utility token to proliferate access to the permaweb: the files, applications, web pages and data permanently stored on the Arweave decentralized storage network.

    The various nodes on the AR.IO Network, known as gateways, are the interface between users and the permaweb. Each gateway acts like a “Permaweb Service Provider” and supports multiple, value-added, services like reading, writing, querying, and indexing of Arweave data.

    The AR.IO token, referred to as IO or ɸ, is an aoComputer based token used for protocol incentives, gateway accountability, and payments for services like the Arweave Name System (ArNS). It will enable gateways on the AR.IO Network to operate under a low-trust model with the users of their service.

    # Why AR.IO ?

    Arweave (a Layer 1 blockchain network) offers scalable and permanent on-chain data storage in a sustainable manner. It does this by incentivizing miner nodes through a tokenomic endowment model which ensures data is globally stored and replicated for hundreds of years without the need for continual payment by its uploader.

    However, this Layer 1 protocol does not incorporate all the needs of permaweb applications like data indexing, querying, retrieval, and other vital services. Consequently, over the pasts few years, infrastructure services have been independently developed and deployed to meet the demands of the permaweb at scale. Users and apps have come to rely on these gateway utilities, but they are closed source, have complex codebases, and are expensive to operate.

    Arweave also does not offer any tokenomic incentives to offset the expenses associated with operating a gateway, which has led to the community’s reliance on a single centrally controlled gateway subsidized for the betterment of the network: arweave.net. While arweave.net currently caches and indexes the entire weave with a high quality of service, it is a single bottleneck for the whole ecosystem.

    AR.IO seeks to reduce the barriers of entry and attract more gateway operators to the permaweb with the goal of further enhancing its overall health, resiliency, and functionality through decentralized mechanisms that are as trustless as possible.

    The solution will be applied in two directions:

    1. By reducing gateway overhead costs with open source, efficient modular networked architecture.

    2. By creating an economic incentive layer with the IO Token.

    Our goal is to create a framework for a healthy and sustainable decentralized gateway network.

    - + diff --git a/labs/index.html b/labs/index.html index a0fbaf9b..9820b63e 100644 --- a/labs/index.html +++ b/labs/index.html @@ -20,11 +20,11 @@ - +
    ar.io Docs

    # AR.IO Labs

    # What is AR.IO Labs?

    AR.IO Labs serves as the for-profit arm of the AR.IO ecosystem, playing a crucial role in driving innovation, commercial development, and entrepreneurial initiatives. While the AR.IO Foundation focuses on the non-profit aspects and sustenance of the AR.IO Network, AR.IO Labs is geared towards harnessing the network's potential to create profitable ventures and cutting-edge products.

    Key focuses of AR.IO Labs include:

    • Innovation and research

    • Commercial development

    • Incubation of startups

    • Collaboration with external entities

    • Token and asset management

    • Revenue generation for ecosystem sustainability

    • Adoption and marketing

    • Resilience and growth

    As the for-profit arm of the AR.IO ecosystem, AR.IO Labs works in tandem with the AR.IO Foundation to create a sustainable and flourishing decentralized network that thrives both commercially and altruistically, fostering a balanced and impactful presence within the blockchain and decentralized technology landscape.

    - + diff --git a/manifests/index.html b/manifests/index.html index 835f0e21..d2da43c6 100644 --- a/manifests/index.html +++ b/manifests/index.html @@ -20,7 +20,7 @@ - + @@ -105,6 +105,6 @@ } }

    The paths attribute is an object that defines the url paths that a manifest can resolve to. If a user navigates to manifest/index.html the resolver will look for index.html as a key in the paths object and return the corresponding id. (cG7Hdi_iTQPoEYgQJFqJ8NMpN4KoZ-vH_j7pG4iP7NI)

    - + diff --git a/sdk/index.html b/sdk/index.html index 4f30611a..1f5de4de 100644 --- a/sdk/index.html +++ b/sdk/index.html @@ -20,7 +20,7 @@ - + @@ -653,6 +653,6 @@ hasMore = page.hasMore; }

    # Developers

    # Requirements

    • node >= v18.0.0
    • npm or yarn
    • docker (recommended for testing)

    # Setup & Build

    • nvm use - use the correct node version
    • yarn install - installs dependencies
    • yarn build - builds web/node/bundled outputs

    # Testing

    • yarn test:integration - runs integration tests against a local arns-service (opens new window)
    • yarn example:web - opens up the example web page
    • yarn example:cjs - runs example CJS node script
    • yarn example:esm - runs example ESM node script

    # Linting & Formatting

    • yarn lint:check - checks for linting errors
    • yarn lint:fix - fixes linting errors
    • yarn format:check - checks for formatting errors
    • yarn format:fix - fixes formatting errors

    # Architecture

    • Code to interfaces.
    • Prefer type safety over runtime safety.
    • Prefer composition over inheritance.
    • Prefer integration tests over unit tests.
    - + diff --git a/token/index.html b/token/index.html index dd85e5e4..37270684 100644 --- a/token/index.html +++ b/token/index.html @@ -20,11 +20,11 @@ - +
    ar.io Docs

    # The IO Token

    NOTE: The IO Token and its associated functions are still in development and have not yet been released.

    # Overview

    IO is the multifunction aoComputer based token that powers The AR.IO Network and its suite of permaweb applications. The IO Token (ɸ) has many uses, including:

    • Protocol incentives,

    • Staking by gateways,

    • Payments for services like the Arweave Name System (ArNS),

    • Gateway delegated staking

    The token acts as a permissionless and censorship resistant medium of common value for the network.

    - + diff --git a/troubleshooting-observer/index.html b/troubleshooting-observer/index.html index 03178cbc..6d46d4ef 100644 --- a/troubleshooting-observer/index.html +++ b/troubleshooting-observer/index.html @@ -20,7 +20,7 @@ - + @@ -30,6 +30,6 @@ dd2e0b64b0b4 redis:7 "docker-entrypoint.s…" 10 days ago Up 2 days 0.0.0.0:6379->6379/tcp, :::6379->6379/tcp ar-io-node_redis_1 ed98aba1c4f6 ghcr.io/ar-io/ar-io-observer:6449bcb6dda778fef68a94bd29343190524439db "/nodejs/bin/node ./…" 10 days ago Up 2 days (healthy) 0.0.0.0:5000->5000/tcp, :::5000->5000/tcp ar-io-node_observer_1

    If the line for observer does not say "up", then your observer is not running. You should restart your gateway, and then watch your observer logs to get a better idea of why your observer stopped:

    sudo docker-compose down

    sudo docker-compose up -d

    sudo docker-compose logs -f observer

    # Observer wallet has no AR

    #

    Your Observer Wallet does not have any AR tokens.

    Your observer wallet needs to be able to submit reports to the Arweave blockchain. To do this, it needs to have a small amount of AR tokens in order to pay for the submission. ar.io recommends depositing 1 AR token into your observer wallet to ensure that you remain funded throughout the entire testnet.

    # Observer wallet ... does not match the 'observerWallet' set on the gateway ...

    #

    The observer wallet set locally on your gateway does not match the observer wallet for your gateway in the ar.io network.

    Check to make sure that you have OBSERVER_WALLET set in your .env file, and that the keyfile for your observer wallet is properly provided in the wallets directory in your gateway.

    You will need to restart your gateway if you make any changes to the .env file or your observer wallet keyfile.

    Then check to make sure that the value for observerWallet on your gateway in the testnet contract (opens new window) matches that.

    This video (opens new window) shows exactly what should be done to correct it if it does not.

    # Uncertain - confirm your OBSERVER_WALLET is set in the .env file and corresponding wallet is located in wallets/< address >.json...

    #

    The cause for the error could not be reliably determined.

    "Uncertain" is the default value returned when evaluating a failed observer. It means that none of the above error messages perfectly matched the problems with your gateway.

    You should first ensure that your observer wallet is set correctly locally (opens new window), and then check your observer logs for any additional error messages.

    sudo docker-compose logs -f --tail=50 observer

    - + diff --git a/troubleshooting/index.html b/troubleshooting/index.html index c51aa162..6714ea59 100644 --- a/troubleshooting/index.html +++ b/troubleshooting/index.html @@ -20,7 +20,7 @@ - + @@ -41,6 +41,6 @@

    Certbot SSL certificates expire after 90 days, and you will need to rerun this command to renew every time. If you provide an email address, you will receive an email letting you know when it is time to renew.


    # I am having Trouble Getting my Gateway Set up


    #

    I set my gateway up, but when I go to my domain I get a 404/Nginx error

    If you navigate to your domain and see a 404 error from Nginx (the reverse proxy server used in the setup guide) it means that your domain is correctly pointed at the machine running your gateway, but you have not properly configured your Nginx settings (or your gateway is not running).

    The Set up Networking section of the setup guide has detailed instructions on configuring your Nginx server. If all else fails, try restarting Nginx, that usually clears any issues with the server clinging to old configurations.

    sudo service nginx restart

    #

    When I visit my domain I see a 502 error from Nginx

    A 502 error from Nginx means that Nginx is working correctly, but it is receiving an error from your gateway when it tries to forward traffic.

    #

    I am having trouble generating my SSL certificates

    When using the manual certbot command provided in the setup guide:

    sudo certbot certonly --manual --preferred-challenges dns --email <your-email-address> -d <your-domain>.com -d '*.<your-domain>.com'

    You need to be sure that you are waiting after creating your TXT records for them to completely propagate. You can check propagation using a tool like dnschecker.org (opens new window).

    If you continue to have issues, you can check the official certbot instructions guide (opens new window).


    If you do not see your issue listed here, or if you were not able to solve your problem with the above information, feel free to reach out in the ar.io discord.

    # Quick Lookup

    Below is a quick summary of what you should check when troubleshooting your gateway. Find more detailed information in the sections above.

    Issue What to Check
    My release number is wrong Pull the latest github updates and make sure you are on the main branch
    Gateway appears offline on Viewblock or ar://gateways Probably fine, but verify that your gateway is still running.
    '/ar-io/observer/reports/current' just says "report pending" Normal behavior, wait for the report to complete.
    Observer error "Cannot read properties of undefined" Normal behavior, Observer is checking for data not implemented yet.
    Observing my gateway shows failures Check AR_IO_WALLET and ARNS_ROOT_HOST settings.
    Updated .env settings not reflected on gateway Rebuild your gateway after editing .env file.
    Out of disk space error Check for inode exhaustion and delete files if necessary.
    Can't load ArNS names Check ARNS_ROOT_HOST setting in .env file, and DNS records.
    "Your connection is not private" error Generate or renew SSL certificates.
    404/Nginx error when accessing domain Check Nginx settings and restart Nginx if necessary.
    502 error from Nginx Check for errors in your gateway.
    Trouble generating SSL certificates Ensure TXT records have propagated and follow certbot instructions.
    - + diff --git a/wayfinder/index.html b/wayfinder/index.html index fae18f5b..e754ff88 100644 --- a/wayfinder/index.html +++ b/wayfinder/index.html @@ -20,13 +20,13 @@ - +
    ar.io Docs

    # Wayfinder Protocol

    # Overview

    The Wayfinder protocol is a URI scheme (opens new window) designed to translate requests for Arweave content into https:// requests. Essentially, Wayfinder allows for transforming traditional Arweave URLs like https://arweave.net/long-txid into more concise and user-friendly forms such as ar://txid or ar://arns-name. When combined with the AR.IO WayFinder browser extension (opens new window), the request can be directed to any number of functional AR.IO Gateways to serve the content.

    An early technical breakdown of Wayfinder, formerly "ARCSS", created by Arweave community member DMac, can be found here (opens new window).

    # Browser Integration

    The Wayfinder Protocol is currently facilitated via the WayFinder App or internal application integration. The intention is to lead popular web browsers like Chrome and Brave towards a direct integration of the Wayfinder Protocol, similar to recent integrations of the ipfs:// protocol. Such integration would remove the need for a client-side extension and boost developers' confidence in embedding Wayfinder Protocol URLs in their websites.

    # Internal Application Integration

    Certain websites or apps may want to resolve Arweave Transaction ID's (TxId) internally. In these scenarios, they can process the Wayfinder Protocol internally without depending on browser support or the WayFinder App. A prime example is opensea.io (opens new window). Opensea, an NFT marketplace, frequently imports NFT metadata from external sources. If metadata employs the Wayfinder Protocol, Opensea internally resolves these, presenting content without redirecting users through an https:// link.

    There are two main approaches to resolving Wayfinder Protocol URLs:

    1. Convert Wayfinder into a request directed at a predefined Arweave gateway.
    2. Retrieve a list of active AR.IO Gateways from the GAR by reading the contract state, or other available resources, and then fetch content from a gateway on the list.

    Each strategy has its benefits and challenges, necessitating careful evaluation based on specific use cases.

    Using the Wayfinder Protocol offers several advantages over hardcoded links to a specific gateway:

    1. Flexibility: Wayfinder links can be routed through any available AR.IO Gateway, ensuring content remains accessible even if a specific gateway is down or congested.
    2. Decentralization: By not being tied to a single gateway, the Wayfinder Protocol embodies the decentralized spirit of the web, reducing potential censorship points.
    3. Ease of Maintenance: Developers and content creators don't need to modify links if a gateway changes its URL or becomes unavailable. The WayFinder extension handles routing to an active gateway.
    4. Consistency: Users always receive the same content, regardless of the gateway used, ensuring a consistent user experience.

    # Use Cases

    # Decentralized Web Hosting with Flexible Access

    With Wayfinder, not only can websites be hosted on the Arweave network, but their accessibility is also enhanced. By using the Wayfinder Protocol, web developers can ensure that if a specific AR.IO Gateway is down, the content can still be accessed through another gateway, offering a more reliable and resilient user experience.

    # Digital Archives and Preservation with Enhanced Sharing

    Digitally archiving public domain works, especially in light of events like "banned books week" (opens new window), becomes more efficient with Wayfinder. Historical institutions or enthusiasts can easily share specific Wayfinder links to documents or media. Unlike hardcoded links which might break if a specific gateway goes offline, Wayfinder ensures that the content remains consistently accessible.

    # Media Sharing Platforms with Consistent Content Delivery

    For platforms hosting user-generated content, the Wayfinder Protocol provides not just decentralized hosting but also a guarantee of content delivery. Even if a content piece becomes viral and one gateway gets congested, Wayfinder ensures that users can still access the content through another gateway, providing a seamless experience.

    # Decentralized Applications (DApps) with Reliable Front-End Accessibility

    DApps, while benefiting from Arweave's permanent hosting, can further ensure their front-end remains consistently accessible to users by using Wayfinder. If a DApp's front-end is accessed frequently, causing strain on one gateway, Wayfinder can help ensure the load is distributed, and the DApp remains online and functional.

    # How it Works

    # Transaction ID

    To access content tied to an Arweave Transaction ID (TxId), simply append the TxId to ar://:

    ar://qI19W6spw-kzOGl4qUMNp2gwFH2EBfDXOFsjkcNyK9A

    Inputting this into a WayFinder-equipped browser will route your request through the right AR.IO Gateway, translating it as per your Routing Method settings.

    # ArNS

    Fetching content via an Arweave Name System (ArNS) name is straightforward. Attach the ArNS name to ar://:

    ar://good-morning

    The Wayfinder protocol, along with the WayFinder App, discerns between TxIds and ArNS names. Once the suitable https:// request is formulated, the chosen gateway translates the ArNS name based on the ArNS aoComputer contract.

    # Wayfinder App

    The AR.IO WayFinder App (opens new window) is a browser extension designed to facilitate the resolving of ar:// urls.

    # v0.0.10

    As of v0.0.10, Wayfinder supports the resolution of TXT records to Arweave content on top level domains. This innovative feature leverages DNS TXT records to associate Arweave transaction IDs with human-readable domain names, facilitating intuitive and memorable access to permaweb content. By simply entering an ar:// URL with a domain name, the Wayfinder App resolves the corresponding Arweave transaction ID through DNS TXT records, redirecting users directly to the content hosted on the Arweave network.

    Setup: Owners of a domain can set a TXT record for that domain following the format ARTX <Arweave TXID>.

    Wayfinder Redirection: With a TXT record set properly, whenever a user (who has Wayfinder installed) enters an ar:// URL containing a domain name (e.g., ar://example.com), the Wayfinder App performs a DNS lookup for that TXT record in order to redirect to the Arweave content. The lookup is completed through a secure DNS-over-HTTPS query to ensure privacy and integrity.

    Dynamic Content Resolution: After retrieving the TXT record, the Wayfinder App extracts that Arweave transaction ID and dynamically redirects the user to the content on the permaweb. This process is transparent to the user, providing a seamless experience as if accessing a traditional website.

    # Key Features

    • Gasless: TXT records can be set without any onchain transactions that would require gas fees.
    • Easy Integration: Domain owners can easily link their permaweb content to their domains, making it accessible through a simple ar:// URL.
    • Dyncamic Content Access: Content links can be updated in real-time through DNS TXT records, without requiring any changes to the ar:// URL itself.
    • Enhanced User Experience: Offers users a familiar and easy-to-remember way to access permaweb content, leveraging standard web domain names.
    • Security and Privacy: Secure DNS-over-HTTPS queries for DNS lookups protect user privacy and enhances security.

    # Use Cases

    • Branded Content Access: Companies and individuals can brand their permaweb content, making it accessible through their domain, enhancing brand visibility and user trust.
    • Dynamic Content Updates: Domain owners can easily update what Permaweb content their AR:// URL resolves to, which is ideal for frequently updated resources like documents, blogs, and application interfaces.
    • Educational and Informational Resources: Educational institutions and information providers can make their resources permanently available on the permaweb, accessible through simple, memorable URLs.

    This feature marks a significant advancement in making decentralized content more accessible and user-friendly, bridging the gap between traditional internet usability and the permaweb’s permanence and censorship-resistant nature.

    - +