diff --git a/404.html b/404.html index 72275f43c3f9..62e04064bb8a 100644 --- a/404.html +++ b/404.html @@ -18,14 +18,14 @@ - - + +
Skip to main content

Page Not Found

We could not find what you were looking for.

Please contact the owner of the site that linked you to the original URL and let them know their link is broken.

- + \ No newline at end of file diff --git a/assets/css/styles.6e82c68f.css b/assets/css/styles.6e82c68f.css deleted file mode 100644 index 845ed4cb9e5e..000000000000 --- a/assets/css/styles.6e82c68f.css +++ /dev/null @@ -1 +0,0 @@ -.col,.container{padding:0 var(--ifm-spacing-horizontal);width:100%}.markdown>h2,.markdown>h3,.markdown>h4,.markdown>h5,.markdown>h6{margin-bottom:calc(var(--ifm-heading-vertical-rhythm-bottom)*var(--ifm-leading))}pre,table{overflow:auto}blockquote,pre{margin:0 0 var(--ifm-spacing-vertical)}.breadcrumbs__link,.button{transition-timing-function:var(--ifm-transition-timing-default)}.DocSearch-Button,.button{-webkit-user-select:none;-moz-user-select:none}.button,code{vertical-align:middle}.button--outline.button--active,.button--outline:active,.button--outline:hover,:root{--ifm-button-color:var(--ifm-font-color-base-inverse)}.dropdown,pre{position:relative}.menu__link:hover,a{transition:color var(--ifm-transition-fast) var(--ifm-transition-timing-default)}.navbar--dark,:root{--ifm-navbar-link-hover-color:var(--ifm-color-primary)}.menu,.navbar-sidebar{overflow-x:hidden}:root,html[data-theme=dark]{--ifm-color-emphasis-500:var(--ifm-color-gray-500)}.markdown li,body{word-wrap:break-word}.toggleButton_gllP,html{-webkit-tap-highlight-color:transparent}*,.DocSearch-Container,.DocSearch-Container *{box-sizing:border-box}:root{--ifm-color-scheme:light;--ifm-dark-value:10%;--ifm-darker-value:15%;--ifm-darkest-value:30%;--ifm-light-value:15%;--ifm-lighter-value:30%;--ifm-lightest-value:50%;--ifm-contrast-background-value:90%;--ifm-contrast-foreground-value:70%;--ifm-contrast-background-dark-value:70%;--ifm-contrast-foreground-dark-value:90%;--ifm-color-primary:#3578e5;--ifm-color-secondary:#ebedf0;--ifm-color-success:#00a400;--ifm-color-info:#54c7ec;--ifm-color-warning:#ffba00;--ifm-color-danger:#fa383e;--ifm-color-primary-dark:#306cce;--ifm-color-primary-darker:#2d66c3;--ifm-color-primary-darkest:#2554a0;--ifm-color-primary-light:#538ce9;--ifm-color-primary-lighter:#72a1ed;--ifm-color-primary-lightest:#9abcf2;--ifm-color-primary-contrast-background:#ebf2fc;--ifm-color-primary-contrast-foreground:#102445;--ifm-color-secondary-dark:#d4d5d8;--ifm-color-secondary-darker:#c8c9cc;--ifm-color-secondary-darkest:#a4a6a8;--ifm-color-secondary-light:#eef0f2;--ifm-color-secondary-lighter:#f1f2f5;--ifm-color-secondary-lightest:#f5f6f8;--ifm-color-secondary-contrast-background:#fdfdfe;--ifm-color-secondary-contrast-foreground:#474748;--ifm-color-success-dark:#009400;--ifm-color-success-darker:#008b00;--ifm-color-success-darkest:#007300;--ifm-color-success-light:#26b226;--ifm-color-success-lighter:#4dbf4d;--ifm-color-success-lightest:#80d280;--ifm-color-success-contrast-background:#e6f6e6;--ifm-color-success-contrast-foreground:#003100;--ifm-color-info-dark:#4cb3d4;--ifm-color-info-darker:#47a9c9;--ifm-color-info-darkest:#3b8ba5;--ifm-color-info-light:#6ecfef;--ifm-color-info-lighter:#87d8f2;--ifm-color-info-lightest:#aae3f6;--ifm-color-info-contrast-background:#eef9fd;--ifm-color-info-contrast-foreground:#193c47;--ifm-color-warning-dark:#e6a700;--ifm-color-warning-darker:#d99e00;--ifm-color-warning-darkest:#b38200;--ifm-color-warning-light:#ffc426;--ifm-color-warning-lighter:#ffcf4d;--ifm-color-warning-lightest:#ffdd80;--ifm-color-warning-contrast-background:#fff8e6;--ifm-color-warning-contrast-foreground:#4d3800;--ifm-color-danger-dark:#e13238;--ifm-color-danger-darker:#d53035;--ifm-color-danger-darkest:#af272b;--ifm-color-danger-light:#fb565b;--ifm-color-danger-lighter:#fb7478;--ifm-color-danger-lightest:#fd9c9f;--ifm-color-danger-contrast-background:#ffebec;--ifm-color-danger-contrast-foreground:#4b1113;--ifm-color-white:#fff;--ifm-color-black:#000;--ifm-color-gray-0:var(--ifm-color-white);--ifm-color-gray-100:#f5f6f7;--ifm-color-gray-200:#ebedf0;--ifm-color-gray-300:#dadde1;--ifm-color-gray-400:#ccd0d5;--ifm-color-gray-500:#bec3c9;--ifm-color-gray-600:#8d949e;--ifm-color-gray-700:#606770;--ifm-color-gray-800:#444950;--ifm-color-gray-900:#1c1e21;--ifm-color-gray-1000:var(--ifm-color-black);--ifm-color-emphasis-0:var(--ifm-color-gray-0);--ifm-color-emphasis-100:var(--ifm-color-gray-100);--ifm-color-emphasis-200:var(--ifm-color-gray-200);--ifm-color-emphasis-300:var(--ifm-color-gray-300);--ifm-color-emphasis-400:var(--ifm-color-gray-400);--ifm-color-emphasis-600:var(--ifm-color-gray-600);--ifm-color-emphasis-700:var(--ifm-color-gray-700);--ifm-color-emphasis-800:var(--ifm-color-gray-800);--ifm-color-emphasis-900:var(--ifm-color-gray-900);--ifm-color-emphasis-1000:var(--ifm-color-gray-1000);--ifm-color-content:var(--ifm-color-emphasis-900);--ifm-color-content-inverse:var(--ifm-color-emphasis-0);--ifm-color-content-secondary:#525860;--ifm-background-color:transparent;--ifm-background-surface-color:var(--ifm-color-content-inverse);--ifm-global-border-width:1px;--ifm-global-radius:0.4rem;--ifm-hover-overlay:rgba(0,0,0,.05);--ifm-font-color-base:var(--ifm-color-content);--ifm-font-color-base-inverse:var(--ifm-color-content-inverse);--ifm-font-color-secondary:var(--ifm-color-content-secondary);--ifm-font-family-base:system-ui,-apple-system,Segoe UI,Roboto,Ubuntu,Cantarell,Noto Sans,sans-serif,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol";--ifm-font-family-monospace:SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",monospace;--ifm-font-size-base:100%;--ifm-font-weight-light:300;--ifm-font-weight-normal:400;--ifm-font-weight-semibold:500;--ifm-font-weight-bold:700;--ifm-font-weight-base:var(--ifm-font-weight-normal);--ifm-line-height-base:1.65;--ifm-global-spacing:1rem;--ifm-spacing-vertical:var(--ifm-global-spacing);--ifm-spacing-horizontal:var(--ifm-global-spacing);--ifm-transition-fast:200ms;--ifm-transition-slow:400ms;--ifm-transition-timing-default:cubic-bezier(0.08,0.52,0.52,1);--ifm-global-shadow-lw:0 1px 2px 0 rgba(0,0,0,.1);--ifm-global-shadow-md:0 5px 40px rgba(0,0,0,.2);--ifm-global-shadow-tl:0 12px 28px 0 rgba(0,0,0,.2),0 2px 4px 0 rgba(0,0,0,.1);--ifm-z-index-dropdown:100;--ifm-z-index-fixed:200;--ifm-z-index-overlay:400;--ifm-container-width:1140px;--ifm-container-width-xl:1320px;--ifm-code-background:#f6f7f8;--ifm-code-border-radius:var(--ifm-global-radius);--ifm-code-font-size:90%;--ifm-code-padding-horizontal:0.1rem;--ifm-code-padding-vertical:0.1rem;--ifm-pre-background:var(--ifm-code-background);--ifm-pre-border-radius:var(--ifm-code-border-radius);--ifm-pre-color:inherit;--ifm-pre-line-height:1.45;--ifm-pre-padding:1rem;--ifm-heading-color:inherit;--ifm-heading-margin-top:0;--ifm-heading-margin-bottom:var(--ifm-spacing-vertical);--ifm-heading-font-family:var(--ifm-font-family-base);--ifm-heading-font-weight:var(--ifm-font-weight-bold);--ifm-heading-line-height:1.25;--ifm-h1-font-size:2rem;--ifm-h2-font-size:1.5rem;--ifm-h3-font-size:1.25rem;--ifm-h4-font-size:1rem;--ifm-h5-font-size:0.875rem;--ifm-h6-font-size:0.85rem;--ifm-image-alignment-padding:1.25rem;--ifm-leading-desktop:1.25;--ifm-leading:calc(var(--ifm-leading-desktop)*1rem);--ifm-list-left-padding:2rem;--ifm-list-margin:1rem;--ifm-list-item-margin:0.25rem;--ifm-list-paragraph-margin:1rem;--ifm-table-cell-padding:0.75rem;--ifm-table-background:transparent;--ifm-table-stripe-background:rgba(0,0,0,.03);--ifm-table-border-width:1px;--ifm-table-border-color:var(--ifm-color-emphasis-300);--ifm-table-head-background:inherit;--ifm-table-head-color:inherit;--ifm-table-head-font-weight:var(--ifm-font-weight-bold);--ifm-table-cell-color:inherit;--ifm-link-color:var(--ifm-color-primary);--ifm-link-decoration:none;--ifm-link-hover-color:var(--ifm-link-color);--ifm-link-hover-decoration:underline;--ifm-paragraph-margin-bottom:var(--ifm-leading);--ifm-blockquote-font-size:var(--ifm-font-size-base);--ifm-blockquote-border-left-width:2px;--ifm-blockquote-padding-horizontal:var(--ifm-spacing-horizontal);--ifm-blockquote-padding-vertical:0;--ifm-blockquote-shadow:none;--ifm-blockquote-color:var(--ifm-color-emphasis-800);--ifm-blockquote-border-color:var(--ifm-color-emphasis-300);--ifm-hr-background-color:var(--ifm-color-emphasis-500);--ifm-hr-height:1px;--ifm-hr-margin-vertical:1.5rem;--ifm-scrollbar-size:7px;--ifm-scrollbar-track-background-color:#f1f1f1;--ifm-scrollbar-thumb-background-color:silver;--ifm-scrollbar-thumb-hover-background-color:#a7a7a7;--ifm-alert-background-color:inherit;--ifm-alert-border-color:inherit;--ifm-alert-border-radius:var(--ifm-global-radius);--ifm-alert-border-width:0px;--ifm-alert-border-left-width:5px;--ifm-alert-color:var(--ifm-font-color-base);--ifm-alert-padding-horizontal:var(--ifm-spacing-horizontal);--ifm-alert-padding-vertical:var(--ifm-spacing-vertical);--ifm-alert-shadow:var(--ifm-global-shadow-lw);--ifm-avatar-intro-margin:1rem;--ifm-avatar-intro-alignment:inherit;--ifm-avatar-photo-size:3rem;--ifm-badge-background-color:inherit;--ifm-badge-border-color:inherit;--ifm-badge-border-radius:var(--ifm-global-radius);--ifm-badge-border-width:var(--ifm-global-border-width);--ifm-badge-color:var(--ifm-color-white);--ifm-badge-padding-horizontal:calc(var(--ifm-spacing-horizontal)*0.5);--ifm-badge-padding-vertical:calc(var(--ifm-spacing-vertical)*0.25);--ifm-breadcrumb-border-radius:1.5rem;--ifm-breadcrumb-spacing:0.5rem;--ifm-breadcrumb-color-active:var(--ifm-color-primary);--ifm-breadcrumb-item-background-active:var(--ifm-hover-overlay);--ifm-breadcrumb-padding-horizontal:0.8rem;--ifm-breadcrumb-padding-vertical:0.4rem;--ifm-breadcrumb-size-multiplier:1;--ifm-breadcrumb-separator:url('data:image/svg+xml;utf8,');--ifm-breadcrumb-separator-filter:none;--ifm-breadcrumb-separator-size:0.5rem;--ifm-breadcrumb-separator-size-multiplier:1.25;--ifm-button-background-color:inherit;--ifm-button-border-color:var(--ifm-button-background-color);--ifm-button-border-width:var(--ifm-global-border-width);--ifm-button-font-weight:var(--ifm-font-weight-bold);--ifm-button-padding-horizontal:1.5rem;--ifm-button-padding-vertical:0.375rem;--ifm-button-size-multiplier:1;--ifm-button-transition-duration:var(--ifm-transition-fast);--ifm-button-border-radius:calc(var(--ifm-global-radius)*var(--ifm-button-size-multiplier));--ifm-button-group-spacing:2px;--ifm-card-background-color:var(--ifm-background-surface-color);--ifm-card-border-radius:calc(var(--ifm-global-radius)*2);--ifm-card-horizontal-spacing:var(--ifm-global-spacing);--ifm-card-vertical-spacing:var(--ifm-global-spacing);--ifm-toc-border-color:var(--ifm-color-emphasis-300);--ifm-toc-link-color:var(--ifm-color-content-secondary);--ifm-toc-padding-vertical:0.5rem;--ifm-toc-padding-horizontal:0.5rem;--ifm-dropdown-background-color:var(--ifm-background-surface-color);--ifm-dropdown-font-weight:var(--ifm-font-weight-semibold);--ifm-dropdown-link-color:var(--ifm-font-color-base);--ifm-dropdown-hover-background-color:var(--ifm-hover-overlay);--ifm-footer-background-color:var(--ifm-color-emphasis-100);--ifm-footer-color:inherit;--ifm-footer-link-color:var(--ifm-color-emphasis-700);--ifm-footer-link-hover-color:var(--ifm-color-primary);--ifm-footer-link-horizontal-spacing:0.5rem;--ifm-footer-padding-horizontal:calc(var(--ifm-spacing-horizontal)*2);--ifm-footer-padding-vertical:calc(var(--ifm-spacing-vertical)*2);--ifm-footer-title-color:inherit;--ifm-footer-logo-max-width:min(30rem,90vw);--ifm-hero-background-color:var(--ifm-background-surface-color);--ifm-hero-text-color:var(--ifm-color-emphasis-800);--ifm-menu-color:var(--ifm-color-emphasis-700);--ifm-menu-color-active:var(--ifm-color-primary);--ifm-menu-color-background-active:var(--ifm-hover-overlay);--ifm-menu-color-background-hover:var(--ifm-hover-overlay);--ifm-menu-link-padding-horizontal:0.75rem;--ifm-menu-link-padding-vertical:0.375rem;--ifm-menu-link-sublist-icon:url('data:image/svg+xml;utf8,');--ifm-menu-link-sublist-icon-filter:none;--ifm-navbar-background-color:var(--ifm-background-surface-color);--ifm-navbar-height:3.75rem;--ifm-navbar-item-padding-horizontal:0.75rem;--ifm-navbar-item-padding-vertical:0.25rem;--ifm-navbar-link-color:var(--ifm-font-color-base);--ifm-navbar-link-active-color:var(--ifm-link-color);--ifm-navbar-padding-horizontal:var(--ifm-spacing-horizontal);--ifm-navbar-padding-vertical:calc(var(--ifm-spacing-vertical)*0.5);--ifm-navbar-shadow:var(--ifm-global-shadow-lw);--ifm-navbar-search-input-background-color:var(--ifm-color-emphasis-200);--ifm-navbar-search-input-color:var(--ifm-color-emphasis-800);--ifm-navbar-search-input-placeholder-color:var(--ifm-color-emphasis-500);--ifm-navbar-search-input-icon:url('data:image/svg+xml;utf8,');--ifm-navbar-sidebar-width:83vw;--ifm-pagination-border-radius:var(--ifm-global-radius);--ifm-pagination-color-active:var(--ifm-color-primary);--ifm-pagination-font-size:1rem;--ifm-pagination-item-active-background:var(--ifm-hover-overlay);--ifm-pagination-page-spacing:0.2em;--ifm-pagination-padding-horizontal:calc(var(--ifm-spacing-horizontal)*1);--ifm-pagination-padding-vertical:calc(var(--ifm-spacing-vertical)*0.25);--ifm-pagination-nav-border-radius:var(--ifm-global-radius);--ifm-pagination-nav-color-hover:var(--ifm-color-primary);--ifm-pills-color-active:var(--ifm-color-primary);--ifm-pills-color-background-active:var(--ifm-hover-overlay);--ifm-pills-spacing:0.125rem;--ifm-tabs-color:var(--ifm-font-color-secondary);--ifm-tabs-color-active:var(--ifm-color-primary);--ifm-tabs-color-active-border:var(--ifm-tabs-color-active);--ifm-tabs-padding-horizontal:1rem;--ifm-tabs-padding-vertical:1rem;--docusaurus-progress-bar-color:var(--ifm-color-primary);--ifm-color-primary:#e6007a;--ifm-color-primary-dark:#cf006e;--ifm-color-primary-darker:#c40068;--ifm-color-primary-darkest:#a10055;--ifm-color-primary-light:#fd0086;--ifm-color-primary-lighter:#ff0a8c;--ifm-color-primary-lightest:#ff2c9c;--secondaryColor:#172026;--snowColor:#efefef;--silverColor:#b7b8bb;--nickelColor:#6d7278;--blackColor:#000;--ifm-navbar-height:50px;--sansFontFamily:"Inter",sans-serif!important;--headingFontFamily:"Unbounded",sans-serif!important;--docsearch-searchbox-background:#fff;--docsearch-searchbox-shadow:var(--snowColor);--docusaurus-announcement-bar-height:auto!important;--custom-code-block-background:#f6f8fa;--custom-content-max-width:none;--docusaurus-announcement-bar-height:auto;--docusaurus-tag-list-border:var(--ifm-color-emphasis-300);--docusaurus-collapse-button-bg:transparent;--docusaurus-collapse-button-bg-hover:rgba(0,0,0,.1);--doc-sidebar-width:300px;--doc-sidebar-hidden-width:30px;--docsearch-primary-color:#5468ff;--docsearch-text-color:#1c1e21;--docsearch-spacing:12px;--docsearch-icon-stroke-width:1.4;--docsearch-highlight-color:var(--docsearch-primary-color);--docsearch-muted-color:#969faf;--docsearch-container-background:rgba(101,108,133,.8);--docsearch-logo-color:#5468ff;--docsearch-modal-width:560px;--docsearch-modal-height:600px;--docsearch-modal-background:#f5f6f7;--docsearch-modal-shadow:inset 1px 1px 0 0 hsla(0,0%,100%,.5),0 3px 8px 0 #555a64;--docsearch-searchbox-height:56px;--docsearch-searchbox-background:#ebedf0;--docsearch-searchbox-focus-background:#fff;--docsearch-searchbox-shadow:inset 0 0 0 2px var(--docsearch-primary-color);--docsearch-hit-height:56px;--docsearch-hit-color:#444950;--docsearch-hit-active-color:#fff;--docsearch-hit-background:#fff;--docsearch-hit-shadow:0 1px 3px 0 #d4d9e1;--docsearch-key-gradient:linear-gradient(-225deg,#d5dbe4,#f8f8f8);--docsearch-key-shadow:inset 0 -2px 0 0 #cdcde6,inset 0 0 1px 1px #fff,0 1px 2px 1px rgba(30,35,90,.4);--docsearch-footer-height:44px;--docsearch-footer-background:#fff;--docsearch-footer-shadow:0 -1px 0 0 #e0e3e8,0 -3px 6px 0 rgba(69,98,155,.12);--docsearch-primary-color:var(--ifm-color-primary);--docsearch-text-color:var(--ifm-font-color-base)}.badge--danger,.badge--info,.badge--primary,.badge--secondary,.badge--success,.badge--warning{--ifm-badge-border-color:var(--ifm-badge-background-color)}.button--link,.button--outline{--ifm-button-background-color:transparent}html{-webkit-font-smoothing:antialiased;-webkit-text-size-adjust:100%;-moz-text-size-adjust:100%;text-size-adjust:100%;background-color:var(--ifm-background-color);color:var(--ifm-font-color-base);color-scheme:var(--ifm-color-scheme);font:var(--ifm-font-size-base)/var(--ifm-line-height-base) var(--ifm-font-family-base);text-rendering:optimizelegibility}iframe{border:0;color-scheme:auto}.container{margin:0 auto;max-width:var(--ifm-container-width)}.container--fluid{max-width:inherit}.row{display:flex;flex-wrap:wrap;margin:0 calc(var(--ifm-spacing-horizontal)*-1)}.list_eTzJ article:last-child,.margin-bottom--none,.margin-vert--none,.markdown>:last-child{margin-bottom:0!important}.margin-top--none,.margin-vert--none,.tabItem_LNqP,footer .list-social-links li{margin-top:0!important}.row--no-gutters{margin-left:0;margin-right:0}.margin-horiz--none,.margin-right--none{margin-right:0!important}.row--no-gutters>.col{padding-left:0;padding-right:0}.row--align-top{align-items:flex-start}.row--align-bottom{align-items:flex-end}.menuExternalLink_NmtK,.row--align-center{align-items:center}.row--align-stretch{align-items:stretch}.row--align-baseline{align-items:baseline}.col{--ifm-col-width:100%;flex:1 0;margin-left:0;max-width:var(--ifm-col-width)}.padding-bottom--none,.padding-vert--none{padding-bottom:0!important}.padding-top--none,.padding-vert--none{padding-top:0!important}.padding-horiz--none,.padding-left--none{padding-left:0!important}.padding-horiz--none,.padding-right--none{padding-right:0!important}.col[class*=col--]{flex:0 0 var(--ifm-col-width)}.col--1{--ifm-col-width:8.33333%}.col--offset-1{margin-left:8.33333%}.col--2{--ifm-col-width:16.66667%}.col--offset-2{margin-left:16.66667%}.col--3{--ifm-col-width:25%}.col--offset-3{margin-left:25%}.col--4{--ifm-col-width:33.33333%}.col--offset-4{margin-left:33.33333%}.col--5{--ifm-col-width:41.66667%}.col--offset-5{margin-left:41.66667%}.col--6{--ifm-col-width:50%}.col--offset-6{margin-left:50%}.col--7{--ifm-col-width:58.33333%}.col--offset-7{margin-left:58.33333%}.col--8{--ifm-col-width:66.66667%}.col--offset-8{margin-left:66.66667%}.col--9{--ifm-col-width:75%}.col--offset-9{margin-left:75%}.col--10{--ifm-col-width:83.33333%}.col--offset-10{margin-left:83.33333%}.col--11{--ifm-col-width:91.66667%}.col--offset-11{margin-left:91.66667%}.col--12{--ifm-col-width:100%}.col--offset-12{margin-left:100%}.margin-horiz--none,.margin-left--none{margin-left:0!important}.margin--none{margin:0!important}.margin-bottom--xs,.margin-vert--xs{margin-bottom:.25rem!important}.margin-top--xs,.margin-vert--xs{margin-top:.25rem!important}.margin-horiz--xs,.margin-left--xs{margin-left:.25rem!important}.margin-horiz--xs,.margin-right--xs{margin-right:.25rem!important}.margin--xs{margin:.25rem!important}.margin-bottom--sm,.margin-vert--sm{margin-bottom:.5rem!important}.margin-top--sm,.margin-vert--sm{margin-top:.5rem!important}.margin-horiz--sm,.margin-left--sm{margin-left:.5rem!important}.margin-horiz--sm,.margin-right--sm{margin-right:.5rem!important}.margin--sm{margin:.5rem!important}.margin-bottom--md,.margin-vert--md{margin-bottom:1rem!important}.margin-top--md,.margin-vert--md{margin-top:1rem!important}.margin-horiz--md,.margin-left--md{margin-left:1rem!important}.margin-horiz--md,.margin-right--md{margin-right:1rem!important}.margin--md{margin:1rem!important}.margin-bottom--lg,.margin-vert--lg{margin-bottom:2rem!important}.margin-top--lg,.margin-vert--lg{margin-top:2rem!important}.margin-horiz--lg,.margin-left--lg{margin-left:2rem!important}.margin-horiz--lg,.margin-right--lg{margin-right:2rem!important}.margin--lg{margin:2rem!important}.margin-bottom--xl,.margin-vert--xl{margin-bottom:5rem!important}.margin-top--xl,.margin-vert--xl{margin-top:5rem!important}.margin-horiz--xl,.margin-left--xl{margin-left:5rem!important}.margin-horiz--xl,.margin-right--xl{margin-right:5rem!important}.margin--xl{margin:5rem!important}.padding--none{padding:0!important}.padding-bottom--xs,.padding-vert--xs{padding-bottom:.25rem!important}.padding-top--xs,.padding-vert--xs{padding-top:.25rem!important}.padding-horiz--xs,.padding-left--xs{padding-left:.25rem!important}.padding-horiz--xs,.padding-right--xs{padding-right:.25rem!important}.padding--xs{padding:.25rem!important}.padding-bottom--sm,.padding-vert--sm{padding-bottom:.5rem!important}.padding-top--sm,.padding-vert--sm{padding-top:.5rem!important}.padding-horiz--sm,.padding-left--sm{padding-left:.5rem!important}.padding-horiz--sm,.padding-right--sm{padding-right:.5rem!important}.padding--sm{padding:.5rem!important}.padding-bottom--md,.padding-vert--md{padding-bottom:1rem!important}.padding-top--md,.padding-vert--md{padding-top:1rem!important}.padding-horiz--md,.padding-left--md{padding-left:1rem!important}.padding-horiz--md,.padding-right--md{padding-right:1rem!important}.padding--md{padding:1rem!important}.padding-bottom--lg,.padding-vert--lg{padding-bottom:2rem!important}.padding-top--lg,.padding-vert--lg{padding-top:2rem!important}.padding-horiz--lg,.padding-left--lg{padding-left:2rem!important}.padding-horiz--lg,.padding-right--lg{padding-right:2rem!important}.padding--lg{padding:2rem!important}.padding-bottom--xl,.padding-vert--xl{padding-bottom:5rem!important}.padding-top--xl,.padding-vert--xl{padding-top:5rem!important}.padding-horiz--xl,.padding-left--xl{padding-left:5rem!important}.padding-horiz--xl,.padding-right--xl{padding-right:5rem!important}.padding--xl{padding:5rem!important}code{background-color:var(--ifm-code-background);border:.1rem solid rgba(0,0,0,.1);border-radius:var(--ifm-code-border-radius);font-family:var(--ifm-font-family-monospace);font-size:var(--ifm-code-font-size);padding:var(--ifm-code-padding-vertical) var(--ifm-code-padding-horizontal)}a code{color:inherit}pre{background-color:var(--ifm-pre-background);border-radius:var(--ifm-pre-border-radius);color:var(--ifm-pre-color);font:var(--ifm-code-font-size)/var(--ifm-pre-line-height) var(--ifm-font-family-monospace);padding:var(--ifm-pre-padding)}pre code{background-color:transparent;border:none;font-size:100%;line-height:inherit;padding:0}kbd{background-color:var(--ifm-color-emphasis-0);border:1px solid var(--ifm-color-emphasis-400);border-radius:.2rem;box-shadow:inset 0 -1px 0 var(--ifm-color-emphasis-400);color:var(--ifm-color-emphasis-800);font:80% var(--ifm-font-family-monospace);padding:.15rem .3rem}h1,h2,h3,h4,h5,h6{color:var(--ifm-heading-color);font-family:var(--ifm-heading-font-family);font-weight:var(--ifm-heading-font-weight);line-height:var(--ifm-heading-line-height);margin:var(--ifm-heading-margin-top) 0 var(--ifm-heading-margin-bottom) 0}h1{font-size:var(--ifm-h1-font-size)}h2{font-size:var(--ifm-h2-font-size)}h3{font-size:var(--ifm-h3-font-size)}h4{font-size:var(--ifm-h4-font-size)}h5{font-size:var(--ifm-h5-font-size)}h6{font-size:var(--ifm-h6-font-size)}.container_lyt7,.container_lyt7>svg,img{max-width:100%}img[align=right]{padding-left:var(--image-alignment-padding)}img[align=left]{padding-right:var(--image-alignment-padding)}.markdown{--ifm-h1-vertical-rhythm-top:3;--ifm-h2-vertical-rhythm-top:2;--ifm-h3-vertical-rhythm-top:1.5;--ifm-heading-vertical-rhythm-top:1.25;--ifm-h1-vertical-rhythm-bottom:1.25;--ifm-heading-vertical-rhythm-bottom:1}.markdown:after,.markdown:before{content:"";display:table}.markdown:after{clear:both}.markdown h1:first-child{--ifm-h1-font-size:3rem;margin-bottom:calc(var(--ifm-h1-vertical-rhythm-bottom)*var(--ifm-leading))}.markdown>h2{--ifm-h2-font-size:2rem;margin-top:calc(var(--ifm-h2-vertical-rhythm-top)*var(--ifm-leading))}.markdown>h3{--ifm-h3-font-size:1.5rem;margin-top:calc(var(--ifm-h3-vertical-rhythm-top)*var(--ifm-leading))}.markdown>h4,.markdown>h5,.markdown>h6{margin-top:calc(var(--ifm-heading-vertical-rhythm-top)*var(--ifm-leading))}.markdown>p,.markdown>pre,.markdown>ul,.tabList__CuJ{margin-bottom:var(--ifm-leading)}.markdown li>p{margin-top:var(--ifm-list-paragraph-margin)}.markdown li+li{margin-top:var(--ifm-list-item-margin)}ol,ul{margin:0 0 var(--ifm-list-margin);padding-left:var(--ifm-list-left-padding)}ol ol,ul ol{list-style-type:lower-roman}ol ol,ol ul,ul ol,ul ul{margin:0}ol ol ol,ol ul ol,ul ol ol,ul ul ol{list-style-type:lower-alpha}table{border-collapse:collapse;display:block;margin-bottom:var(--ifm-spacing-vertical)}table thead tr{border-bottom:2px solid var(--ifm-table-border-color)}table thead,table tr:nth-child(2n){background-color:var(--ifm-table-stripe-background)}table tr{background-color:var(--ifm-table-background);border-top:var(--ifm-table-border-width) solid var(--ifm-table-border-color)}table td,table th{border:var(--ifm-table-border-width) solid var(--ifm-table-border-color);padding:var(--ifm-table-cell-padding)}table th{background-color:var(--ifm-table-head-background);color:var(--ifm-table-head-color);font-weight:var(--ifm-table-head-font-weight)}table td{color:var(--ifm-table-cell-color)}strong{font-weight:var(--ifm-font-weight-bold)}a{color:var(--ifm-link-color);text-decoration:var(--ifm-link-decoration)}a:hover{color:var(--ifm-link-hover-color);text-decoration:var(--ifm-link-hover-decoration)}.button:hover,.text--no-decoration,.text--no-decoration:hover,a:not([href]){text-decoration:none}p{margin:0 0 var(--ifm-paragraph-margin-bottom)}blockquote{border-left:var(--ifm-blockquote-border-left-width) solid var(--ifm-blockquote-border-color);box-shadow:var(--ifm-blockquote-shadow);color:var(--ifm-blockquote-color);font-size:var(--ifm-blockquote-font-size);padding:var(--ifm-blockquote-padding-vertical) var(--ifm-blockquote-padding-horizontal)}blockquote>:first-child{margin-top:0}blockquote>:last-child{margin-bottom:0}hr{background-color:var(--ifm-hr-background-color);border:0;height:var(--ifm-hr-height);margin:var(--ifm-hr-margin-vertical) 0}.shadow--lw{box-shadow:var(--ifm-global-shadow-lw)!important}.shadow--md{box-shadow:var(--ifm-global-shadow-md)!important}.shadow--tl{box-shadow:var(--ifm-global-shadow-tl)!important}.text--primary{color:var(--ifm-color-primary)}.text--secondary{color:var(--ifm-color-secondary)}.text--success{color:var(--ifm-color-success)}.text--info{color:var(--ifm-color-info)}.text--warning{color:var(--ifm-color-warning)}.text--danger{color:var(--ifm-color-danger)}.text--center{text-align:center}.text--left{text-align:left}.text--justify{text-align:justify}.text--right{text-align:right}.text--capitalize{text-transform:capitalize}.text--lowercase{text-transform:lowercase}.alert__heading,.text--uppercase{text-transform:uppercase}.text--light{font-weight:var(--ifm-font-weight-light)}.text--normal{font-weight:var(--ifm-font-weight-normal)}.text--semibold{font-weight:var(--ifm-font-weight-semibold)}.text--bold{font-weight:var(--ifm-font-weight-bold)}.text--italic{font-style:italic}.text--truncate{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.text--break{word-wrap:break-word!important;word-break:break-word!important}.clean-btn{background:none;border:none;color:inherit;cursor:pointer;font-family:inherit;padding:0}.alert,.alert .close{color:var(--ifm-alert-foreground-color)}.clean-list{list-style:none;padding-left:0}.alert--primary{--ifm-alert-background-color:var(--ifm-color-primary-contrast-background);--ifm-alert-background-color-highlight:rgba(53,120,229,.15);--ifm-alert-foreground-color:var(--ifm-color-primary-contrast-foreground);--ifm-alert-border-color:var(--ifm-color-primary-dark)}.alert--secondary{--ifm-alert-background-color:var(--ifm-color-secondary-contrast-background);--ifm-alert-background-color-highlight:rgba(235,237,240,.15);--ifm-alert-foreground-color:var(--ifm-color-secondary-contrast-foreground);--ifm-alert-border-color:var(--ifm-color-secondary-dark)}.alert--success{--ifm-alert-background-color:var(--ifm-color-success-contrast-background);--ifm-alert-background-color-highlight:rgba(0,164,0,.15);--ifm-alert-foreground-color:var(--ifm-color-success-contrast-foreground);--ifm-alert-border-color:var(--ifm-color-success-dark)}.alert--info{--ifm-alert-background-color:var(--ifm-color-info-contrast-background);--ifm-alert-background-color-highlight:rgba(84,199,236,.15);--ifm-alert-foreground-color:var(--ifm-color-info-contrast-foreground);--ifm-alert-border-color:var(--ifm-color-info-dark)}.alert--warning{--ifm-alert-background-color:var(--ifm-color-warning-contrast-background);--ifm-alert-background-color-highlight:rgba(255,186,0,.15);--ifm-alert-foreground-color:var(--ifm-color-warning-contrast-foreground);--ifm-alert-border-color:var(--ifm-color-warning-dark)}.alert--danger{--ifm-alert-background-color:var(--ifm-color-danger-contrast-background);--ifm-alert-background-color-highlight:rgba(250,56,62,.15);--ifm-alert-foreground-color:var(--ifm-color-danger-contrast-foreground);--ifm-alert-border-color:var(--ifm-color-danger-dark)}.alert{--ifm-code-background:var(--ifm-alert-background-color-highlight);--ifm-link-color:var(--ifm-alert-foreground-color);--ifm-link-hover-color:var(--ifm-alert-foreground-color);--ifm-link-decoration:underline;--ifm-tabs-color:var(--ifm-alert-foreground-color);--ifm-tabs-color-active:var(--ifm-alert-foreground-color);--ifm-tabs-color-active-border:var(--ifm-alert-border-color);background-color:var(--ifm-alert-background-color);border:var(--ifm-alert-border-width) solid var(--ifm-alert-border-color);border-left-width:var(--ifm-alert-border-left-width);border-radius:var(--ifm-alert-border-radius);box-shadow:var(--ifm-alert-shadow);padding:var(--ifm-alert-padding-vertical) var(--ifm-alert-padding-horizontal)}.alert__heading{align-items:center;display:flex;font:700 var(--ifm-h5-font-size)/var(--ifm-heading-line-height) var(--ifm-heading-font-family);margin-bottom:.5rem}.alert__icon{display:inline-flex;margin-right:.4em}.alert__icon svg{fill:var(--ifm-alert-foreground-color);stroke:var(--ifm-alert-foreground-color);stroke-width:0}.alert .close{margin:calc(var(--ifm-alert-padding-vertical)*-1) calc(var(--ifm-alert-padding-horizontal)*-1) 0 0;opacity:.75}.alert .close:focus,.alert .close:hover,.hash-link:focus,:hover>.hash-link{opacity:1}.alert a{text-decoration-color:var(--ifm-alert-border-color)}.alert a:hover{text-decoration-thickness:2px}.avatar{-moz-column-gap:var(--ifm-avatar-intro-margin);column-gap:var(--ifm-avatar-intro-margin);display:flex}.avatar__photo{border-radius:50%;display:block;height:var(--ifm-avatar-photo-size);overflow:hidden;width:var(--ifm-avatar-photo-size)}.card--full-height,.navbar__logo img,body,html{height:100%}.avatar__photo--sm{--ifm-avatar-photo-size:2rem}.avatar__photo--lg{--ifm-avatar-photo-size:4rem}.avatar__photo--xl{--ifm-avatar-photo-size:6rem}.avatar__intro{display:flex;flex:1 1;flex-direction:column;justify-content:center;text-align:var(--ifm-avatar-intro-alignment)}.badge,.breadcrumbs__item,.breadcrumbs__link,.button,.dropdown>.navbar__link:after{display:inline-block}.avatar__name{font:700 var(--ifm-h4-font-size)/var(--ifm-heading-line-height) var(--ifm-font-family-base)}.avatar__subtitle{margin-top:.25rem}.avatar--vertical{--ifm-avatar-intro-alignment:center;--ifm-avatar-intro-margin:0.5rem;align-items:center;flex-direction:column}.badge{background-color:var(--ifm-badge-background-color);border:var(--ifm-badge-border-width) solid var(--ifm-badge-border-color);border-radius:var(--ifm-badge-border-radius);color:var(--ifm-badge-color);font-size:75%;font-weight:var(--ifm-font-weight-bold);line-height:1;padding:var(--ifm-badge-padding-vertical) var(--ifm-badge-padding-horizontal)}.badge--primary{--ifm-badge-background-color:var(--ifm-color-primary)}.badge--secondary{--ifm-badge-background-color:var(--ifm-color-secondary);color:var(--ifm-color-black)}.breadcrumbs__link,.button.button--secondary.button--outline:not(.button--active):not(:hover){color:var(--ifm-font-color-base)}.badge--success{--ifm-badge-background-color:var(--ifm-color-success)}.badge--info{--ifm-badge-background-color:var(--ifm-color-info)}.badge--warning{--ifm-badge-background-color:var(--ifm-color-warning)}.badge--danger{--ifm-badge-background-color:var(--ifm-color-danger)}.breadcrumbs{margin-bottom:0;padding-left:0}.breadcrumbs__item:not(:last-child):after{background:var(--ifm-breadcrumb-separator) center;content:" ";display:inline-block;filter:var(--ifm-breadcrumb-separator-filter);height:calc(var(--ifm-breadcrumb-separator-size)*var(--ifm-breadcrumb-size-multiplier)*var(--ifm-breadcrumb-separator-size-multiplier));margin:0 var(--ifm-breadcrumb-spacing);opacity:.5;width:calc(var(--ifm-breadcrumb-separator-size)*var(--ifm-breadcrumb-size-multiplier)*var(--ifm-breadcrumb-separator-size-multiplier))}.breadcrumbs__item--active .breadcrumbs__link{background:var(--ifm-breadcrumb-item-background-active);color:var(--ifm-breadcrumb-color-active)}.breadcrumbs__link{border-radius:var(--ifm-breadcrumb-border-radius);font-size:calc(1rem*var(--ifm-breadcrumb-size-multiplier));padding:calc(var(--ifm-breadcrumb-padding-vertical)*var(--ifm-breadcrumb-size-multiplier)) calc(var(--ifm-breadcrumb-padding-horizontal)*var(--ifm-breadcrumb-size-multiplier));transition-duration:var(--ifm-transition-fast);transition-property:background,color}.breadcrumbs__link:link:hover,.breadcrumbs__link:visited:hover,area[href].breadcrumbs__link:hover{background:var(--ifm-breadcrumb-item-background-active);text-decoration:none}.breadcrumbs__link:-moz-any-link:hover{background:var(--ifm-breadcrumb-item-background-active);text-decoration:none}.breadcrumbs__link:any-link:hover{background:var(--ifm-breadcrumb-item-background-active);text-decoration:none}.breadcrumbs--sm{--ifm-breadcrumb-size-multiplier:0.8}.breadcrumbs--lg{--ifm-breadcrumb-size-multiplier:1.2}.button{background-color:var(--ifm-button-background-color);border:var(--ifm-button-border-width) solid var(--ifm-button-border-color);border-radius:var(--ifm-button-border-radius);cursor:pointer;font-size:calc(.875rem*var(--ifm-button-size-multiplier));font-weight:var(--ifm-button-font-weight);line-height:1.5;padding:calc(var(--ifm-button-padding-vertical)*var(--ifm-button-size-multiplier)) calc(var(--ifm-button-padding-horizontal)*var(--ifm-button-size-multiplier));text-align:center;transition-duration:var(--ifm-button-transition-duration);transition-property:color,background,border-color;user-select:none;white-space:nowrap}.button,.button:hover{color:var(--ifm-button-color)}.button--outline{--ifm-button-color:var(--ifm-button-border-color)}.button--outline:hover{--ifm-button-background-color:var(--ifm-button-border-color)}.button--link{--ifm-button-border-color:transparent;color:var(--ifm-link-color);text-decoration:var(--ifm-link-decoration)}.button--link.button--active,.button--link:active,.button--link:hover{color:var(--ifm-link-hover-color);text-decoration:var(--ifm-link-hover-decoration)}.button.disabled,.button:disabled,.button[disabled]{opacity:.65;pointer-events:none}.button--sm{--ifm-button-size-multiplier:0.8}.button--lg{--ifm-button-size-multiplier:1.35}.button--block{display:block;width:100%}.button.button--secondary{color:var(--ifm-color-gray-900)}:where(.button--primary){--ifm-button-background-color:var(--ifm-color-primary);--ifm-button-border-color:var(--ifm-color-primary)}:where(.button--primary):not(.button--outline):hover{--ifm-button-background-color:var(--ifm-color-primary-dark);--ifm-button-border-color:var(--ifm-color-primary-dark)}.button--primary.button--active,.button--primary:active{--ifm-button-background-color:var(--ifm-color-primary-darker);--ifm-button-border-color:var(--ifm-color-primary-darker)}:where(.button--secondary){--ifm-button-background-color:var(--ifm-color-secondary);--ifm-button-border-color:var(--ifm-color-secondary)}:where(.button--secondary):not(.button--outline):hover{--ifm-button-background-color:var(--ifm-color-secondary-dark);--ifm-button-border-color:var(--ifm-color-secondary-dark)}.button--secondary.button--active,.button--secondary:active{--ifm-button-background-color:var(--ifm-color-secondary-darker);--ifm-button-border-color:var(--ifm-color-secondary-darker)}:where(.button--success){--ifm-button-background-color:var(--ifm-color-success);--ifm-button-border-color:var(--ifm-color-success)}:where(.button--success):not(.button--outline):hover{--ifm-button-background-color:var(--ifm-color-success-dark);--ifm-button-border-color:var(--ifm-color-success-dark)}.button--success.button--active,.button--success:active{--ifm-button-background-color:var(--ifm-color-success-darker);--ifm-button-border-color:var(--ifm-color-success-darker)}:where(.button--info){--ifm-button-background-color:var(--ifm-color-info);--ifm-button-border-color:var(--ifm-color-info)}:where(.button--info):not(.button--outline):hover{--ifm-button-background-color:var(--ifm-color-info-dark);--ifm-button-border-color:var(--ifm-color-info-dark)}.button--info.button--active,.button--info:active{--ifm-button-background-color:var(--ifm-color-info-darker);--ifm-button-border-color:var(--ifm-color-info-darker)}:where(.button--warning){--ifm-button-background-color:var(--ifm-color-warning);--ifm-button-border-color:var(--ifm-color-warning)}:where(.button--warning):not(.button--outline):hover{--ifm-button-background-color:var(--ifm-color-warning-dark);--ifm-button-border-color:var(--ifm-color-warning-dark)}.button--warning.button--active,.button--warning:active{--ifm-button-background-color:var(--ifm-color-warning-darker);--ifm-button-border-color:var(--ifm-color-warning-darker)}:where(.button--danger){--ifm-button-background-color:var(--ifm-color-danger);--ifm-button-border-color:var(--ifm-color-danger)}:where(.button--danger):not(.button--outline):hover{--ifm-button-background-color:var(--ifm-color-danger-dark);--ifm-button-border-color:var(--ifm-color-danger-dark)}.button--danger.button--active,.button--danger:active{--ifm-button-background-color:var(--ifm-color-danger-darker);--ifm-button-border-color:var(--ifm-color-danger-darker)}.button-group{display:inline-flex;gap:var(--ifm-button-group-spacing)}.button-group>.button:not(:first-child){border-bottom-left-radius:0;border-top-left-radius:0}.button-group>.button:not(:last-child){border-bottom-right-radius:0;border-top-right-radius:0}.button-group--block{display:flex;justify-content:stretch}.button-group--block>.button{flex-grow:1}.card{background-color:var(--ifm-card-background-color);border-radius:var(--ifm-card-border-radius);box-shadow:var(--ifm-global-shadow-lw);display:flex;flex-direction:column;overflow:hidden}.card__image{padding-top:var(--ifm-card-vertical-spacing)}.card__image:first-child{padding-top:0}.card__body,.card__footer,.card__header{padding:var(--ifm-card-vertical-spacing) var(--ifm-card-horizontal-spacing)}.card__body:not(:last-child),.card__footer:not(:last-child),.card__header:not(:last-child){padding-bottom:0}.card__body>:last-child,.card__footer>:last-child,.card__header>:last-child{margin-bottom:0}.card__footer{margin-top:auto}.table-of-contents{font-size:.8rem;margin-bottom:0;padding:var(--ifm-toc-padding-vertical) 0}.table-of-contents,.table-of-contents ul{list-style:none;padding-left:var(--ifm-toc-padding-horizontal)}.table-of-contents li{margin:var(--ifm-toc-padding-vertical) var(--ifm-toc-padding-horizontal)}.table-of-contents__left-border{border-left:1px solid var(--ifm-toc-border-color)}.table-of-contents__link{color:var(--ifm-toc-link-color);display:block}.table-of-contents__link--active,.table-of-contents__link--active code,.table-of-contents__link:hover,.table-of-contents__link:hover code{color:var(--ifm-color-primary);text-decoration:none}.close{color:var(--ifm-color-black);float:right;font-size:1.5rem;font-weight:var(--ifm-font-weight-bold);line-height:1;opacity:.5;padding:1rem;transition:opacity var(--ifm-transition-fast) var(--ifm-transition-timing-default)}.close:hover{opacity:.7}.close:focus,.theme-code-block-highlighted-line .codeLineNumber_Tfdd:before{opacity:.8}.dropdown{display:inline-flex;font-weight:var(--ifm-dropdown-font-weight);vertical-align:top}.dropdown--hoverable:hover .dropdown__menu,.dropdown--show .dropdown__menu{opacity:1;pointer-events:all;transform:translateY(-1px);visibility:visible}#nprogress,.dropdown__menu,.navbar__item.dropdown .navbar__link:not([href]){pointer-events:none}.dropdown--right .dropdown__menu{left:inherit;right:0}.dropdown--nocaret .navbar__link:after{content:none!important}.dropdown__menu{background-color:var(--ifm-dropdown-background-color);border-radius:var(--ifm-global-radius);box-shadow:var(--ifm-global-shadow-md);left:0;list-style:none;max-height:80vh;min-width:10rem;opacity:0;overflow-y:auto;padding:.5rem;position:absolute;top:calc(100% - var(--ifm-navbar-item-padding-vertical) + .3rem);transform:translateY(-.625rem);transition-duration:var(--ifm-transition-fast);transition-property:opacity,transform,visibility;transition-timing-function:var(--ifm-transition-timing-default);visibility:hidden;z-index:var(--ifm-z-index-dropdown)}.menu__caret,.menu__link,.menu__list-item-collapsible{border-radius:.25rem;transition:background var(--ifm-transition-fast) var(--ifm-transition-timing-default)}.dropdown__link{border-radius:.25rem;color:var(--ifm-dropdown-link-color);display:block;font-size:.875rem;margin-top:.2rem;padding:.25rem .5rem;white-space:nowrap}.dropdown__link--active,.dropdown__link:hover{background-color:var(--ifm-dropdown-hover-background-color);color:var(--ifm-dropdown-link-color);text-decoration:none}.dropdown__link--active,.dropdown__link--active:hover{--ifm-dropdown-link-color:var(--ifm-link-color)}.dropdown>.navbar__link:after{border-color:currentcolor transparent;border-style:solid;border-width:.4em .4em 0;content:"";margin-left:.3em;position:relative;top:2px;transform:translateY(-50%)}.footer{background-color:var(--ifm-footer-background-color);color:var(--ifm-footer-color);padding:var(--ifm-footer-padding-vertical) var(--ifm-footer-padding-horizontal)}.footer--dark{--ifm-footer-background-color:#303846;--ifm-footer-color:var(--ifm-footer-link-color);--ifm-footer-link-color:var(--ifm-color-secondary);--ifm-footer-title-color:var(--ifm-color-white)}.footer__links{margin-bottom:1rem}.footer__link-item{color:var(--ifm-footer-link-color);line-height:2}.footer__link-item:hover{color:var(--ifm-footer-link-hover-color)}.footer__link-separator{margin:0 var(--ifm-footer-link-horizontal-spacing)}.footer__logo{margin-top:1rem;max-width:var(--ifm-footer-logo-max-width)}.docs-wrapper,.navbar__inner{max-width:var(--custom-content-max-width)}.footer__title{color:var(--ifm-footer-title-color);font:700 var(--ifm-h4-font-size)/var(--ifm-heading-line-height) var(--ifm-font-family-base);margin-bottom:var(--ifm-heading-margin-bottom)}.menu,.navbar__link{font-weight:var(--ifm-font-weight-semibold)}.docItemContainer_Djhp article>:first-child,.docItemContainer_Djhp header+*,.footer-legal li+li,.footer__item,.h1,.h2,.h3,.h4,.h5,.h6{margin-top:0}.admonitionContent_S0QG>:last-child,.cardContainer_fWXF :last-child,.collapsibleContent_i85q>:last-child,.footer-legal ul,.footer__items,.tabItem_Ymn6>:last-child{margin-bottom:0}.codeBlockStandalone_MEMb,[type=checkbox]{padding:0}.hero{align-items:center;background-color:var(--ifm-hero-background-color);color:var(--ifm-hero-text-color);display:flex;padding:4rem 2rem}.hero--primary{--ifm-hero-background-color:var(--ifm-color-primary);--ifm-hero-text-color:var(--ifm-font-color-base-inverse)}.hero--dark{--ifm-hero-background-color:#303846;--ifm-hero-text-color:var(--ifm-color-white)}.hero__title,.homeNavItem h1{font-size:3rem}.hero__subtitle{font-size:1.5rem}.menu__list{list-style:none;margin:0;padding-left:0}.menu__caret,.menu__link{padding:var(--ifm-menu-link-padding-vertical) var(--ifm-menu-link-padding-horizontal)}.menu__list .menu__list{flex:0 0 100%;margin-top:.25rem;padding-left:var(--ifm-menu-link-padding-horizontal)}.menu__list-item:not(:first-child){margin-top:.25rem}.menu__list-item--collapsed .menu__list{height:0;overflow:hidden}.details_lb9f[data-collapsed=false].isBrowser_bmU9>summary:before,.details_lb9f[open]:not(.isBrowser_bmU9)>summary:before,.menu__list-item--collapsed .menu__caret:before,.menu__list-item--collapsed .menu__link--sublist:after{transform:rotate(90deg)}.menu__list-item-collapsible{display:flex;flex-wrap:wrap;position:relative}.menu__caret:hover,.menu__link:hover,.menu__list-item-collapsible--active,.menu__list-item-collapsible:hover{background:var(--ifm-menu-color-background-hover)}.menu__list-item-collapsible .menu__link--active,.menu__list-item-collapsible .menu__link:hover{background:none!important}.menu__caret,.menu__link{align-items:center;display:flex}.navbar-sidebar,.navbar-sidebar__backdrop{bottom:0;opacity:0;transition-duration:var(--ifm-transition-fast);transition-timing-function:ease-in-out;left:0;top:0;visibility:hidden}.menu__link{color:var(--ifm-menu-color);flex:1;line-height:1.25}.menu__link:hover{color:var(--ifm-menu-color);text-decoration:none}.menu__caret:before,.menu__link--sublist-caret:after{height:1.25rem;transform:rotate(180deg);transition:transform var(--ifm-transition-fast) linear;width:1.25rem;content:"";filter:var(--ifm-menu-link-sublist-icon-filter)}.menu__link--sublist-caret:after{background:var(--ifm-menu-link-sublist-icon) 50%/2rem 2rem;margin-left:auto;min-width:1.25rem}.navbar__items--center .navbar__brand,body{margin:0}.menu__link--active,.menu__link--active:hover{color:var(--ifm-menu-color-active)}.navbar__brand,.navbar__link{color:var(--ifm-navbar-link-color)}.menu__link--active:not(.menu__link--sublist){background-color:var(--ifm-menu-color-background-active)}.menu__caret:before{background:var(--ifm-menu-link-sublist-icon) 50%/2rem 2rem}.navbar--dark,html[data-theme=dark]{--ifm-menu-link-sublist-icon-filter:invert(100%) sepia(94%) saturate(17%) hue-rotate(223deg) brightness(104%) contrast(98%)}.navbar{background-color:var(--ifm-navbar-background-color);box-shadow:var(--ifm-navbar-shadow);height:var(--ifm-navbar-height);padding:var(--ifm-navbar-padding-vertical) var(--ifm-navbar-padding-horizontal)}.navbar,.navbar>.container,.navbar>.container-fluid{display:flex}.navbar--fixed-top{position:sticky;top:0;z-index:var(--ifm-z-index-fixed)}.navbar__inner{display:flex;flex-wrap:wrap;justify-content:space-between;width:100%}.navbar__brand{align-items:center;display:flex;margin-right:1rem;min-width:0}.navbar__brand:hover{color:var(--ifm-navbar-link-hover-color);text-decoration:none}.announcementBarContent_xLdY,.navbar__title{flex:1 1 auto}.navbar__toggle{display:none;margin-right:.5rem}.navbar__logo{flex:0 0 auto;height:2rem;margin-right:.5rem}.navbar__items{align-items:center;display:flex;flex:1;min-width:0}.navbar__items--center{flex:0 0 auto}.navbar__items--center+.navbar__items--right{flex:1}.navbar__items--right{flex:0 0 auto;justify-content:flex-end}.navbar__items--right>:last-child{padding-right:0}.navbar__item{display:inline-block;padding:var(--ifm-navbar-item-padding-vertical) var(--ifm-navbar-item-padding-horizontal)}.navbar__link--active,.navbar__link:hover{color:var(--ifm-navbar-link-hover-color);text-decoration:none}.navbar--dark,.navbar--primary{--ifm-menu-color:var(--ifm-color-gray-300);--ifm-navbar-link-color:var(--ifm-color-gray-100);--ifm-navbar-search-input-background-color:hsla(0,0%,100%,.1);--ifm-navbar-search-input-placeholder-color:hsla(0,0%,100%,.5);color:var(--ifm-color-white)}.navbar--dark{--ifm-navbar-background-color:#242526;--ifm-menu-color-background-active:hsla(0,0%,100%,.05);--ifm-navbar-search-input-color:var(--ifm-color-white)}.navbar--primary{--ifm-navbar-background-color:var(--ifm-color-primary);--ifm-navbar-link-hover-color:var(--ifm-color-white);--ifm-menu-color-active:var(--ifm-color-white);--ifm-navbar-search-input-color:var(--ifm-color-emphasis-500)}.navbar__search-input{-webkit-appearance:none;-moz-appearance:none;appearance:none;background:var(--ifm-navbar-search-input-background-color) var(--ifm-navbar-search-input-icon) no-repeat .75rem center/1rem 1rem;border:none;border-radius:2rem;color:var(--ifm-navbar-search-input-color);cursor:text;display:inline-block;font-size:.9rem;height:2rem;padding:0 .5rem 0 2.25rem;width:12.5rem}.navbar__search-input::-moz-placeholder{color:var(--ifm-navbar-search-input-placeholder-color)}.navbar__search-input::placeholder{color:var(--ifm-navbar-search-input-placeholder-color)}.navbar-sidebar{background-color:var(--ifm-navbar-background-color);box-shadow:var(--ifm-global-shadow-md);position:fixed;transform:translate3d(-100%,0,0);transition-property:opacity,visibility,transform;width:var(--ifm-navbar-sidebar-width)}.navbar-sidebar--show .navbar-sidebar,.navbar-sidebar__items{transform:translateZ(0)}.navbar-sidebar--show .navbar-sidebar,.navbar-sidebar--show .navbar-sidebar__backdrop{opacity:1;visibility:visible}.navbar-sidebar__backdrop{background-color:rgba(0,0,0,.6);position:fixed;right:0;transition-property:opacity,visibility}.btn-primary,.cards,.nav-footer{position:relative}.navbar-sidebar__brand{align-items:center;box-shadow:var(--ifm-navbar-shadow);display:flex;flex:1;height:var(--ifm-navbar-height);padding:var(--ifm-navbar-padding-vertical) var(--ifm-navbar-padding-horizontal)}.navbar-sidebar__items{display:flex;height:calc(100% - var(--ifm-navbar-height));transition:transform var(--ifm-transition-fast) ease-in-out}.navbar-sidebar__items--show-secondary{transform:translate3d(calc((var(--ifm-navbar-sidebar-width))*-1),0,0)}.navbar-sidebar__item{flex-shrink:0;padding:.5rem;width:calc(var(--ifm-navbar-sidebar-width))}.navbar-sidebar__back{background:var(--ifm-menu-color-background-active);font-size:15px;font-weight:var(--ifm-button-font-weight);margin:0 0 .2rem -.5rem;padding:.6rem 1.5rem;position:relative;text-align:left;top:-.5rem;width:calc(100% + 1rem)}.container.container-custom,.navbar__inner,article iframe,article img{margin-left:auto;margin-right:auto}.navbar-sidebar__close{display:flex;margin-left:auto}.pagination{-moz-column-gap:var(--ifm-pagination-page-spacing);column-gap:var(--ifm-pagination-page-spacing);display:flex;font-size:var(--ifm-pagination-font-size);padding-left:0}.pagination--sm{--ifm-pagination-font-size:0.8rem;--ifm-pagination-padding-horizontal:0.8rem;--ifm-pagination-padding-vertical:0.2rem}.pagination--lg{--ifm-pagination-font-size:1.2rem;--ifm-pagination-padding-horizontal:1.2rem;--ifm-pagination-padding-vertical:0.3rem}.pagination__item{display:inline-flex}.pagination__item>span{padding:var(--ifm-pagination-padding-vertical)}.pagination__item--active .pagination__link{color:var(--ifm-pagination-color-active)}.pagination__item--active .pagination__link,.pagination__item:not(.pagination__item--active):hover .pagination__link{background:var(--ifm-pagination-item-active-background)}.pagination__item--disabled,.pagination__item[disabled]{opacity:.25;pointer-events:none}.pagination__link{border-radius:var(--ifm-pagination-border-radius);color:var(--ifm-font-color-base);display:inline-block;padding:var(--ifm-pagination-padding-vertical) var(--ifm-pagination-padding-horizontal);transition:background var(--ifm-transition-fast) var(--ifm-transition-timing-default)}.homeContainer a,.nav-footer a:hover,.pagination__link:hover{text-decoration:none}.pagination-nav{grid-gap:var(--ifm-spacing-horizontal);display:grid;gap:var(--ifm-spacing-horizontal);grid-template-columns:repeat(2,1fr)}.pagination-nav__link{border:1px solid var(--ifm-color-emphasis-300);border-radius:var(--ifm-pagination-nav-border-radius);display:block;height:100%;line-height:var(--ifm-heading-line-height);padding:var(--ifm-global-spacing);transition:border-color var(--ifm-transition-fast) var(--ifm-transition-timing-default)}.text-heading,h1{line-height:1.333333}.pagination-nav__link:hover{border-color:var(--ifm-pagination-nav-color-hover);text-decoration:none}.pagination-nav__link--next{grid-column:2/3;text-align:right}.pagination-nav__label{font-size:var(--ifm-h4-font-size);font-weight:var(--ifm-heading-font-weight);word-break:break-word}.pagination-nav__link--prev .pagination-nav__label:before{content:"« "}.pagination-nav__link--next .pagination-nav__label:after{content:" »"}.pagination-nav__sublabel{color:var(--ifm-color-content-secondary);font-size:var(--ifm-h5-font-size);font-weight:var(--ifm-font-weight-semibold);margin-bottom:.25rem}.pills__item,.tabs{font-weight:var(--ifm-font-weight-bold)}.pills{display:flex;gap:var(--ifm-pills-spacing);padding-left:0}.pills__item{border-radius:.5rem;cursor:pointer;display:inline-block;padding:.25rem 1rem;transition:background var(--ifm-transition-fast) var(--ifm-transition-timing-default)}.tabs,:not(.containsTaskList_mC6p>li)>.containsTaskList_mC6p{padding-left:0}.pills__item--active{color:var(--ifm-pills-color-active)}.pills__item--active,.pills__item:not(.pills__item--active):hover{background:var(--ifm-pills-color-background-active)}.pills--block{justify-content:stretch}.pills--block .pills__item{flex-grow:1;text-align:center}.tabs{color:var(--ifm-tabs-color);display:flex;margin-bottom:0;overflow-x:auto}.tabs__item{border-bottom:3px solid transparent;border-radius:var(--ifm-global-radius);cursor:pointer;display:inline-flex;padding:var(--ifm-tabs-padding-vertical) var(--ifm-tabs-padding-horizontal);transition:background-color var(--ifm-transition-fast) var(--ifm-transition-timing-default)}#__docusaurus-base-url-issue-banner-container,.DocSearch.DocSearch-Button .DocSearch-Button-Keys,.docSidebarContainer_b6E3,.navbar__inner .navbar__item:last-child a:after,.navbar__inner a.navbar__item svg[class^=iconExternalLink],.sidebarLogo_isFc,.themedImage_ToTc,[data-theme=dark] .lightToggleIcon_pyhR,[data-theme=light] .darkToggleIcon_wfgR,html[data-announcement-bar-initially-dismissed=true] .announcementBar_mb4j{display:none}.tabs__item--active{border-bottom-color:var(--ifm-tabs-color-active-border);border-bottom-left-radius:0;border-bottom-right-radius:0;color:var(--ifm-tabs-color-active)}.tabs__item:hover{background-color:var(--ifm-hover-overlay)}.tabs--block{justify-content:stretch}.tabs--block .tabs__item{flex-grow:1;justify-content:center}html[data-theme=dark]{--ifm-color-scheme:dark;--ifm-color-emphasis-0:var(--ifm-color-gray-1000);--ifm-color-emphasis-100:var(--ifm-color-gray-900);--ifm-color-emphasis-200:var(--ifm-color-gray-800);--ifm-color-emphasis-300:var(--ifm-color-gray-700);--ifm-color-emphasis-400:var(--ifm-color-gray-600);--ifm-color-emphasis-600:var(--ifm-color-gray-400);--ifm-color-emphasis-700:var(--ifm-color-gray-300);--ifm-color-emphasis-800:var(--ifm-color-gray-200);--ifm-color-emphasis-900:var(--ifm-color-gray-100);--ifm-color-emphasis-1000:var(--ifm-color-gray-0);--ifm-background-color:#1b1b1d;--ifm-background-surface-color:#242526;--ifm-hover-overlay:hsla(0,0%,100%,.05);--ifm-color-content:#e3e3e3;--ifm-color-content-secondary:#fff;--ifm-breadcrumb-separator-filter:invert(64%) sepia(11%) saturate(0%) hue-rotate(149deg) brightness(99%) contrast(95%);--ifm-code-background:hsla(0,0%,100%,.1);--ifm-scrollbar-track-background-color:#444;--ifm-scrollbar-thumb-background-color:#686868;--ifm-scrollbar-thumb-hover-background-color:#7a7a7a;--ifm-table-stripe-background:hsla(0,0%,100%,.07);--ifm-toc-border-color:var(--ifm-color-emphasis-200);--ifm-color-primary-contrast-background:#102445;--ifm-color-primary-contrast-foreground:#ebf2fc;--ifm-color-secondary-contrast-background:#474748;--ifm-color-secondary-contrast-foreground:#fdfdfe;--ifm-color-success-contrast-background:#003100;--ifm-color-success-contrast-foreground:#e6f6e6;--ifm-color-info-contrast-background:#193c47;--ifm-color-info-contrast-foreground:#eef9fd;--ifm-color-warning-contrast-background:#4d3800;--ifm-color-warning-contrast-foreground:#fff8e6;--ifm-color-danger-contrast-background:#4b1113;--ifm-color-danger-contrast-foreground:#ffebec;--docsearch-text-color:#f5f6f7;--docsearch-container-background:rgba(9,10,17,.8);--docsearch-modal-background:#15172a;--docsearch-modal-shadow:inset 1px 1px 0 0 #2c2e40,0 3px 8px 0 #000309;--docsearch-searchbox-background:#090a11;--docsearch-searchbox-focus-background:#000;--docsearch-hit-color:#bec3c9;--docsearch-hit-shadow:none;--docsearch-hit-background:#090a11;--docsearch-key-gradient:linear-gradient(-26.5deg,#565872,#31355b);--docsearch-key-shadow:inset 0 -2px 0 0 #282d55,inset 0 0 1px 1px #51577d,0 2px 2px 0 rgba(3,4,9,.3);--docsearch-footer-background:#1e2136;--docsearch-footer-shadow:inset 0 1px 0 0 rgba(73,76,106,.5),0 -4px 8px 0 rgba(0,0,0,.2);--docsearch-logo-color:#fff;--docsearch-muted-color:#7f8497}#nprogress .bar{background:var(--docusaurus-progress-bar-color);height:2px;left:0;position:fixed;top:0;width:100%;z-index:1031}#nprogress .peg{box-shadow:0 0 10px var(--docusaurus-progress-bar-color),0 0 5px var(--docusaurus-progress-bar-color);height:100%;opacity:1;position:absolute;right:0;transform:rotate(3deg) translateY(-4px);width:100px}@font-face{font-family:Unbounded;font-weight:100 900;src:url(/assets/fonts/Unbounded-Variable-a247d72576aff02445f8abeb96056589.woff2) format("woff2-variations")}body{font-family:var(--sansFontFamily)}h1{font-family:Unbounded,sans-serif!important;padding-top:1.2rem}h2,h3,h4,h5,h6{font-family:var(--sansFontFamily)}.text-heading{font-family:var(--headingFontFamily)}.font-weight-medium{font-weight:500!important}.font-weight-bolder{font-weight:900!important}button.menu__button{box-shadow:0 2px 5px 0 rgba(0,0,0,.26)}.img_ev3q,.navbar.navbar--fixed-top{height:auto}.btn-bg-primary.btn-primary:before,.btn-primary:before{height:100%;transition:.2s;z-index:-1;top:0;position:absolute}.DocSearch.DocSearch-Button{background-color:#fff;border:1px solid var(--snowColor);color:var(--silverColor);cursor:text;width:170px}.btn-primary:before,.btn-primary[type=submit]:active,.btn-primary[type=submit]:focus,.btn-primary[type=submit]:hover{background:var(--ifm-color-primary)}.DocSearch.DocSearch-Button .DocSearch-Search-Icon{color:var(--silverColor)}.DocSearch.DocSearch-Button:hover .DocSearch-Search-Icon{color:var(--secondaryColor)}.DocSearch.DocSearch-Button .DocSearch-Button-Placeholder{font-size:13px;font-weight:500}.navbar__inner .navbar__item:last-child{margin-left:5px;margin-right:5px;opacity:1}.navbar__inner .navbar__item:last-child .dropdown__menu{border-radius:1.5rem;box-shadow:0 1rem 3rem rgba(0,0,0,.175);right:0;text-align:center;top:32px}.navbar__inner .navbar__item:last-child .dropdown__menu>li a{color:var(--secondaryColor);padding:12px 24px}.navbar__inner .navbar__item:last-child .dropdown__menu>li a.dropdown__link--active{background-color:#fff;color:var(--blackColor)}.navbar__inner .navbar__item:last-child .dropdown__menu>li a.dropdown__link--active:hover,.wordWrapButtonEnabled_EoeP .wordWrapButtonIcon_Bwma{color:var(--ifm-color-primary)}.navbar__inner .navbar__item:last-child .dropdown__menu>li a:hover{background-color:var(--snowColor);color:var(--ifm-color-primary)}.homeContainer{background:#fff;text-align:center}.homeFooterContainer,div[role=banner]{background-image:linear-gradient(217deg,rgba(196,0,97,.8),rgba(196,0,97,0) 70%),linear-gradient(127deg,rgba(230,0,122,.8),rgba(230,0,122,0) 70%),linear-gradient(336deg,rgba(103,69,210,.7),rgba(103,69,210,0) 70%)}.text-dark{color:var(--secondaryColor)!important}.homeNavContainer,.homeNavItem{padding:3rem 0}.homeNavItem{border-radius:3.25rem!important;transition:.15s ease-in-out}.homeNavItem p{max-width:300px}div[role=banner]{padding:10px 0}div[role=banner] .close{color:#fff}div[role=banner] .close:focus,div[role=banner] .close:hover{color:#fff!important;opacity:1}.homeFooterContainer{background-color:#e6007a;padding:6rem 0 4rem}.homeFooterContainer .col-lg-6{align-items:flex-start;display:flex;flex-flow:column nowrap;margin-bottom:2rem}.homeFooterContainer .col-lg-6>:first-child{margin-bottom:1.3rem}.homeFooterContainer p{margin-bottom:2.5rem}.docs-wrapper{margin:0 auto;padding-bottom:80px}article blockquote{background-color:rgba(255,229,100,.3);border-left:8px solid #ffe564}article iframe,article img{display:block;max-width:100%}.prism-code{background-color:var(--custom-code-block-background)!important}.prism-code>div{width:100px!important}.table-of-contents__link--active,.table-of-contents__link--active code,.table-of-contents__link:hover,.table-of-contents__link:hover code{font-weight:600}.btn{font-size:16px;font-weight:700;padding:8px 16px}.btn,.btn:before{border-radius:1.5rem}.btn:before{left:-42px;width:42px}.btn-group-lg>.btn,.btn-lg{border-radius:2rem;padding:16px 20px}.btn-group-lg>.btn:before,.btn-lg:before{border-radius:2rem;left:-58px;width:58px}.btn-group-sm>.btn,.btn-sm{border-radius:1.5rem;font-size:16px;padding:8px 16px}.btn-group-sm>.btn:before,.btn-sm:before{border-radius:1.5rem;left:-42px;width:42px}.btn-primary{background-color:transparent;border-color:var(--ifm-color-primary);color:var(--ifm-color-primary);overflow:hidden;transform:scale(.999);transition:.2s,border 1ms;z-index:1}.btn-primary,.btn-primary:before{border:1px solid var(--ifm-color-primary);will-change:transform}.btn-primary:before{color:transparent;content:""}.btn-primary:active,.btn-primary:focus,.btn-primary:hover{background:none;border:1px solid transparent;color:#fff;transform:scale(1.05);will-change:transform}.btn-primary.focus,.btn-primary:focus{box-shadow:0 0 .2rem .2rem rgba(0,0,0,.1)}.btn-primary:not(:disabled):not(.disabled):active{background-color:transparent}.btn-primary:active:before,.btn-primary:focus:before,.btn-primary:hover:before{left:0;width:100%}.btn-bg-primary.btn-primary{border:1px solid #fff;color:#fff!important}.btn-bg-primary.btn-primary:active,.btn-bg-primary.btn-primary:focus,.btn-bg-primary.btn-primary:hover{background:#fff;color:var(--ifm-color-primary)!important}.btn-bg-primary.btn-primary:before{background:#fff;border:1px solid #fff;color:transparent;content:none;will-change:transform}.btn-white,.footer-legal a.text-white:hover,.nav-footer a.text-white:hover{color:#fff!important}.nav-footer.spacer-y-4{padding-bottom:3rem;padding-top:3rem}.nav-footer.pb-4{padding-bottom:2.25rem!important}.nav-footer .text-small{font-size:.875rem}.nav-footer{background:var(--secondaryColor);border:none;color:#202020;font-size:16px;line-height:24px}.nav-footer h5{font-size:1.25rem;font-weight:400;margin-top:0}.nav-footer a.text-white,.nav-footer a.text-white:visited{color:var(--silverColor)!important}.nav-footer-item-pill{background-color:#e6007a;border-radius:10px;color:#fff;font-size:.75rem;font-weight:700;padding:1px 8px}.list-social-links{display:flex;list-style:none;padding:0}.cardTitle_rnsV,footer .list-social-links i{font-size:1.2rem}footer .list-social-links a{text-decoration:none;background:0 0!important;border:1px solid #fff;border-radius:50%;color:#fff;display:block;padding:.25rem .9rem}footer [class^=socicon-]{line-height:2}footer .list-social-links{margin-left:0}.footer-legal .navbar-brand{display:block;padding-bottom:0}.footer-legal .list-pipe-separator>li:not(:last-child)>a:after{content:"|";margin:0 .375rem;opacity:.5}.footer-legal a.text-white,.footer-legal a.text-white:visited{color:#b5aeae!important}.cards-container{flex-flow:row wrap;max-width:100%;min-width:0}.cards,.cards-container{align-items:center;display:flex;justify-content:center}.cards{border:1px solid var(--primaryColor);border-radius:10px;box-shadow:0 .1rem .1rem rgba(0,0,0,.4);height:80px;margin:5px;padding:10px;top:0;transition:top .2s;width:350px}.cards:hover{top:-5px}.cards-body{align-items:flex-start;color:#000;display:flex;flex:1 auto;flex-flow:column nowrap;margin-left:5px}.cards-title{align-content:center;color:var(--ifm-color-primary-dark);font-size:1rem;font-weight:700}.cards-text{margin:1px 1px 1px 5px}.docusaurus-highlight-code-line{background-color:#faff9f;display:block;margin:0 calc(var(--ifm-pre-padding)*-1);padding:0 var(--ifm-pre-padding)}html[data-theme=dark] .docusaurus-highlight-code-line{background-color:#646464}.container.container-custom{width:100%}pre .btnIcon{background-color:hsla(0,0%,100%,.7);border:1px solid transparent;color:#000;cursor:pointer;height:30px;padding:3px;position:absolute;top:4px;transition:.25s ease-out;z-index:2}pre .btnIcon:hover{border:1px solid silver;text-decoration:none}.DocSearch-Button-Container,.btnIcon__body{align-items:center;display:flex}.btnIcon svg{fill:currentColor;margin-right:.4em}.btnIcon__label{font-size:11px}.btnClipboard{right:10px}@font-face{font-family:Socicon;font-style:normal;font-weight:400;src:url(/assets/fonts/Socicon-5e166614f1c831694816befaba8d03cf.eot);src:url(/assets/fonts/Socicon-5e166614f1c831694816befaba8d03cf.eot#iefix) format("embedded-opentype"),url(/assets/fonts/Socicon-d02985133d7e9e09bde470dd54104762.woff2) format("woff2"),url(/assets/fonts/Socicon-48b2d1e286d6b8d6ebefa630301dcf3b.ttf) format("truetype"),url(/assets/fonts/Socicon-9075c233656883ebc65aeb93d2fb76ba.woff) format("woff"),url(/assets/images/Socicon-620cd8c93935433c4e69112bb91768e8.svg#Socicon) format("svg")}[class*=" socicon-"],[class^=socicon-]{speak:none;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;font-family:Socicon!important;font-style:normal;font-variant:normal;font-weight:400;line-height:1;text-transform:none}.socicon-internet:before{content:"\e957"}.socicon-moddb:before{content:"\e94b"}.socicon-indiedb:before{content:"\e94c"}.socicon-traxsource:before{content:"\e94d"}.socicon-gamefor:before{content:"\e94e"}.socicon-pixiv:before{content:"\e94f"}.socicon-myanimelist:before{content:"\e950"}.socicon-blackberry:before{content:"\e951"}.socicon-wickr:before{content:"\e952"}.socicon-spip:before{content:"\e953"}.socicon-napster:before{content:"\e954"}.socicon-beatport:before{content:"\e955"}.socicon-hackerone:before{content:"\e956"}.socicon-hackernews:before{content:"\e946"}.socicon-smashwords:before{content:"\e947"}.socicon-kobo:before{content:"\e948"}.socicon-bookbub:before{content:"\e949"}.socicon-mailru:before{content:"\e94a"}.socicon-gitlab:before{content:"\e945"}.socicon-instructables:before{content:"\e944"}.socicon-portfolio:before{content:"\e943"}.socicon-codered:before{content:"\e940"}.socicon-origin:before{content:"\e941"}.socicon-nextdoor:before{content:"\e942"}.socicon-udemy:before{content:"\e93f"}.socicon-livemaster:before{content:"\e93e"}.socicon-crunchbase:before{content:"\e93b"}.socicon-homefy:before{content:"\e93c"}.socicon-calendly:before{content:"\e93d"}.socicon-realtor:before{content:"\e90f"}.socicon-tidal:before{content:"\e910"}.socicon-qobuz:before{content:"\e911"}.socicon-natgeo:before{content:"\e912"}.socicon-mastodon:before{content:"\e913"}.socicon-unsplash:before{content:"\e914"}.socicon-homeadvisor:before{content:"\e915"}.socicon-angieslist:before{content:"\e916"}.socicon-codepen:before{content:"\e917"}.socicon-slack:before{content:"\e918"}.socicon-openaigym:before{content:"\e919"}.socicon-logmein:before{content:"\e91a"}.socicon-fiverr:before{content:"\e91b"}.socicon-gotomeeting:before{content:"\e91c"}.socicon-aliexpress:before{content:"\e91d"}.socicon-guru:before{content:"\e91e"}.socicon-appstore:before{content:"\e91f"}.socicon-homes:before{content:"\e920"}.socicon-zoom:before{content:"\e921"}.socicon-alibaba:before{content:"\e922"}.socicon-craigslist:before{content:"\e923"}.socicon-wix:before{content:"\e924"}.socicon-redfin:before{content:"\e925"}.socicon-googlecalendar:before{content:"\e926"}.socicon-shopify:before{content:"\e927"}.socicon-freelancer:before{content:"\e928"}.socicon-seedrs:before{content:"\e929"}.socicon-bing:before{content:"\e92a"}.socicon-doodle:before{content:"\e92b"}.socicon-bonanza:before{content:"\e92c"}.socicon-squarespace:before{content:"\e92d"}.socicon-toptal:before{content:"\e92e"}.socicon-gust:before{content:"\e92f"}.socicon-ask:before{content:"\e930"}.socicon-trulia:before{content:"\e931"}.socicon-loomly:before{content:"\e932"}.socicon-ghost:before{content:"\e933"}.socicon-upwork:before{content:"\e934"}.socicon-fundable:before{content:"\e935"}.socicon-booking:before{content:"\e936"}.socicon-googlemaps:before{content:"\e937"}.socicon-zillow:before{content:"\e938"}.socicon-niconico:before{content:"\e939"}.socicon-toneden:before{content:"\e93a"}.socicon-augment:before{content:"\e908"}.socicon-bitbucket:before{content:"\e909"}.socicon-fyuse:before{content:"\e90a"}.socicon-yt-gaming:before{content:"\e90b"}.socicon-sketchfab:before{content:"\e90c"}.socicon-mobcrush:before{content:"\e90d"}.socicon-microsoft:before{content:"\e90e"}.socicon-pandora:before{content:"\e907"}.socicon-messenger:before{content:"\e906"}.socicon-gamewisp:before{content:"\e905"}.socicon-bloglovin:before{content:"\e904"}.socicon-tunein:before{content:"\e903"}.socicon-gamejolt:before{content:"\e901"}.socicon-trello:before{content:"\e902"}.socicon-spreadshirt:before{content:"\e900"}.socicon-500px:before{content:"\e000"}.socicon-8tracks:before{content:"\e001"}.socicon-airbnb:before{content:"\e002"}.socicon-alliance:before{content:"\e003"}.socicon-amazon:before{content:"\e004"}.socicon-amplement:before{content:"\e005"}.socicon-android:before{content:"\e006"}.socicon-angellist:before{content:"\e007"}.socicon-apple:before{content:"\e008"}.socicon-appnet:before{content:"\e009"}.socicon-baidu:before{content:"\e00a"}.socicon-bandcamp:before{content:"\e00b"}.socicon-battlenet:before{content:"\e00c"}.socicon-mixer:before{content:"\e00d"}.socicon-bebee:before{content:"\e00e"}.socicon-bebo:before{content:"\e00f"}.socicon-behance:before{content:"\e010"}.socicon-blizzard:before{content:"\e011"}.socicon-blogger:before{content:"\e012"}.socicon-buffer:before{content:"\e013"}.socicon-chrome:before{content:"\e014"}.socicon-coderwall:before{content:"\e015"}.socicon-curse:before{content:"\e016"}.socicon-dailymotion:before{content:"\e017"}.socicon-deezer:before{content:"\e018"}.socicon-delicious:before{content:"\e019"}.socicon-deviantart:before{content:"\e01a"}.socicon-diablo:before{content:"\e01b"}.socicon-digg:before{content:"\e01c"}.socicon-discord:before{content:"\e01d"}.socicon-disqus:before{content:"\e01e"}.socicon-douban:before{content:"\e01f"}.socicon-draugiem:before{content:"\e020"}.socicon-dribbble:before{content:"\e021"}.socicon-drupal:before{content:"\e022"}.socicon-ebay:before{content:"\e023"}.socicon-ello:before{content:"\e024"}.socicon-endomodo:before{content:"\e025"}.socicon-envato:before{content:"\e026"}.socicon-etsy:before{content:"\e027"}.socicon-facebook:before{content:"\e028"}.socicon-feedburner:before{content:"\e029"}.socicon-filmweb:before{content:"\e02a"}.socicon-firefox:before{content:"\e02b"}.socicon-flattr:before{content:"\e02c"}.socicon-flickr:before{content:"\e02d"}.socicon-formulr:before{content:"\e02e"}.socicon-forrst:before{content:"\e02f"}.socicon-foursquare:before{content:"\e030"}.socicon-friendfeed:before{content:"\e031"}.socicon-github:before{content:"\e032"}.socicon-goodreads:before{content:"\e033"}.socicon-google:before{content:"\e034"}.socicon-googlescholar:before{content:"\e035"}.socicon-googlegroups:before{content:"\e036"}.socicon-googlephotos:before{content:"\e037"}.socicon-googleplus:before{content:"\e038"}.socicon-grooveshark:before{content:"\e039"}.socicon-hackerrank:before{content:"\e03a"}.socicon-hearthstone:before{content:"\e03b"}.socicon-hellocoton:before{content:"\e03c"}.socicon-heroes:before{content:"\e03d"}.socicon-smashcast:before{content:"\e03e"}.socicon-horde:before{content:"\e03f"}.socicon-houzz:before{content:"\e040"}.socicon-icq:before{content:"\e041"}.socicon-identica:before{content:"\e042"}.socicon-imdb:before{content:"\e043"}.socicon-instagram:before{content:"\e044"}.socicon-issuu:before{content:"\e045"}.socicon-istock:before{content:"\e046"}.socicon-itunes:before{content:"\e047"}.socicon-keybase:before{content:"\e048"}.socicon-lanyrd:before{content:"\e049"}.socicon-lastfm:before{content:"\e04a"}.socicon-line:before{content:"\e04b"}.socicon-linkedin:before{content:"\e04c"}.socicon-livejournal:before{content:"\e04d"}.socicon-lyft:before{content:"\e04e"}.socicon-macos:before{content:"\e04f"}.socicon-mail:before{content:"\e050"}.socicon-medium:before{content:"\e051"}.socicon-meetup:before{content:"\e052"}.socicon-mixcloud:before{content:"\e053"}.socicon-modelmayhem:before{content:"\e054"}.socicon-mumble:before{content:"\e055"}.socicon-myspace:before{content:"\e056"}.socicon-newsvine:before{content:"\e057"}.socicon-nintendo:before{content:"\e058"}.socicon-npm:before{content:"\e059"}.socicon-odnoklassniki:before{content:"\e05a"}.socicon-openid:before{content:"\e05b"}.socicon-opera:before{content:"\e05c"}.socicon-outlook:before{content:"\e05d"}.socicon-overwatch:before{content:"\e05e"}.socicon-patreon:before{content:"\e05f"}.socicon-paypal:before{content:"\e060"}.socicon-periscope:before{content:"\e061"}.socicon-persona:before{content:"\e062"}.socicon-pinterest:before{content:"\e063"}.socicon-play:before{content:"\e064"}.socicon-player:before{content:"\e065"}.socicon-playstation:before{content:"\e066"}.socicon-pocket:before{content:"\e067"}.socicon-qq:before{content:"\e068"}.socicon-quora:before{content:"\e069"}.socicon-raidcall:before{content:"\e06a"}.socicon-ravelry:before{content:"\e06b"}.socicon-reddit:before{content:"\e06c"}.socicon-renren:before{content:"\e06d"}.socicon-researchgate:before{content:"\e06e"}.socicon-residentadvisor:before{content:"\e06f"}.socicon-reverbnation:before{content:"\e070"}.socicon-rss:before{content:"\e071"}.socicon-sharethis:before{content:"\e072"}.socicon-skype:before{content:"\e073"}.socicon-slideshare:before{content:"\e074"}.socicon-smugmug:before{content:"\e075"}.socicon-snapchat:before{content:"\e076"}.socicon-songkick:before{content:"\e077"}.socicon-soundcloud:before{content:"\e078"}.socicon-spotify:before{content:"\e079"}.socicon-stackexchange:before{content:"\e07a"}.socicon-stackoverflow:before{content:"\e07b"}.socicon-starcraft:before{content:"\e07c"}.socicon-stayfriends:before{content:"\e07d"}.socicon-steam:before{content:"\e07e"}.socicon-storehouse:before{content:"\e07f"}.socicon-strava:before{content:"\e080"}.socicon-streamjar:before{content:"\e081"}.socicon-stumbleupon:before{content:"\e082"}.socicon-swarm:before{content:"\e083"}.socicon-teamspeak:before{content:"\e084"}.socicon-teamviewer:before{content:"\e085"}.socicon-technorati:before{content:"\e086"}.socicon-telegram:before{content:"\e087"}.socicon-tripadvisor:before{content:"\e088"}.socicon-tripit:before{content:"\e089"}.socicon-triplej:before{content:"\e08a"}.socicon-tumblr:before{content:"\e08b"}.socicon-twitch:before{content:"\e08c"}.socicon-twitter:before{content:"\e08d"}.socicon-uber:before{content:"\e08e"}.socicon-ventrilo:before{content:"\e08f"}.socicon-viadeo:before{content:"\e090"}.socicon-viber:before{content:"\e091"}.socicon-viewbug:before{content:"\e092"}.socicon-vimeo:before{content:"\e093"}.socicon-vine:before{content:"\e094"}.socicon-vkontakte:before{content:"\e095"}.socicon-warcraft:before{content:"\e096"}.socicon-wechat:before{content:"\e097"}.socicon-weibo:before{content:"\e098"}.socicon-whatsapp:before{content:"\e099"}.socicon-wikipedia:before{content:"\e09a"}.socicon-windows:before{content:"\e09b"}.socicon-wordpress:before{content:"\e09c"}.socicon-wykop:before{content:"\e09d"}.socicon-xbox:before{content:"\e09e"}.socicon-xing:before{content:"\e09f"}.socicon-yahoo:before{content:"\e0a0"}.socicon-yammer:before{content:"\e0a1"}.socicon-yandex:before{content:"\e0a2"}.socicon-yelp:before{content:"\e0a3"}.socicon-younow:before{content:"\e0a4"}.socicon-youtube:before{content:"\e0a5"}.socicon-zapier:before{content:"\e0a6"}.socicon-zerply:before{content:"\e0a7"}.socicon-zomato:before{content:"\e0a8"}.socicon-zynga:before{content:"\e0a9"}body:not(.navigation-with-keyboard) :not(input):focus{outline:0}.skipToContent_fXgn{background-color:var(--ifm-background-surface-color);color:var(--ifm-color-emphasis-900);left:100%;padding:calc(var(--ifm-global-spacing)/2) var(--ifm-global-spacing);position:fixed;top:1rem;z-index:calc(var(--ifm-z-index-fixed) + 1)}.skipToContent_fXgn:focus{box-shadow:var(--ifm-global-shadow-md);left:1rem}.closeButton_CVFx{line-height:0;padding:0}.content_knG7{font-size:85%;padding:5px 0;text-align:center}.content_knG7 a{color:inherit;text-decoration:underline}.DocSearch-Container a,.tag_zVej:hover{text-decoration:none}.announcementBar_mb4j{align-items:center;background-color:var(--ifm-color-white);border-bottom:1px solid var(--ifm-color-emphasis-100);color:var(--ifm-color-black);display:flex;height:var(--docusaurus-announcement-bar-height)}.announcementBarPlaceholder_vyr4{flex:0 0 10px}.announcementBarClose_gvF7{align-self:stretch;flex:0 0 30px}.toggle_vylO{height:2rem;width:2rem}.toggleButton_gllP{align-items:center;border-radius:50%;display:flex;height:100%;justify-content:center;transition:background var(--ifm-transition-fast);width:100%}.toggleButton_gllP:hover{background:var(--ifm-color-emphasis-200)}.toggleButtonDisabled_aARS{cursor:not-allowed}.darkNavbarColorModeToggle_X3D1:hover{background:var(--ifm-color-gray-800)}[data-theme=dark] .themedImage--dark_i4oU,[data-theme=light] .themedImage--light_HNdA,html:not([data-theme]) .themedComponent--light_NU7w{display:initial}.iconExternalLink_nPIU{margin-left:.3rem}.iconLanguage_nlXk{margin-right:5px;vertical-align:text-bottom}.navbarHideable_m1mJ{transition:transform var(--ifm-transition-fast) ease}.navbarHidden_jGov{transform:translate3d(0,calc(-100% - 2px),0)}.errorBoundaryError_a6uf{color:red;white-space:pre-wrap}.mainWrapper_z2l0{display:flex;flex:1 0 auto;flex-direction:column}.docusaurus-mt-lg{margin-top:3rem}#__docusaurus{display:flex;flex-direction:column;min-height:100%}.iconEdit_Z9Sw{margin-right:.3em;vertical-align:sub}.tag_zVej{border:1px solid var(--docusaurus-tag-list-border);transition:border var(--ifm-transition-fast)}.tag_zVej:hover{--docusaurus-tag-list-border:var(--ifm-link-color)}.tagRegular_sFm0{border-radius:var(--ifm-global-radius);font-size:90%;padding:.2rem .5rem .3rem}.tagWithCount_h2kH{align-items:center;border-left:0;display:flex;padding:0 .5rem 0 1rem;position:relative}.tagWithCount_h2kH:after,.tagWithCount_h2kH:before{border:1px solid var(--docusaurus-tag-list-border);content:"";position:absolute;top:50%;transition:inherit}.tagWithCount_h2kH:before{border-bottom:0;border-right:0;height:1.18rem;right:100%;transform:translate(50%,-50%) rotate(-45deg);width:1.18rem}.tagWithCount_h2kH:after{border-radius:50%;height:.5rem;left:0;transform:translateY(-50%);width:.5rem}.tagWithCount_h2kH span{background:var(--ifm-color-secondary);border-radius:var(--ifm-global-radius);color:var(--ifm-color-black);font-size:.7rem;line-height:1.2;margin-left:.3rem;padding:.1rem .4rem}.tags_jXut{display:inline}.tag_QGVx{display:inline-block;margin:0 .4rem .5rem 0}.lastUpdated_vwxv{font-size:smaller;font-style:italic;margin-top:.2rem}.tocCollapsibleButton_TO0P{align-items:center;display:flex;font-size:inherit;justify-content:space-between;padding:.4rem .8rem;width:100%}.tocCollapsibleButton_TO0P:after{background:var(--ifm-menu-link-sublist-icon) 50% 50%/2rem 2rem no-repeat;content:"";filter:var(--ifm-menu-link-sublist-icon-filter);height:1.25rem;transform:rotate(180deg);transition:transform var(--ifm-transition-fast);width:1.25rem}.tocCollapsibleButtonExpanded_MG3E:after,.tocCollapsibleExpanded_sAul{transform:none}.tocCollapsible_ETCw{background-color:var(--ifm-menu-color-background-active);border-radius:var(--ifm-global-radius);margin:1rem 0}.tocCollapsibleContent_vkbj>ul{border-left:none;border-top:1px solid var(--ifm-color-emphasis-300);font-size:15px;padding:.2rem 0}.tocCollapsibleContent_vkbj ul li{margin:.4rem .8rem}.tocCollapsibleContent_vkbj a{display:block}.tableOfContents_bqdL{max-height:calc(100vh - var(--ifm-navbar-height) - 2rem);overflow-y:auto;position:sticky;top:calc(var(--ifm-navbar-height) + 1rem)}.searchQueryInput_u2C7,.searchVersionInput_m0Ui{background:var(--docsearch-searchbox-focus-background);border:2px solid var(--ifm-toc-border-color);border-radius:var(--ifm-global-radius);color:var(--docsearch-text-color);font:var(--ifm-font-size-base) var(--ifm-font-family-base);margin-bottom:.5rem;padding:.8rem;transition:border var(--ifm-transition-fast) ease;width:100%}.searchQueryInput_u2C7:focus,.searchVersionInput_m0Ui:focus{border-color:var(--docsearch-primary-color);outline:0}.searchQueryInput_u2C7::-moz-placeholder{color:var(--docsearch-muted-color)}.searchQueryInput_u2C7::placeholder{color:var(--docsearch-muted-color)}.searchResultsColumn_JPFH{font-size:.9rem;font-weight:700}.algoliaLogo_rT1R{max-width:150px}.algoliaLogoPathFill_WdUC{fill:var(--ifm-font-color-base)}.searchResultItem_Tv2o{border-bottom:1px solid var(--ifm-toc-border-color);padding:1rem 0}.searchResultItemHeading_KbCB{font-weight:400;margin-bottom:0}.searchResultItemPath_lhe1{--ifm-breadcrumb-separator-size-multiplier:1;color:var(--ifm-color-content-secondary);font-size:.8rem}.searchResultItemSummary_AEaO{font-style:italic;margin:.5rem 0 0}.loadingSpinner_XVxU{animation:1s linear infinite a;border:.4em solid #eee;border-radius:50%;border-top:.4em solid var(--ifm-color-primary);height:3rem;margin:0 auto;width:3rem}@keyframes a{to{transform:rotate(1turn)}}.loader_vvXV{margin-top:2rem}.search-result-match{background:rgba(255,215,142,.25);color:var(--docsearch-hit-color);padding:.09em 0}.backToTopButton_sjWU{background-color:var(--ifm-color-emphasis-200);border-radius:50%;bottom:1.3rem;box-shadow:var(--ifm-global-shadow-lw);height:3rem;opacity:0;position:fixed;right:1.3rem;transform:scale(0);transition:all var(--ifm-transition-fast) var(--ifm-transition-timing-default);visibility:hidden;width:3rem;z-index:calc(var(--ifm-z-index-fixed) - 1)}.backToTopButton_sjWU:after{background-color:var(--ifm-color-emphasis-1000);content:" ";display:inline-block;height:100%;-webkit-mask:var(--ifm-menu-link-sublist-icon) 50%/2rem 2rem no-repeat;mask:var(--ifm-menu-link-sublist-icon) 50%/2rem 2rem no-repeat;width:100%}.backToTopButtonShow_xfvO{opacity:1;transform:scale(1);visibility:visible}[data-theme=dark]:root{--docusaurus-collapse-button-bg:hsla(0,0%,100%,.05);--docusaurus-collapse-button-bg-hover:hsla(0,0%,100%,.1)}.collapseSidebarButton_PEFL{display:none;margin:0}.docMainContainer_gTbr,.docPage__5DB{display:flex;width:100%}.docPage__5DB{flex:1 0}.docsWrapper_BCFX{display:flex;flex:1 0 auto}.cardContainer_fWXF{--ifm-link-color:var(--ifm-color-emphasis-800);--ifm-link-hover-color:var(--ifm-color-emphasis-700);--ifm-link-hover-decoration:none;border:1px solid var(--ifm-color-emphasis-200);box-shadow:0 1.5px 3px 0 rgba(0,0,0,.15);transition:all var(--ifm-transition-fast) ease;transition-property:border,box-shadow}.cardContainer_fWXF:hover{border-color:var(--ifm-color-primary);box-shadow:0 3px 6px 0 rgba(0,0,0,.2)}.cardDescription_PWke{font-size:.8rem}.DocSearch-Button{align-items:center;background:var(--docsearch-searchbox-background);border:0;border-radius:40px;color:var(--docsearch-muted-color);cursor:pointer;display:flex;font-weight:500;height:36px;justify-content:space-between;padding:0 8px;user-select:none}.DocSearch-Footer,.DocSearch-Help{-webkit-user-select:none;-moz-user-select:none}.DocSearch-Button:active,.DocSearch-Button:focus,.DocSearch-Button:hover{background:var(--docsearch-searchbox-focus-background);box-shadow:var(--docsearch-searchbox-shadow);color:var(--docsearch-text-color);outline:0}.DocSearch-Search-Icon{stroke-width:1.6}.DocSearch-Hit-Tree,.DocSearch-Hit-action,.DocSearch-Hit-icon,.DocSearch-Reset{stroke-width:var(--docsearch-icon-stroke-width)}.DocSearch-Button .DocSearch-Search-Icon{color:var(--docsearch-text-color)}.DocSearch-Button-Placeholder{font-size:1rem;padding:0 12px 0 6px}.DocSearch-Input,.DocSearch-Link{-webkit-appearance:none;-moz-appearance:none;font:inherit}.DocSearch-Button-Keys{display:flex;min-width:calc(40px + .8em)}.DocSearch-Button-Key{align-items:center;background:var(--docsearch-key-gradient);border:0;border-radius:3px;box-shadow:var(--docsearch-key-shadow);color:var(--docsearch-muted-color);display:flex;height:18px;justify-content:center;margin-right:.4em;padding:0 0 2px;position:relative;top:-1px;width:20px}.DocSearch--active{overflow:hidden!important}.DocSearch-Container{background-color:var(--docsearch-container-background);height:100vh;left:0;position:fixed;top:0;width:100vw;z-index:200}.DocSearch-Link{appearance:none;background:none;border:0;color:var(--docsearch-highlight-color);cursor:pointer;margin:0;padding:0}.DocSearch-Modal{background:var(--docsearch-modal-background);border-radius:6px;box-shadow:var(--docsearch-modal-shadow);flex-direction:column;margin:60px auto auto;max-width:var(--docsearch-modal-width);position:relative}.DocSearch-SearchBar{display:flex;padding:var(--docsearch-spacing) var(--docsearch-spacing) 0}.DocSearch-Form{align-items:center;background:var(--docsearch-searchbox-focus-background);border-radius:4px;box-shadow:var(--docsearch-searchbox-shadow);display:flex;height:var(--docsearch-searchbox-height);margin:0;padding:0 var(--docsearch-spacing);position:relative;width:100%}.DocSearch-Input{appearance:none;background:0 0;border:0;color:var(--docsearch-text-color);flex:1;font-size:1.2em;height:100%;outline:0;padding:0 0 0 8px;width:80%}.DocSearch-Hit-action-button,.DocSearch-Reset{-webkit-appearance:none;-moz-appearance:none;border:0;cursor:pointer}.DocSearch-Input::-moz-placeholder{color:var(--docsearch-muted-color);opacity:1}.DocSearch-Input::placeholder{color:var(--docsearch-muted-color);opacity:1}.DocSearch-Input::-webkit-search-cancel-button,.DocSearch-Input::-webkit-search-decoration,.DocSearch-Input::-webkit-search-results-button,.DocSearch-Input::-webkit-search-results-decoration{display:none}.DocSearch-LoadingIndicator,.DocSearch-MagnifierLabel,.DocSearch-Reset{margin:0;padding:0}.DocSearch-Container--Stalled .DocSearch-LoadingIndicator,.DocSearch-MagnifierLabel,.DocSearch-Reset{align-items:center;color:var(--docsearch-highlight-color);display:flex;justify-content:center}.DocSearch-Cancel,.DocSearch-Container--Stalled .DocSearch-MagnifierLabel,.DocSearch-LoadingIndicator,.DocSearch-Reset[hidden]{display:none}.DocSearch-Reset{animation:.1s ease-in forwards b;appearance:none;background:none;border-radius:50%;color:var(--docsearch-icon-color);padding:2px;right:0}.DocSearch-Help,.DocSearch-HitsFooter,.DocSearch-Label{color:var(--docsearch-muted-color)}.DocSearch-Reset:hover{color:var(--docsearch-highlight-color)}.DocSearch-LoadingIndicator svg,.DocSearch-MagnifierLabel svg{height:24px;width:24px}.DocSearch-Dropdown{max-height:calc(var(--docsearch-modal-height) - var(--docsearch-searchbox-height) - var(--docsearch-spacing) - var(--docsearch-footer-height));min-height:var(--docsearch-spacing);overflow-y:auto;overflow-y:overlay;padding:0 var(--docsearch-spacing);scrollbar-color:var(--docsearch-muted-color) var(--docsearch-modal-background);scrollbar-width:thin}.DocSearch-Dropdown::-webkit-scrollbar{width:12px}.DocSearch-Dropdown::-webkit-scrollbar-track{background:0 0}.DocSearch-Dropdown::-webkit-scrollbar-thumb{background-color:var(--docsearch-muted-color);border:3px solid var(--docsearch-modal-background);border-radius:20px}.DocSearch-Dropdown ul{list-style:none;margin:0;padding:0}.DocSearch-Label{font-size:.75em;line-height:1.6em}.DocSearch-Help{font-size:.9em;margin:0;user-select:none}.DocSearch-Title{font-size:1.2em}.DocSearch-Logo a{display:flex}.DocSearch-Logo svg{color:var(--docsearch-logo-color);margin-left:8px}.DocSearch-Hits:last-of-type{margin-bottom:24px}.DocSearch-Hits mark{background:none;color:var(--docsearch-highlight-color)}.DocSearch-HitsFooter{display:flex;font-size:.85em;justify-content:center;margin-bottom:var(--docsearch-spacing);padding:var(--docsearch-spacing)}.DocSearch-HitsFooter a{border-bottom:1px solid;color:inherit}.DocSearch-Hit{border-radius:4px;display:flex;padding-bottom:4px;position:relative}.DocSearch-Hit--deleting{opacity:0;transition:.25s linear}.DocSearch-Hit--favoriting{transform:scale(0);transform-origin:top center;transition:.25s linear .25s}.DocSearch-Hit a{background:var(--docsearch-hit-background);border-radius:4px;box-shadow:var(--docsearch-hit-shadow);display:block;padding-left:var(--docsearch-spacing);width:100%}.DocSearch-Hit-source{background:var(--docsearch-modal-background);color:var(--docsearch-highlight-color);font-size:.85em;font-weight:600;line-height:32px;margin:0 -4px;padding:8px 4px 0;position:sticky;top:0;z-index:10}.DocSearch-Hit-Tree{color:var(--docsearch-muted-color);height:var(--docsearch-hit-height);opacity:.5;width:24px}.DocSearch-Hit[aria-selected=true] a{background-color:var(--docsearch-highlight-color)}.DocSearch-Hit[aria-selected=true] mark{text-decoration:underline}.DocSearch-Hit-Container{align-items:center;color:var(--docsearch-hit-color);display:flex;flex-direction:row;height:var(--docsearch-hit-height);padding:0 var(--docsearch-spacing) 0 0}.DocSearch-Hit-icon{height:20px;width:20px}.DocSearch-Hit-action,.DocSearch-Hit-icon{color:var(--docsearch-muted-color)}.DocSearch-Hit-action{align-items:center;display:flex;height:22px;width:22px}.DocSearch-Hit-action svg{display:block;height:18px;width:18px}.DocSearch-Hit-action+.DocSearch-Hit-action{margin-left:6px}.DocSearch-Hit-action-button{appearance:none;background:none;border-radius:50%;color:inherit;padding:2px}svg.DocSearch-Hit-Select-Icon{display:none}.DocSearch-Hit[aria-selected=true] .DocSearch-Hit-Select-Icon{display:block}.DocSearch-Hit-action-button:focus,.DocSearch-Hit-action-button:hover{background:rgba(0,0,0,.2);transition:background-color .1s ease-in}.DocSearch-Hit-action-button:focus path,.DocSearch-Hit-action-button:hover path{fill:#fff}.DocSearch-Hit-content-wrapper{display:flex;flex:1 1 auto;flex-direction:column;font-weight:500;justify-content:center;line-height:1.2em;margin:0 8px;overflow-x:hidden;position:relative;text-overflow:ellipsis;white-space:nowrap;width:80%}.DocSearch-Hit-title{font-size:.9em}.DocSearch-Hit-path{color:var(--docsearch-muted-color);font-size:.75em}.DocSearch-Hit[aria-selected=true] .DocSearch-Hit-Tree,.DocSearch-Hit[aria-selected=true] .DocSearch-Hit-action,.DocSearch-Hit[aria-selected=true] .DocSearch-Hit-icon,.DocSearch-Hit[aria-selected=true] .DocSearch-Hit-path,.DocSearch-Hit[aria-selected=true] .DocSearch-Hit-text,.DocSearch-Hit[aria-selected=true] .DocSearch-Hit-title,.DocSearch-Hit[aria-selected=true] mark{color:var(--docsearch-hit-active-color)!important}.DocSearch-ErrorScreen,.DocSearch-NoResults,.DocSearch-StartScreen{font-size:.9em;margin:0 auto;padding:36px 0;text-align:center;width:80%}.DocSearch-Screen-Icon{color:var(--docsearch-muted-color);padding-bottom:12px}.DocSearch-NoResults-Prefill-List{display:inline-block;padding-bottom:24px;text-align:left}.DocSearch-NoResults-Prefill-List ul{display:inline-block;padding:8px 0 0}.DocSearch-NoResults-Prefill-List li{list-style-position:inside;list-style-type:"» "}.DocSearch-Prefill{-webkit-appearance:none;-moz-appearance:none;appearance:none;background:none;border:0;border-radius:1em;color:var(--docsearch-highlight-color);cursor:pointer;display:inline-block;font-size:1em;font-weight:700;padding:0}.DocSearch-Prefill:focus,.DocSearch-Prefill:hover{outline:0;text-decoration:underline}.DocSearch-Footer{align-items:center;background:var(--docsearch-footer-background);border-radius:0 0 8px 8px;box-shadow:var(--docsearch-footer-shadow);display:flex;flex-direction:row-reverse;flex-shrink:0;height:var(--docsearch-footer-height);justify-content:space-between;padding:0 var(--docsearch-spacing);position:relative;user-select:none;width:100%;z-index:300}.DocSearch-Commands li,.DocSearch-Commands-Key{align-items:center;display:flex}.DocSearch-Commands{color:var(--docsearch-muted-color);display:flex;list-style:none;margin:0;padding:0}.DocSearch-Commands li:not(:last-of-type){margin-right:.8em}.DocSearch-Commands-Key{background:var(--docsearch-key-gradient);border:0;border-radius:2px;box-shadow:var(--docsearch-key-shadow);color:var(--docsearch-muted-color);height:18px;justify-content:center;margin-right:.4em;padding:0 0 1px;width:20px}.buttonGroup__atx button,.codeBlockContainer_Ckt0{background:var(--prism-background-color);color:var(--prism-color)}@keyframes b{0%{opacity:0}to{opacity:1}}.DocSearch-Button{margin:0;transition:all var(--ifm-transition-fast) var(--ifm-transition-timing-default)}.DocSearch-Container{z-index:calc(var(--ifm-z-index-fixed) + 1)}.anchorWithStickyNavbar_LWe7{scroll-margin-top:calc(var(--ifm-navbar-height) + .5rem)}.anchorWithHideOnScrollNavbar_WYt5{scroll-margin-top:.5rem}.hash-link{opacity:0;padding-left:.5rem;transition:opacity var(--ifm-transition-fast);-webkit-user-select:none;-moz-user-select:none;user-select:none}.hash-link:before{content:"#"}.codeBlockContainer_Ckt0{border-radius:var(--ifm-code-border-radius);box-shadow:var(--ifm-global-shadow-lw);margin-bottom:var(--ifm-leading)}.codeBlockContent_biex{border-radius:inherit;direction:ltr;position:relative}.codeBlockTitle_Ktv7{border-bottom:1px solid var(--ifm-color-emphasis-300);border-top-left-radius:inherit;border-top-right-radius:inherit;font-size:var(--ifm-code-font-size);font-weight:500;padding:.75rem var(--ifm-pre-padding)}.codeBlock_bY9V{--ifm-pre-background:var(--prism-background-color);margin:0;padding:0}.codeBlockTitle_Ktv7+.codeBlockContent_biex .codeBlock_bY9V{border-top-left-radius:0;border-top-right-radius:0}.codeBlockLines_e6Vv{float:left;font:inherit;min-width:100%;padding:var(--ifm-pre-padding)}.codeBlockLinesWithNumbering_o6Pm{display:table;padding:var(--ifm-pre-padding) 0}.buttonGroup__atx{-moz-column-gap:.2rem;column-gap:.2rem;display:flex;position:absolute;right:calc(var(--ifm-pre-padding)/2);top:calc(var(--ifm-pre-padding)/2)}.buttonGroup__atx button{align-items:center;border:1px solid var(--ifm-color-emphasis-300);border-radius:var(--ifm-global-radius);display:flex;line-height:0;opacity:0;padding:.4rem;transition:opacity var(--ifm-transition-fast) ease-in-out}.buttonGroup__atx button:focus-visible,.buttonGroup__atx button:hover{opacity:1!important}.theme-code-block:hover .buttonGroup__atx button{opacity:.4}:where(:root){--docusaurus-highlighted-code-line-bg:#484d5b}:where([data-theme=dark]){--docusaurus-highlighted-code-line-bg:#646464}.theme-code-block-highlighted-line{background-color:var(--docusaurus-highlighted-code-line-bg);display:block;margin:0 calc(var(--ifm-pre-padding)*-1);padding:0 var(--ifm-pre-padding)}.codeLine_lJS_{counter-increment:a;display:table-row}.codeLineNumber_Tfdd{background:var(--ifm-pre-background);display:table-cell;left:0;overflow-wrap:normal;padding:0 var(--ifm-pre-padding);position:sticky;text-align:right;width:1%}.codeLineNumber_Tfdd:before{content:counter(a);opacity:.4}.codeLineContent_feaV{padding-right:var(--ifm-pre-padding)}.theme-code-block:hover .copyButtonCopied_obH4{opacity:1!important}.copyButtonIcons_eSgA{height:1.125rem;position:relative;width:1.125rem}.copyButtonIcon_y97N,.copyButtonSuccessIcon_LjdS{fill:currentColor;height:inherit;left:0;opacity:inherit;position:absolute;top:0;transition:all var(--ifm-transition-fast) ease;width:inherit}.copyButtonSuccessIcon_LjdS{color:#00d600;left:50%;opacity:0;top:50%;transform:translate(-50%,-50%) scale(.33)}.copyButtonCopied_obH4 .copyButtonIcon_y97N{opacity:0;transform:scale(.33)}.copyButtonCopied_obH4 .copyButtonSuccessIcon_LjdS{opacity:1;transform:translate(-50%,-50%) scale(1);transition-delay:75ms}.wordWrapButtonIcon_Bwma{height:1.2rem;width:1.2rem}.details_lb9f{--docusaurus-details-summary-arrow-size:0.38rem;--docusaurus-details-transition:transform 200ms ease;--docusaurus-details-decoration-color:grey}.details_lb9f>summary{cursor:pointer;list-style:none;padding-left:1rem;position:relative}.details_lb9f>summary::-webkit-details-marker{display:none}.details_lb9f>summary:before{border-color:transparent transparent transparent var(--docusaurus-details-decoration-color);border-style:solid;border-width:var(--docusaurus-details-summary-arrow-size);content:"";left:0;position:absolute;top:.45rem;transform:rotate(0);transform-origin:calc(var(--docusaurus-details-summary-arrow-size)/2) 50%;transition:var(--docusaurus-details-transition)}.collapsibleContent_i85q{border-top:1px solid var(--docusaurus-details-decoration-color);margin-top:1rem;padding-top:1rem}.details_b_Ee{--docusaurus-details-decoration-color:var(--ifm-alert-border-color);--docusaurus-details-transition:transform var(--ifm-transition-fast) ease;border:1px solid var(--ifm-alert-border-color);margin:0 0 var(--ifm-spacing-vertical)}.containsTaskList_mC6p{list-style:none}.admonition_LlT9{margin-bottom:1em}.admonitionHeading_tbUL{font:var(--ifm-heading-font-weight) var(--ifm-h5-font-size)/var(--ifm-heading-line-height) var(--ifm-heading-font-family);margin-bottom:.3rem;text-transform:uppercase}.admonitionHeading_tbUL code{text-transform:none}.admonitionIcon_kALy{display:inline-block;margin-right:.4em;vertical-align:middle}.admonitionIcon_kALy svg{fill:var(--ifm-alert-foreground-color);display:inline-block;height:1.6em;width:1.6em}.breadcrumbHomeIcon_YNFT{height:1.1rem;position:relative;top:1px;vertical-align:top;width:1.1rem}.breadcrumbsContainer_Z_bl{--ifm-breadcrumb-size-multiplier:0.8;margin-bottom:.8rem}.title_kItE{--ifm-h1-font-size:3rem;margin-bottom:calc(var(--ifm-leading)*1.25)}@media (min-width:576px){.container.container-custom{max-width:540px}}@media (min-width:768px){.nav-footer.spacer-y-4{padding-bottom:6rem;padding-top:6rem}.nav-footer .py-md-1{padding-bottom:.375rem!important;padding-top:.375rem!important}.container.container-custom{max-width:720px}}@media (min-width:992px){.homeNavContainer{height:90vh;max-height:900px;min-height:600px}.homeNavItem{border-radius:3.25rem!important;margin-top:-3rem;min-height:400px;transition:.15s ease-in-out}.homeNavItem:after{-webkit-font-feature-settings:"liga";bottom:3rem;color:var(--silverColor);content:"arrow_upward";font-family:Material Icons;font-size:1.5rem;left:50%;opacity:0;position:absolute;transform:translate(-50%);transition:.2s ease-in-out}.homeNavItem:hover{box-shadow:0 1rem 3rem rgba(0,0,0,.04);transform:translateY(-1rem)}.homeNavItem:hover:after{opacity:1}.homeNavItemContent{margin-top:10%}.homeNavItem h1{font-size:4.2vw}.container.container-custom{max-width:960px}}@media (min-width:997px){.collapseSidebarButton_PEFL,.expandButton_m80_{background-color:var(--docusaurus-collapse-button-bg)}:root{--docusaurus-announcement-bar-height:30px}.announcementBarClose_gvF7,.announcementBarPlaceholder_vyr4{flex-basis:50px}.searchBox_ZlJk{padding:var(--ifm-navbar-item-padding-vertical) var(--ifm-navbar-item-padding-horizontal)}.lastUpdated_vwxv{text-align:right}.tocMobile_ITEo{display:none}.collapseSidebarButton_PEFL{border:1px solid var(--ifm-toc-border-color);border-radius:0;bottom:0;display:block!important;height:40px;position:sticky}.collapseSidebarButtonIcon_kv0_{margin-top:4px;transform:rotate(180deg)}.expandButtonIcon_BlDH,[dir=rtl] .collapseSidebarButtonIcon_kv0_{transform:rotate(0)}.collapseSidebarButton_PEFL:focus,.collapseSidebarButton_PEFL:hover,.expandButton_m80_:focus,.expandButton_m80_:hover{background-color:var(--docusaurus-collapse-button-bg-hover)}.menuHtmlItem_M9Kj{padding:var(--ifm-menu-link-padding-vertical) var(--ifm-menu-link-padding-horizontal)}.menu_SIkG{flex-grow:1;padding:.5rem}@supports (scrollbar-gutter:stable){.menu_SIkG{padding:.5rem 0 .5rem .5rem;scrollbar-gutter:stable}}.menuWithAnnouncementBar_GW3s{margin-bottom:var(--docusaurus-announcement-bar-height)}.sidebar_njMd{display:flex;flex-direction:column;height:100%;padding-top:var(--ifm-navbar-height);width:var(--doc-sidebar-width)}.sidebarWithHideableNavbar_wUlq{padding-top:0}.sidebarHidden_VK0M{opacity:0;visibility:hidden}.sidebarLogo_isFc{align-items:center;color:inherit!important;display:flex!important;margin:0 var(--ifm-navbar-padding-horizontal);max-height:var(--ifm-navbar-height);min-height:var(--ifm-navbar-height);text-decoration:none!important}.sidebarLogo_isFc img{height:2rem;margin-right:.5rem}.expandButton_m80_{align-items:center;display:flex;height:100%;justify-content:center;position:absolute;right:0;top:0;transition:background-color var(--ifm-transition-fast) ease;width:100%}[dir=rtl] .expandButtonIcon_BlDH{transform:rotate(180deg)}.docSidebarContainer_b6E3{border-right:1px solid var(--ifm-toc-border-color);-webkit-clip-path:inset(0);clip-path:inset(0);display:block;margin-top:calc(var(--ifm-navbar-height)*-1);transition:width var(--ifm-transition-fast) ease;width:var(--doc-sidebar-width);will-change:width}.docSidebarContainerHidden_b3ry{cursor:pointer;width:var(--doc-sidebar-hidden-width)}.sidebarViewport_Xe31{height:100%;max-height:100vh;position:sticky;top:0}.docMainContainer_gTbr{flex-grow:1;max-width:calc(100% - var(--doc-sidebar-width))}.docMainContainerEnhanced_Uz_u{max-width:calc(100% - var(--doc-sidebar-hidden-width))}.docItemWrapperEnhanced_czyv{max-width:calc(var(--ifm-container-width) + var(--doc-sidebar-width))!important}.docItemCol_VOVn,.generatedIndexPage_vN6x{max-width:75%!important}.list_eTzJ article:nth-last-child(-n+2){margin-bottom:0!important}}@media only screen and (min-width:1024px){.navbar__inner a.navbar__item[href*=contributing]{background:#fff;border:1px solid var(--ifm-color-primary);border-radius:20px;color:var(--ifm-color-primary);font-size:14px;font-weight:700;height:35px;line-height:35px;margin-left:16px;padding:0 16px}.navbar__inner a.navbar__item[href*=contributing]:hover{background:var(--ifm-color-primary);color:#fff}}@media (min-width:1200px){.homeNavItem h1{font-size:3.5rem;line-height:1.2}.container.container-custom{max-width:1140px}}@media (min-width:1440px){.container{max-width:var(--ifm-container-width-xl)}}@media (max-width:996px){.col{--ifm-col-width:100%;flex-basis:var(--ifm-col-width);margin-left:0}.footer{--ifm-footer-padding-horizontal:0}.colorModeToggle_DEke,.footer__link-separator,.navbar__item,.tableOfContents_bqdL{display:none}.footer__col{margin-bottom:calc(var(--ifm-spacing-vertical)*3)}.footer__link-item{display:block}.hero{padding-left:0;padding-right:0}.navbar>.container,.navbar>.container-fluid{padding:0}.navbar__toggle{display:inherit}.navbar__search-input{width:9rem}.pills--block,.tabs--block{flex-direction:column}.searchBox_ZlJk{position:absolute;right:var(--ifm-navbar-padding-horizontal)}.docItemContainer_F8PC{padding:0 .3rem}}@media only screen and (max-width:996px){.searchQueryColumn_RTkw,.searchResultsColumn_JPFH{max-width:60%!important}.searchLogoColumn_rJIA,.searchVersionColumn_ypXd{max-width:40%!important}.searchLogoColumn_rJIA{padding-left:0!important}}@media (max-width:768px){.DocSearch-Button-Keys,.DocSearch-Button-Placeholder,.DocSearch-Commands,.DocSearch-Hit-Tree{display:none}:root{--docsearch-spacing:10px;--docsearch-footer-height:40px}.DocSearch-Dropdown{height:100%;max-height:calc(var(--docsearch-vh,1vh)*100 - var(--docsearch-searchbox-height) - var(--docsearch-spacing) - var(--docsearch-footer-height))}.DocSearch-Container{height:100vh;height:-webkit-fill-available;height:calc(var(--docsearch-vh,1vh)*100);position:absolute}.DocSearch-Footer{border-radius:0;bottom:0;position:absolute}.DocSearch-Hit-content-wrapper{display:flex;position:relative;width:80%}.DocSearch-Modal{border-radius:0;box-shadow:none;height:100vh;height:-webkit-fill-available;height:calc(var(--docsearch-vh,1vh)*100);margin:0;max-width:100%;width:100%}.DocSearch-Cancel{-webkit-appearance:none;-moz-appearance:none;appearance:none;background:none;border:0;color:var(--docsearch-highlight-color);cursor:pointer;display:inline-block;flex:none;font:inherit;font-size:1em;font-weight:500;margin-left:var(--docsearch-spacing);outline:0;overflow:hidden;padding:0;-webkit-user-select:none;-moz-user-select:none;user-select:none;white-space:nowrap}}@media only screen and (max-width:750px){.DocSearch.DocSearch-Button{width:38px}}@media (max-width:576px){.markdown h1:first-child{--ifm-h1-font-size:2rem}.markdown>h2{--ifm-h2-font-size:1.5rem}.markdown>h3{--ifm-h3-font-size:1.25rem}}@media screen and (max-width:576px){.searchQueryColumn_RTkw{max-width:100%!important}.searchVersionColumn_ypXd{max-width:100%!important;padding-left:var(--ifm-spacing-horizontal)!important}}@media (hover:hover){.backToTopButton_sjWU:hover{background-color:var(--ifm-color-emphasis-300)}}@media (pointer:fine){.thin-scrollbar{scrollbar-width:thin}.thin-scrollbar::-webkit-scrollbar{height:var(--ifm-scrollbar-size);width:var(--ifm-scrollbar-size)}.thin-scrollbar::-webkit-scrollbar-track{background:var(--ifm-scrollbar-track-background-color);border-radius:10px}.thin-scrollbar::-webkit-scrollbar-thumb{background:var(--ifm-scrollbar-thumb-background-color);border-radius:10px}.thin-scrollbar::-webkit-scrollbar-thumb:hover{background:var(--ifm-scrollbar-thumb-hover-background-color)}}@media (prefers-reduced-motion:reduce){:root{--ifm-transition-fast:0ms;--ifm-transition-slow:0ms}}@media screen and (prefers-reduced-motion:reduce){.DocSearch-Reset{stroke-width:var(--docsearch-icon-stroke-width);animation:none;-webkit-appearance:none;-moz-appearance:none;appearance:none;background:none;border:0;border-radius:50%;color:var(--docsearch-icon-color);cursor:pointer;right:0}.DocSearch-Hit--deleting,.DocSearch-Hit--favoriting{transition:none}.DocSearch-Hit-action-button:focus,.DocSearch-Hit-action-button:hover{background:rgba(0,0,0,.2);transition:none}}@media print{.announcementBar_mb4j,.footer,.menu,.navbar,.pagination-nav,.table-of-contents,.tocMobile_ITEo{display:none}.tabs{page-break-inside:avoid}.codeBlockLines_e6Vv{white-space:pre-wrap}} \ No newline at end of file diff --git a/assets/css/styles.87a34ff4.css b/assets/css/styles.87a34ff4.css new file mode 100644 index 000000000000..dec80e555ae5 --- /dev/null +++ b/assets/css/styles.87a34ff4.css @@ -0,0 +1 @@ +.col,.container{padding:0 var(--ifm-spacing-horizontal);width:100%}.markdown>h2,.markdown>h3,.markdown>h4,.markdown>h5,.markdown>h6{margin-bottom:calc(var(--ifm-heading-vertical-rhythm-bottom)*var(--ifm-leading))}pre,table{overflow:auto}blockquote,pre{margin:0 0 var(--ifm-spacing-vertical)}.breadcrumbs__link,.button{transition-timing-function:var(--ifm-transition-timing-default)}.DocSearch-Button,.button{-webkit-user-select:none;-moz-user-select:none}.button,code{vertical-align:middle}.button--outline.button--active,.button--outline:active,.button--outline:hover,:root{--ifm-button-color:var(--ifm-font-color-base-inverse)}.dropdown,pre{position:relative}.menu__link:hover,a{transition:color var(--ifm-transition-fast) var(--ifm-transition-timing-default)}.navbar--dark,:root{--ifm-navbar-link-hover-color:var(--ifm-color-primary)}.menu,.navbar-sidebar{overflow-x:hidden}:root,html[data-theme=dark]{--ifm-color-emphasis-500:var(--ifm-color-gray-500)}.markdown li,body{word-wrap:break-word}.toggleButton_gllP,html{-webkit-tap-highlight-color:transparent}*,.DocSearch-Container,.DocSearch-Container *{box-sizing:border-box}:root{--ifm-color-scheme:light;--ifm-dark-value:10%;--ifm-darker-value:15%;--ifm-darkest-value:30%;--ifm-light-value:15%;--ifm-lighter-value:30%;--ifm-lightest-value:50%;--ifm-contrast-background-value:90%;--ifm-contrast-foreground-value:70%;--ifm-contrast-background-dark-value:70%;--ifm-contrast-foreground-dark-value:90%;--ifm-color-primary:#3578e5;--ifm-color-secondary:#ebedf0;--ifm-color-success:#00a400;--ifm-color-info:#54c7ec;--ifm-color-warning:#ffba00;--ifm-color-danger:#fa383e;--ifm-color-primary-dark:#306cce;--ifm-color-primary-darker:#2d66c3;--ifm-color-primary-darkest:#2554a0;--ifm-color-primary-light:#538ce9;--ifm-color-primary-lighter:#72a1ed;--ifm-color-primary-lightest:#9abcf2;--ifm-color-primary-contrast-background:#ebf2fc;--ifm-color-primary-contrast-foreground:#102445;--ifm-color-secondary-dark:#d4d5d8;--ifm-color-secondary-darker:#c8c9cc;--ifm-color-secondary-darkest:#a4a6a8;--ifm-color-secondary-light:#eef0f2;--ifm-color-secondary-lighter:#f1f2f5;--ifm-color-secondary-lightest:#f5f6f8;--ifm-color-secondary-contrast-background:#fdfdfe;--ifm-color-secondary-contrast-foreground:#474748;--ifm-color-success-dark:#009400;--ifm-color-success-darker:#008b00;--ifm-color-success-darkest:#007300;--ifm-color-success-light:#26b226;--ifm-color-success-lighter:#4dbf4d;--ifm-color-success-lightest:#80d280;--ifm-color-success-contrast-background:#e6f6e6;--ifm-color-success-contrast-foreground:#003100;--ifm-color-info-dark:#4cb3d4;--ifm-color-info-darker:#47a9c9;--ifm-color-info-darkest:#3b8ba5;--ifm-color-info-light:#6ecfef;--ifm-color-info-lighter:#87d8f2;--ifm-color-info-lightest:#aae3f6;--ifm-color-info-contrast-background:#eef9fd;--ifm-color-info-contrast-foreground:#193c47;--ifm-color-warning-dark:#e6a700;--ifm-color-warning-darker:#d99e00;--ifm-color-warning-darkest:#b38200;--ifm-color-warning-light:#ffc426;--ifm-color-warning-lighter:#ffcf4d;--ifm-color-warning-lightest:#ffdd80;--ifm-color-warning-contrast-background:#fff8e6;--ifm-color-warning-contrast-foreground:#4d3800;--ifm-color-danger-dark:#e13238;--ifm-color-danger-darker:#d53035;--ifm-color-danger-darkest:#af272b;--ifm-color-danger-light:#fb565b;--ifm-color-danger-lighter:#fb7478;--ifm-color-danger-lightest:#fd9c9f;--ifm-color-danger-contrast-background:#ffebec;--ifm-color-danger-contrast-foreground:#4b1113;--ifm-color-white:#fff;--ifm-color-black:#000;--ifm-color-gray-0:var(--ifm-color-white);--ifm-color-gray-100:#f5f6f7;--ifm-color-gray-200:#ebedf0;--ifm-color-gray-300:#dadde1;--ifm-color-gray-400:#ccd0d5;--ifm-color-gray-500:#bec3c9;--ifm-color-gray-600:#8d949e;--ifm-color-gray-700:#606770;--ifm-color-gray-800:#444950;--ifm-color-gray-900:#1c1e21;--ifm-color-gray-1000:var(--ifm-color-black);--ifm-color-emphasis-0:var(--ifm-color-gray-0);--ifm-color-emphasis-100:var(--ifm-color-gray-100);--ifm-color-emphasis-200:var(--ifm-color-gray-200);--ifm-color-emphasis-300:var(--ifm-color-gray-300);--ifm-color-emphasis-400:var(--ifm-color-gray-400);--ifm-color-emphasis-600:var(--ifm-color-gray-600);--ifm-color-emphasis-700:var(--ifm-color-gray-700);--ifm-color-emphasis-800:var(--ifm-color-gray-800);--ifm-color-emphasis-900:var(--ifm-color-gray-900);--ifm-color-emphasis-1000:var(--ifm-color-gray-1000);--ifm-color-content:var(--ifm-color-emphasis-900);--ifm-color-content-inverse:var(--ifm-color-emphasis-0);--ifm-color-content-secondary:#525860;--ifm-background-color:transparent;--ifm-background-surface-color:var(--ifm-color-content-inverse);--ifm-global-border-width:1px;--ifm-global-radius:0.4rem;--ifm-hover-overlay:rgba(0,0,0,.05);--ifm-font-color-base:var(--ifm-color-content);--ifm-font-color-base-inverse:var(--ifm-color-content-inverse);--ifm-font-color-secondary:var(--ifm-color-content-secondary);--ifm-font-family-base:system-ui,-apple-system,Segoe UI,Roboto,Ubuntu,Cantarell,Noto Sans,sans-serif,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol";--ifm-font-family-monospace:SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",monospace;--ifm-font-size-base:100%;--ifm-font-weight-light:300;--ifm-font-weight-normal:400;--ifm-font-weight-semibold:500;--ifm-font-weight-bold:700;--ifm-font-weight-base:var(--ifm-font-weight-normal);--ifm-line-height-base:1.65;--ifm-global-spacing:1rem;--ifm-spacing-vertical:var(--ifm-global-spacing);--ifm-spacing-horizontal:var(--ifm-global-spacing);--ifm-transition-fast:200ms;--ifm-transition-slow:400ms;--ifm-transition-timing-default:cubic-bezier(0.08,0.52,0.52,1);--ifm-global-shadow-lw:0 1px 2px 0 rgba(0,0,0,.1);--ifm-global-shadow-md:0 5px 40px rgba(0,0,0,.2);--ifm-global-shadow-tl:0 12px 28px 0 rgba(0,0,0,.2),0 2px 4px 0 rgba(0,0,0,.1);--ifm-z-index-dropdown:100;--ifm-z-index-fixed:200;--ifm-z-index-overlay:400;--ifm-container-width:1140px;--ifm-container-width-xl:1320px;--ifm-code-background:#f6f7f8;--ifm-code-border-radius:var(--ifm-global-radius);--ifm-code-font-size:90%;--ifm-code-padding-horizontal:0.1rem;--ifm-code-padding-vertical:0.1rem;--ifm-pre-background:var(--ifm-code-background);--ifm-pre-border-radius:var(--ifm-code-border-radius);--ifm-pre-color:inherit;--ifm-pre-line-height:1.45;--ifm-pre-padding:1rem;--ifm-heading-color:inherit;--ifm-heading-margin-top:0;--ifm-heading-margin-bottom:var(--ifm-spacing-vertical);--ifm-heading-font-family:var(--ifm-font-family-base);--ifm-heading-font-weight:var(--ifm-font-weight-bold);--ifm-heading-line-height:1.25;--ifm-h1-font-size:2rem;--ifm-h2-font-size:1.5rem;--ifm-h3-font-size:1.25rem;--ifm-h4-font-size:1rem;--ifm-h5-font-size:0.875rem;--ifm-h6-font-size:0.85rem;--ifm-image-alignment-padding:1.25rem;--ifm-leading-desktop:1.25;--ifm-leading:calc(var(--ifm-leading-desktop)*1rem);--ifm-list-left-padding:2rem;--ifm-list-margin:1rem;--ifm-list-item-margin:0.25rem;--ifm-list-paragraph-margin:1rem;--ifm-table-cell-padding:0.75rem;--ifm-table-background:transparent;--ifm-table-stripe-background:rgba(0,0,0,.03);--ifm-table-border-width:1px;--ifm-table-border-color:var(--ifm-color-emphasis-300);--ifm-table-head-background:inherit;--ifm-table-head-color:inherit;--ifm-table-head-font-weight:var(--ifm-font-weight-bold);--ifm-table-cell-color:inherit;--ifm-link-color:var(--ifm-color-primary);--ifm-link-decoration:none;--ifm-link-hover-color:var(--ifm-link-color);--ifm-link-hover-decoration:underline;--ifm-paragraph-margin-bottom:var(--ifm-leading);--ifm-blockquote-font-size:var(--ifm-font-size-base);--ifm-blockquote-border-left-width:2px;--ifm-blockquote-padding-horizontal:var(--ifm-spacing-horizontal);--ifm-blockquote-padding-vertical:0;--ifm-blockquote-shadow:none;--ifm-blockquote-color:var(--ifm-color-emphasis-800);--ifm-blockquote-border-color:var(--ifm-color-emphasis-300);--ifm-hr-background-color:var(--ifm-color-emphasis-500);--ifm-hr-height:1px;--ifm-hr-margin-vertical:1.5rem;--ifm-scrollbar-size:7px;--ifm-scrollbar-track-background-color:#f1f1f1;--ifm-scrollbar-thumb-background-color:silver;--ifm-scrollbar-thumb-hover-background-color:#a7a7a7;--ifm-alert-background-color:inherit;--ifm-alert-border-color:inherit;--ifm-alert-border-radius:var(--ifm-global-radius);--ifm-alert-border-width:0px;--ifm-alert-border-left-width:5px;--ifm-alert-color:var(--ifm-font-color-base);--ifm-alert-padding-horizontal:var(--ifm-spacing-horizontal);--ifm-alert-padding-vertical:var(--ifm-spacing-vertical);--ifm-alert-shadow:var(--ifm-global-shadow-lw);--ifm-avatar-intro-margin:1rem;--ifm-avatar-intro-alignment:inherit;--ifm-avatar-photo-size:3rem;--ifm-badge-background-color:inherit;--ifm-badge-border-color:inherit;--ifm-badge-border-radius:var(--ifm-global-radius);--ifm-badge-border-width:var(--ifm-global-border-width);--ifm-badge-color:var(--ifm-color-white);--ifm-badge-padding-horizontal:calc(var(--ifm-spacing-horizontal)*0.5);--ifm-badge-padding-vertical:calc(var(--ifm-spacing-vertical)*0.25);--ifm-breadcrumb-border-radius:1.5rem;--ifm-breadcrumb-spacing:0.5rem;--ifm-breadcrumb-color-active:var(--ifm-color-primary);--ifm-breadcrumb-item-background-active:var(--ifm-hover-overlay);--ifm-breadcrumb-padding-horizontal:0.8rem;--ifm-breadcrumb-padding-vertical:0.4rem;--ifm-breadcrumb-size-multiplier:1;--ifm-breadcrumb-separator:url('data:image/svg+xml;utf8,');--ifm-breadcrumb-separator-filter:none;--ifm-breadcrumb-separator-size:0.5rem;--ifm-breadcrumb-separator-size-multiplier:1.25;--ifm-button-background-color:inherit;--ifm-button-border-color:var(--ifm-button-background-color);--ifm-button-border-width:var(--ifm-global-border-width);--ifm-button-font-weight:var(--ifm-font-weight-bold);--ifm-button-padding-horizontal:1.5rem;--ifm-button-padding-vertical:0.375rem;--ifm-button-size-multiplier:1;--ifm-button-transition-duration:var(--ifm-transition-fast);--ifm-button-border-radius:calc(var(--ifm-global-radius)*var(--ifm-button-size-multiplier));--ifm-button-group-spacing:2px;--ifm-card-background-color:var(--ifm-background-surface-color);--ifm-card-border-radius:calc(var(--ifm-global-radius)*2);--ifm-card-horizontal-spacing:var(--ifm-global-spacing);--ifm-card-vertical-spacing:var(--ifm-global-spacing);--ifm-toc-border-color:var(--ifm-color-emphasis-300);--ifm-toc-link-color:var(--ifm-color-content-secondary);--ifm-toc-padding-vertical:0.5rem;--ifm-toc-padding-horizontal:0.5rem;--ifm-dropdown-background-color:var(--ifm-background-surface-color);--ifm-dropdown-font-weight:var(--ifm-font-weight-semibold);--ifm-dropdown-link-color:var(--ifm-font-color-base);--ifm-dropdown-hover-background-color:var(--ifm-hover-overlay);--ifm-footer-background-color:var(--ifm-color-emphasis-100);--ifm-footer-color:inherit;--ifm-footer-link-color:var(--ifm-color-emphasis-700);--ifm-footer-link-hover-color:var(--ifm-color-primary);--ifm-footer-link-horizontal-spacing:0.5rem;--ifm-footer-padding-horizontal:calc(var(--ifm-spacing-horizontal)*2);--ifm-footer-padding-vertical:calc(var(--ifm-spacing-vertical)*2);--ifm-footer-title-color:inherit;--ifm-footer-logo-max-width:min(30rem,90vw);--ifm-hero-background-color:var(--ifm-background-surface-color);--ifm-hero-text-color:var(--ifm-color-emphasis-800);--ifm-menu-color:var(--ifm-color-emphasis-700);--ifm-menu-color-active:var(--ifm-color-primary);--ifm-menu-color-background-active:var(--ifm-hover-overlay);--ifm-menu-color-background-hover:var(--ifm-hover-overlay);--ifm-menu-link-padding-horizontal:0.75rem;--ifm-menu-link-padding-vertical:0.375rem;--ifm-menu-link-sublist-icon:url('data:image/svg+xml;utf8,');--ifm-menu-link-sublist-icon-filter:none;--ifm-navbar-background-color:var(--ifm-background-surface-color);--ifm-navbar-height:3.75rem;--ifm-navbar-item-padding-horizontal:0.75rem;--ifm-navbar-item-padding-vertical:0.25rem;--ifm-navbar-link-color:var(--ifm-font-color-base);--ifm-navbar-link-active-color:var(--ifm-link-color);--ifm-navbar-padding-horizontal:var(--ifm-spacing-horizontal);--ifm-navbar-padding-vertical:calc(var(--ifm-spacing-vertical)*0.5);--ifm-navbar-shadow:var(--ifm-global-shadow-lw);--ifm-navbar-search-input-background-color:var(--ifm-color-emphasis-200);--ifm-navbar-search-input-color:var(--ifm-color-emphasis-800);--ifm-navbar-search-input-placeholder-color:var(--ifm-color-emphasis-500);--ifm-navbar-search-input-icon:url('data:image/svg+xml;utf8,');--ifm-navbar-sidebar-width:83vw;--ifm-pagination-border-radius:var(--ifm-global-radius);--ifm-pagination-color-active:var(--ifm-color-primary);--ifm-pagination-font-size:1rem;--ifm-pagination-item-active-background:var(--ifm-hover-overlay);--ifm-pagination-page-spacing:0.2em;--ifm-pagination-padding-horizontal:calc(var(--ifm-spacing-horizontal)*1);--ifm-pagination-padding-vertical:calc(var(--ifm-spacing-vertical)*0.25);--ifm-pagination-nav-border-radius:var(--ifm-global-radius);--ifm-pagination-nav-color-hover:var(--ifm-color-primary);--ifm-pills-color-active:var(--ifm-color-primary);--ifm-pills-color-background-active:var(--ifm-hover-overlay);--ifm-pills-spacing:0.125rem;--ifm-tabs-color:var(--ifm-font-color-secondary);--ifm-tabs-color-active:var(--ifm-color-primary);--ifm-tabs-color-active-border:var(--ifm-tabs-color-active);--ifm-tabs-padding-horizontal:1rem;--ifm-tabs-padding-vertical:1rem;--docusaurus-progress-bar-color:var(--ifm-color-primary);--ifm-color-primary:#e6007a;--ifm-color-primary-dark:#cf006e;--ifm-color-primary-darker:#c40068;--ifm-color-primary-darkest:#a10055;--ifm-color-primary-light:#fd0086;--ifm-color-primary-lighter:#ff0a8c;--ifm-color-primary-lightest:#ff2c9c;--secondaryColor:#172026;--snowColor:#efefef;--silverColor:#b7b8bb;--nickelColor:#6d7278;--blackColor:#000;--ifm-navbar-height:50px;--sansFontFamily:"Inter",sans-serif!important;--headingFontFamily:"Unbounded",sans-serif!important;--docsearch-searchbox-background:#fff;--docsearch-searchbox-shadow:var(--snowColor);--docusaurus-announcement-bar-height:auto!important;--custom-code-block-background:#f6f8fa;--docusaurus-highlighted-code-line-bg:#e6ebf1;--custom-content-max-width:none;--docusaurus-announcement-bar-height:auto;--docusaurus-tag-list-border:var(--ifm-color-emphasis-300);--docusaurus-collapse-button-bg:transparent;--docusaurus-collapse-button-bg-hover:rgba(0,0,0,.1);--doc-sidebar-width:300px;--doc-sidebar-hidden-width:30px;--docsearch-primary-color:#5468ff;--docsearch-text-color:#1c1e21;--docsearch-spacing:12px;--docsearch-icon-stroke-width:1.4;--docsearch-highlight-color:var(--docsearch-primary-color);--docsearch-muted-color:#969faf;--docsearch-container-background:rgba(101,108,133,.8);--docsearch-logo-color:#5468ff;--docsearch-modal-width:560px;--docsearch-modal-height:600px;--docsearch-modal-background:#f5f6f7;--docsearch-modal-shadow:inset 1px 1px 0 0 hsla(0,0%,100%,.5),0 3px 8px 0 #555a64;--docsearch-searchbox-height:56px;--docsearch-searchbox-background:#ebedf0;--docsearch-searchbox-focus-background:#fff;--docsearch-searchbox-shadow:inset 0 0 0 2px var(--docsearch-primary-color);--docsearch-hit-height:56px;--docsearch-hit-color:#444950;--docsearch-hit-active-color:#fff;--docsearch-hit-background:#fff;--docsearch-hit-shadow:0 1px 3px 0 #d4d9e1;--docsearch-key-gradient:linear-gradient(-225deg,#d5dbe4,#f8f8f8);--docsearch-key-shadow:inset 0 -2px 0 0 #cdcde6,inset 0 0 1px 1px #fff,0 1px 2px 1px rgba(30,35,90,.4);--docsearch-footer-height:44px;--docsearch-footer-background:#fff;--docsearch-footer-shadow:0 -1px 0 0 #e0e3e8,0 -3px 6px 0 rgba(69,98,155,.12);--docsearch-primary-color:var(--ifm-color-primary);--docsearch-text-color:var(--ifm-font-color-base)}.badge--danger,.badge--info,.badge--primary,.badge--secondary,.badge--success,.badge--warning{--ifm-badge-border-color:var(--ifm-badge-background-color)}.button--link,.button--outline{--ifm-button-background-color:transparent}html{-webkit-font-smoothing:antialiased;-webkit-text-size-adjust:100%;-moz-text-size-adjust:100%;text-size-adjust:100%;background-color:var(--ifm-background-color);color:var(--ifm-font-color-base);color-scheme:var(--ifm-color-scheme);font:var(--ifm-font-size-base)/var(--ifm-line-height-base) var(--ifm-font-family-base);text-rendering:optimizelegibility}iframe{border:0;color-scheme:auto}.container{margin:0 auto;max-width:var(--ifm-container-width)}.container--fluid{max-width:inherit}.row{display:flex;flex-wrap:wrap;margin:0 calc(var(--ifm-spacing-horizontal)*-1)}.list_eTzJ article:last-child,.margin-bottom--none,.margin-vert--none,.markdown>:last-child{margin-bottom:0!important}.margin-top--none,.margin-vert--none,.tabItem_LNqP,footer .list-social-links li{margin-top:0!important}.row--no-gutters{margin-left:0;margin-right:0}.margin-horiz--none,.margin-right--none{margin-right:0!important}.row--no-gutters>.col{padding-left:0;padding-right:0}.row--align-top{align-items:flex-start}.row--align-bottom{align-items:flex-end}.menuExternalLink_NmtK,.row--align-center{align-items:center}.row--align-stretch{align-items:stretch}.row--align-baseline{align-items:baseline}.col{--ifm-col-width:100%;flex:1 0;margin-left:0;max-width:var(--ifm-col-width)}.padding-bottom--none,.padding-vert--none{padding-bottom:0!important}.padding-top--none,.padding-vert--none{padding-top:0!important}.padding-horiz--none,.padding-left--none{padding-left:0!important}.padding-horiz--none,.padding-right--none{padding-right:0!important}.col[class*=col--]{flex:0 0 var(--ifm-col-width)}.col--1{--ifm-col-width:8.33333%}.col--offset-1{margin-left:8.33333%}.col--2{--ifm-col-width:16.66667%}.col--offset-2{margin-left:16.66667%}.col--3{--ifm-col-width:25%}.col--offset-3{margin-left:25%}.col--4{--ifm-col-width:33.33333%}.col--offset-4{margin-left:33.33333%}.col--5{--ifm-col-width:41.66667%}.col--offset-5{margin-left:41.66667%}.col--6{--ifm-col-width:50%}.col--offset-6{margin-left:50%}.col--7{--ifm-col-width:58.33333%}.col--offset-7{margin-left:58.33333%}.col--8{--ifm-col-width:66.66667%}.col--offset-8{margin-left:66.66667%}.col--9{--ifm-col-width:75%}.col--offset-9{margin-left:75%}.col--10{--ifm-col-width:83.33333%}.col--offset-10{margin-left:83.33333%}.col--11{--ifm-col-width:91.66667%}.col--offset-11{margin-left:91.66667%}.col--12{--ifm-col-width:100%}.col--offset-12{margin-left:100%}.margin-horiz--none,.margin-left--none{margin-left:0!important}.margin--none{margin:0!important}.margin-bottom--xs,.margin-vert--xs{margin-bottom:.25rem!important}.margin-top--xs,.margin-vert--xs{margin-top:.25rem!important}.margin-horiz--xs,.margin-left--xs{margin-left:.25rem!important}.margin-horiz--xs,.margin-right--xs{margin-right:.25rem!important}.margin--xs{margin:.25rem!important}.margin-bottom--sm,.margin-vert--sm{margin-bottom:.5rem!important}.margin-top--sm,.margin-vert--sm{margin-top:.5rem!important}.margin-horiz--sm,.margin-left--sm{margin-left:.5rem!important}.margin-horiz--sm,.margin-right--sm{margin-right:.5rem!important}.margin--sm{margin:.5rem!important}.margin-bottom--md,.margin-vert--md{margin-bottom:1rem!important}.margin-top--md,.margin-vert--md{margin-top:1rem!important}.margin-horiz--md,.margin-left--md{margin-left:1rem!important}.margin-horiz--md,.margin-right--md{margin-right:1rem!important}.margin--md{margin:1rem!important}.margin-bottom--lg,.margin-vert--lg{margin-bottom:2rem!important}.margin-top--lg,.margin-vert--lg{margin-top:2rem!important}.margin-horiz--lg,.margin-left--lg{margin-left:2rem!important}.margin-horiz--lg,.margin-right--lg{margin-right:2rem!important}.margin--lg{margin:2rem!important}.margin-bottom--xl,.margin-vert--xl{margin-bottom:5rem!important}.margin-top--xl,.margin-vert--xl{margin-top:5rem!important}.margin-horiz--xl,.margin-left--xl{margin-left:5rem!important}.margin-horiz--xl,.margin-right--xl{margin-right:5rem!important}.margin--xl{margin:5rem!important}.padding--none{padding:0!important}.padding-bottom--xs,.padding-vert--xs{padding-bottom:.25rem!important}.padding-top--xs,.padding-vert--xs{padding-top:.25rem!important}.padding-horiz--xs,.padding-left--xs{padding-left:.25rem!important}.padding-horiz--xs,.padding-right--xs{padding-right:.25rem!important}.padding--xs{padding:.25rem!important}.padding-bottom--sm,.padding-vert--sm{padding-bottom:.5rem!important}.padding-top--sm,.padding-vert--sm{padding-top:.5rem!important}.padding-horiz--sm,.padding-left--sm{padding-left:.5rem!important}.padding-horiz--sm,.padding-right--sm{padding-right:.5rem!important}.padding--sm{padding:.5rem!important}.padding-bottom--md,.padding-vert--md{padding-bottom:1rem!important}.padding-top--md,.padding-vert--md{padding-top:1rem!important}.padding-horiz--md,.padding-left--md{padding-left:1rem!important}.padding-horiz--md,.padding-right--md{padding-right:1rem!important}.padding--md{padding:1rem!important}.padding-bottom--lg,.padding-vert--lg{padding-bottom:2rem!important}.padding-top--lg,.padding-vert--lg{padding-top:2rem!important}.padding-horiz--lg,.padding-left--lg{padding-left:2rem!important}.padding-horiz--lg,.padding-right--lg{padding-right:2rem!important}.padding--lg{padding:2rem!important}.padding-bottom--xl,.padding-vert--xl{padding-bottom:5rem!important}.padding-top--xl,.padding-vert--xl{padding-top:5rem!important}.padding-horiz--xl,.padding-left--xl{padding-left:5rem!important}.padding-horiz--xl,.padding-right--xl{padding-right:5rem!important}.padding--xl{padding:5rem!important}code{background-color:var(--ifm-code-background);border:.1rem solid rgba(0,0,0,.1);border-radius:var(--ifm-code-border-radius);font-family:var(--ifm-font-family-monospace);font-size:var(--ifm-code-font-size);padding:var(--ifm-code-padding-vertical) var(--ifm-code-padding-horizontal)}a code{color:inherit}pre{background-color:var(--ifm-pre-background);border-radius:var(--ifm-pre-border-radius);color:var(--ifm-pre-color);font:var(--ifm-code-font-size)/var(--ifm-pre-line-height) var(--ifm-font-family-monospace);padding:var(--ifm-pre-padding)}pre code{background-color:transparent;border:none;font-size:100%;line-height:inherit;padding:0}kbd{background-color:var(--ifm-color-emphasis-0);border:1px solid var(--ifm-color-emphasis-400);border-radius:.2rem;box-shadow:inset 0 -1px 0 var(--ifm-color-emphasis-400);color:var(--ifm-color-emphasis-800);font:80% var(--ifm-font-family-monospace);padding:.15rem .3rem}h1,h2,h3,h4,h5,h6{color:var(--ifm-heading-color);font-family:var(--ifm-heading-font-family);font-weight:var(--ifm-heading-font-weight);line-height:var(--ifm-heading-line-height);margin:var(--ifm-heading-margin-top) 0 var(--ifm-heading-margin-bottom) 0}h1{font-size:var(--ifm-h1-font-size)}h2{font-size:var(--ifm-h2-font-size)}h3{font-size:var(--ifm-h3-font-size)}h4{font-size:var(--ifm-h4-font-size)}h5{font-size:var(--ifm-h5-font-size)}h6{font-size:var(--ifm-h6-font-size)}.container_lyt7,.container_lyt7>svg,img{max-width:100%}img[align=right]{padding-left:var(--image-alignment-padding)}img[align=left]{padding-right:var(--image-alignment-padding)}.markdown{--ifm-h1-vertical-rhythm-top:3;--ifm-h2-vertical-rhythm-top:2;--ifm-h3-vertical-rhythm-top:1.5;--ifm-heading-vertical-rhythm-top:1.25;--ifm-h1-vertical-rhythm-bottom:1.25;--ifm-heading-vertical-rhythm-bottom:1}.markdown:after,.markdown:before{content:"";display:table}.markdown:after{clear:both}.markdown h1:first-child{--ifm-h1-font-size:3rem;margin-bottom:calc(var(--ifm-h1-vertical-rhythm-bottom)*var(--ifm-leading))}.markdown>h2{--ifm-h2-font-size:2rem;margin-top:calc(var(--ifm-h2-vertical-rhythm-top)*var(--ifm-leading))}.markdown>h3{--ifm-h3-font-size:1.5rem;margin-top:calc(var(--ifm-h3-vertical-rhythm-top)*var(--ifm-leading))}.markdown>h4,.markdown>h5,.markdown>h6{margin-top:calc(var(--ifm-heading-vertical-rhythm-top)*var(--ifm-leading))}.markdown>p,.markdown>pre,.markdown>ul,.tabList__CuJ{margin-bottom:var(--ifm-leading)}.markdown li>p{margin-top:var(--ifm-list-paragraph-margin)}.markdown li+li{margin-top:var(--ifm-list-item-margin)}ol,ul{margin:0 0 var(--ifm-list-margin);padding-left:var(--ifm-list-left-padding)}ol ol,ul ol{list-style-type:lower-roman}ol ol,ol ul,ul ol,ul ul{margin:0}ol ol ol,ol ul ol,ul ol ol,ul ul ol{list-style-type:lower-alpha}table{border-collapse:collapse;display:block;margin-bottom:var(--ifm-spacing-vertical)}table thead tr{border-bottom:2px solid var(--ifm-table-border-color)}table thead,table tr:nth-child(2n){background-color:var(--ifm-table-stripe-background)}table tr{background-color:var(--ifm-table-background);border-top:var(--ifm-table-border-width) solid var(--ifm-table-border-color)}table td,table th{border:var(--ifm-table-border-width) solid var(--ifm-table-border-color);padding:var(--ifm-table-cell-padding)}table th{background-color:var(--ifm-table-head-background);color:var(--ifm-table-head-color);font-weight:var(--ifm-table-head-font-weight)}table td{color:var(--ifm-table-cell-color)}strong{font-weight:var(--ifm-font-weight-bold)}a{color:var(--ifm-link-color);text-decoration:var(--ifm-link-decoration)}a:hover{color:var(--ifm-link-hover-color);text-decoration:var(--ifm-link-hover-decoration)}.button:hover,.text--no-decoration,.text--no-decoration:hover,a:not([href]){text-decoration:none}p{margin:0 0 var(--ifm-paragraph-margin-bottom)}blockquote{border-left:var(--ifm-blockquote-border-left-width) solid var(--ifm-blockquote-border-color);box-shadow:var(--ifm-blockquote-shadow);color:var(--ifm-blockquote-color);font-size:var(--ifm-blockquote-font-size);padding:var(--ifm-blockquote-padding-vertical) var(--ifm-blockquote-padding-horizontal)}blockquote>:first-child{margin-top:0}blockquote>:last-child{margin-bottom:0}hr{background-color:var(--ifm-hr-background-color);border:0;height:var(--ifm-hr-height);margin:var(--ifm-hr-margin-vertical) 0}.shadow--lw{box-shadow:var(--ifm-global-shadow-lw)!important}.shadow--md{box-shadow:var(--ifm-global-shadow-md)!important}.shadow--tl{box-shadow:var(--ifm-global-shadow-tl)!important}.text--primary{color:var(--ifm-color-primary)}.text--secondary{color:var(--ifm-color-secondary)}.text--success{color:var(--ifm-color-success)}.text--info{color:var(--ifm-color-info)}.text--warning{color:var(--ifm-color-warning)}.text--danger{color:var(--ifm-color-danger)}.text--center{text-align:center}.text--left{text-align:left}.text--justify{text-align:justify}.text--right{text-align:right}.text--capitalize{text-transform:capitalize}.text--lowercase{text-transform:lowercase}.alert__heading,.text--uppercase{text-transform:uppercase}.text--light{font-weight:var(--ifm-font-weight-light)}.text--normal{font-weight:var(--ifm-font-weight-normal)}.text--semibold{font-weight:var(--ifm-font-weight-semibold)}.text--bold{font-weight:var(--ifm-font-weight-bold)}.text--italic{font-style:italic}.text--truncate{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.text--break{word-wrap:break-word!important;word-break:break-word!important}.clean-btn{background:none;border:none;color:inherit;cursor:pointer;font-family:inherit;padding:0}.alert,.alert .close{color:var(--ifm-alert-foreground-color)}.clean-list{list-style:none;padding-left:0}.alert--primary{--ifm-alert-background-color:var(--ifm-color-primary-contrast-background);--ifm-alert-background-color-highlight:rgba(53,120,229,.15);--ifm-alert-foreground-color:var(--ifm-color-primary-contrast-foreground);--ifm-alert-border-color:var(--ifm-color-primary-dark)}.alert--secondary{--ifm-alert-background-color:var(--ifm-color-secondary-contrast-background);--ifm-alert-background-color-highlight:rgba(235,237,240,.15);--ifm-alert-foreground-color:var(--ifm-color-secondary-contrast-foreground);--ifm-alert-border-color:var(--ifm-color-secondary-dark)}.alert--success{--ifm-alert-background-color:var(--ifm-color-success-contrast-background);--ifm-alert-background-color-highlight:rgba(0,164,0,.15);--ifm-alert-foreground-color:var(--ifm-color-success-contrast-foreground);--ifm-alert-border-color:var(--ifm-color-success-dark)}.alert--info{--ifm-alert-background-color:var(--ifm-color-info-contrast-background);--ifm-alert-background-color-highlight:rgba(84,199,236,.15);--ifm-alert-foreground-color:var(--ifm-color-info-contrast-foreground);--ifm-alert-border-color:var(--ifm-color-info-dark)}.alert--warning{--ifm-alert-background-color:var(--ifm-color-warning-contrast-background);--ifm-alert-background-color-highlight:rgba(255,186,0,.15);--ifm-alert-foreground-color:var(--ifm-color-warning-contrast-foreground);--ifm-alert-border-color:var(--ifm-color-warning-dark)}.alert--danger{--ifm-alert-background-color:var(--ifm-color-danger-contrast-background);--ifm-alert-background-color-highlight:rgba(250,56,62,.15);--ifm-alert-foreground-color:var(--ifm-color-danger-contrast-foreground);--ifm-alert-border-color:var(--ifm-color-danger-dark)}.alert{--ifm-code-background:var(--ifm-alert-background-color-highlight);--ifm-link-color:var(--ifm-alert-foreground-color);--ifm-link-hover-color:var(--ifm-alert-foreground-color);--ifm-link-decoration:underline;--ifm-tabs-color:var(--ifm-alert-foreground-color);--ifm-tabs-color-active:var(--ifm-alert-foreground-color);--ifm-tabs-color-active-border:var(--ifm-alert-border-color);background-color:var(--ifm-alert-background-color);border:var(--ifm-alert-border-width) solid var(--ifm-alert-border-color);border-left-width:var(--ifm-alert-border-left-width);border-radius:var(--ifm-alert-border-radius);box-shadow:var(--ifm-alert-shadow);padding:var(--ifm-alert-padding-vertical) var(--ifm-alert-padding-horizontal)}.alert__heading{align-items:center;display:flex;font:700 var(--ifm-h5-font-size)/var(--ifm-heading-line-height) var(--ifm-heading-font-family);margin-bottom:.5rem}.alert__icon{display:inline-flex;margin-right:.4em}.alert__icon svg{fill:var(--ifm-alert-foreground-color);stroke:var(--ifm-alert-foreground-color);stroke-width:0}.alert .close{margin:calc(var(--ifm-alert-padding-vertical)*-1) calc(var(--ifm-alert-padding-horizontal)*-1) 0 0;opacity:.75}.alert .close:focus,.alert .close:hover,.hash-link:focus,:hover>.hash-link{opacity:1}.alert a{text-decoration-color:var(--ifm-alert-border-color)}.alert a:hover{text-decoration-thickness:2px}.avatar{-moz-column-gap:var(--ifm-avatar-intro-margin);column-gap:var(--ifm-avatar-intro-margin);display:flex}.avatar__photo{border-radius:50%;display:block;height:var(--ifm-avatar-photo-size);overflow:hidden;width:var(--ifm-avatar-photo-size)}.card--full-height,.navbar__logo img,body,html{height:100%}.avatar__photo--sm{--ifm-avatar-photo-size:2rem}.avatar__photo--lg{--ifm-avatar-photo-size:4rem}.avatar__photo--xl{--ifm-avatar-photo-size:6rem}.avatar__intro{display:flex;flex:1 1;flex-direction:column;justify-content:center;text-align:var(--ifm-avatar-intro-alignment)}.badge,.breadcrumbs__item,.breadcrumbs__link,.button,.dropdown>.navbar__link:after{display:inline-block}.avatar__name{font:700 var(--ifm-h4-font-size)/var(--ifm-heading-line-height) var(--ifm-font-family-base)}.avatar__subtitle{margin-top:.25rem}.avatar--vertical{--ifm-avatar-intro-alignment:center;--ifm-avatar-intro-margin:0.5rem;align-items:center;flex-direction:column}.badge{background-color:var(--ifm-badge-background-color);border:var(--ifm-badge-border-width) solid var(--ifm-badge-border-color);border-radius:var(--ifm-badge-border-radius);color:var(--ifm-badge-color);font-size:75%;font-weight:var(--ifm-font-weight-bold);line-height:1;padding:var(--ifm-badge-padding-vertical) var(--ifm-badge-padding-horizontal)}.badge--primary{--ifm-badge-background-color:var(--ifm-color-primary)}.badge--secondary{--ifm-badge-background-color:var(--ifm-color-secondary);color:var(--ifm-color-black)}.breadcrumbs__link,.button.button--secondary.button--outline:not(.button--active):not(:hover){color:var(--ifm-font-color-base)}.badge--success{--ifm-badge-background-color:var(--ifm-color-success)}.badge--info{--ifm-badge-background-color:var(--ifm-color-info)}.badge--warning{--ifm-badge-background-color:var(--ifm-color-warning)}.badge--danger{--ifm-badge-background-color:var(--ifm-color-danger)}.breadcrumbs{margin-bottom:0;padding-left:0}.breadcrumbs__item:not(:last-child):after{background:var(--ifm-breadcrumb-separator) center;content:" ";display:inline-block;filter:var(--ifm-breadcrumb-separator-filter);height:calc(var(--ifm-breadcrumb-separator-size)*var(--ifm-breadcrumb-size-multiplier)*var(--ifm-breadcrumb-separator-size-multiplier));margin:0 var(--ifm-breadcrumb-spacing);opacity:.5;width:calc(var(--ifm-breadcrumb-separator-size)*var(--ifm-breadcrumb-size-multiplier)*var(--ifm-breadcrumb-separator-size-multiplier))}.breadcrumbs__item--active .breadcrumbs__link{background:var(--ifm-breadcrumb-item-background-active);color:var(--ifm-breadcrumb-color-active)}.breadcrumbs__link{border-radius:var(--ifm-breadcrumb-border-radius);font-size:calc(1rem*var(--ifm-breadcrumb-size-multiplier));padding:calc(var(--ifm-breadcrumb-padding-vertical)*var(--ifm-breadcrumb-size-multiplier)) calc(var(--ifm-breadcrumb-padding-horizontal)*var(--ifm-breadcrumb-size-multiplier));transition-duration:var(--ifm-transition-fast);transition-property:background,color}.breadcrumbs__link:link:hover,.breadcrumbs__link:visited:hover,area[href].breadcrumbs__link:hover{background:var(--ifm-breadcrumb-item-background-active);text-decoration:none}.breadcrumbs__link:-moz-any-link:hover{background:var(--ifm-breadcrumb-item-background-active);text-decoration:none}.breadcrumbs__link:any-link:hover{background:var(--ifm-breadcrumb-item-background-active);text-decoration:none}.breadcrumbs--sm{--ifm-breadcrumb-size-multiplier:0.8}.breadcrumbs--lg{--ifm-breadcrumb-size-multiplier:1.2}.button{background-color:var(--ifm-button-background-color);border:var(--ifm-button-border-width) solid var(--ifm-button-border-color);border-radius:var(--ifm-button-border-radius);cursor:pointer;font-size:calc(.875rem*var(--ifm-button-size-multiplier));font-weight:var(--ifm-button-font-weight);line-height:1.5;padding:calc(var(--ifm-button-padding-vertical)*var(--ifm-button-size-multiplier)) calc(var(--ifm-button-padding-horizontal)*var(--ifm-button-size-multiplier));text-align:center;transition-duration:var(--ifm-button-transition-duration);transition-property:color,background,border-color;user-select:none;white-space:nowrap}.button,.button:hover{color:var(--ifm-button-color)}.button--outline{--ifm-button-color:var(--ifm-button-border-color)}.button--outline:hover{--ifm-button-background-color:var(--ifm-button-border-color)}.button--link{--ifm-button-border-color:transparent;color:var(--ifm-link-color);text-decoration:var(--ifm-link-decoration)}.button--link.button--active,.button--link:active,.button--link:hover{color:var(--ifm-link-hover-color);text-decoration:var(--ifm-link-hover-decoration)}.button.disabled,.button:disabled,.button[disabled]{opacity:.65;pointer-events:none}.button--sm{--ifm-button-size-multiplier:0.8}.button--lg{--ifm-button-size-multiplier:1.35}.button--block{display:block;width:100%}.button.button--secondary{color:var(--ifm-color-gray-900)}:where(.button--primary){--ifm-button-background-color:var(--ifm-color-primary);--ifm-button-border-color:var(--ifm-color-primary)}:where(.button--primary):not(.button--outline):hover{--ifm-button-background-color:var(--ifm-color-primary-dark);--ifm-button-border-color:var(--ifm-color-primary-dark)}.button--primary.button--active,.button--primary:active{--ifm-button-background-color:var(--ifm-color-primary-darker);--ifm-button-border-color:var(--ifm-color-primary-darker)}:where(.button--secondary){--ifm-button-background-color:var(--ifm-color-secondary);--ifm-button-border-color:var(--ifm-color-secondary)}:where(.button--secondary):not(.button--outline):hover{--ifm-button-background-color:var(--ifm-color-secondary-dark);--ifm-button-border-color:var(--ifm-color-secondary-dark)}.button--secondary.button--active,.button--secondary:active{--ifm-button-background-color:var(--ifm-color-secondary-darker);--ifm-button-border-color:var(--ifm-color-secondary-darker)}:where(.button--success){--ifm-button-background-color:var(--ifm-color-success);--ifm-button-border-color:var(--ifm-color-success)}:where(.button--success):not(.button--outline):hover{--ifm-button-background-color:var(--ifm-color-success-dark);--ifm-button-border-color:var(--ifm-color-success-dark)}.button--success.button--active,.button--success:active{--ifm-button-background-color:var(--ifm-color-success-darker);--ifm-button-border-color:var(--ifm-color-success-darker)}:where(.button--info){--ifm-button-background-color:var(--ifm-color-info);--ifm-button-border-color:var(--ifm-color-info)}:where(.button--info):not(.button--outline):hover{--ifm-button-background-color:var(--ifm-color-info-dark);--ifm-button-border-color:var(--ifm-color-info-dark)}.button--info.button--active,.button--info:active{--ifm-button-background-color:var(--ifm-color-info-darker);--ifm-button-border-color:var(--ifm-color-info-darker)}:where(.button--warning){--ifm-button-background-color:var(--ifm-color-warning);--ifm-button-border-color:var(--ifm-color-warning)}:where(.button--warning):not(.button--outline):hover{--ifm-button-background-color:var(--ifm-color-warning-dark);--ifm-button-border-color:var(--ifm-color-warning-dark)}.button--warning.button--active,.button--warning:active{--ifm-button-background-color:var(--ifm-color-warning-darker);--ifm-button-border-color:var(--ifm-color-warning-darker)}:where(.button--danger){--ifm-button-background-color:var(--ifm-color-danger);--ifm-button-border-color:var(--ifm-color-danger)}:where(.button--danger):not(.button--outline):hover{--ifm-button-background-color:var(--ifm-color-danger-dark);--ifm-button-border-color:var(--ifm-color-danger-dark)}.button--danger.button--active,.button--danger:active{--ifm-button-background-color:var(--ifm-color-danger-darker);--ifm-button-border-color:var(--ifm-color-danger-darker)}.button-group{display:inline-flex;gap:var(--ifm-button-group-spacing)}.button-group>.button:not(:first-child){border-bottom-left-radius:0;border-top-left-radius:0}.button-group>.button:not(:last-child){border-bottom-right-radius:0;border-top-right-radius:0}.button-group--block{display:flex;justify-content:stretch}.button-group--block>.button{flex-grow:1}.card{background-color:var(--ifm-card-background-color);border-radius:var(--ifm-card-border-radius);box-shadow:var(--ifm-global-shadow-lw);display:flex;flex-direction:column;overflow:hidden}.card__image{padding-top:var(--ifm-card-vertical-spacing)}.card__image:first-child{padding-top:0}.card__body,.card__footer,.card__header{padding:var(--ifm-card-vertical-spacing) var(--ifm-card-horizontal-spacing)}.card__body:not(:last-child),.card__footer:not(:last-child),.card__header:not(:last-child){padding-bottom:0}.card__body>:last-child,.card__footer>:last-child,.card__header>:last-child{margin-bottom:0}.card__footer{margin-top:auto}.table-of-contents{font-size:.8rem;margin-bottom:0;padding:var(--ifm-toc-padding-vertical) 0}.table-of-contents,.table-of-contents ul{list-style:none;padding-left:var(--ifm-toc-padding-horizontal)}.table-of-contents li{margin:var(--ifm-toc-padding-vertical) var(--ifm-toc-padding-horizontal)}.table-of-contents__left-border{border-left:1px solid var(--ifm-toc-border-color)}.table-of-contents__link{color:var(--ifm-toc-link-color);display:block}.table-of-contents__link--active,.table-of-contents__link--active code,.table-of-contents__link:hover,.table-of-contents__link:hover code{color:var(--ifm-color-primary);text-decoration:none}.close{color:var(--ifm-color-black);float:right;font-size:1.5rem;font-weight:var(--ifm-font-weight-bold);line-height:1;opacity:.5;padding:1rem;transition:opacity var(--ifm-transition-fast) var(--ifm-transition-timing-default)}.close:hover{opacity:.7}.close:focus,.theme-code-block-highlighted-line .codeLineNumber_Tfdd:before{opacity:.8}.dropdown{display:inline-flex;font-weight:var(--ifm-dropdown-font-weight);vertical-align:top}.dropdown--hoverable:hover .dropdown__menu,.dropdown--show .dropdown__menu{opacity:1;pointer-events:all;transform:translateY(-1px);visibility:visible}#nprogress,.dropdown__menu,.navbar__item.dropdown .navbar__link:not([href]){pointer-events:none}.dropdown--right .dropdown__menu{left:inherit;right:0}.dropdown--nocaret .navbar__link:after{content:none!important}.dropdown__menu{background-color:var(--ifm-dropdown-background-color);border-radius:var(--ifm-global-radius);box-shadow:var(--ifm-global-shadow-md);left:0;list-style:none;max-height:80vh;min-width:10rem;opacity:0;overflow-y:auto;padding:.5rem;position:absolute;top:calc(100% - var(--ifm-navbar-item-padding-vertical) + .3rem);transform:translateY(-.625rem);transition-duration:var(--ifm-transition-fast);transition-property:opacity,transform,visibility;transition-timing-function:var(--ifm-transition-timing-default);visibility:hidden;z-index:var(--ifm-z-index-dropdown)}.menu__caret,.menu__link,.menu__list-item-collapsible{border-radius:.25rem;transition:background var(--ifm-transition-fast) var(--ifm-transition-timing-default)}.dropdown__link{border-radius:.25rem;color:var(--ifm-dropdown-link-color);display:block;font-size:.875rem;margin-top:.2rem;padding:.25rem .5rem;white-space:nowrap}.dropdown__link--active,.dropdown__link:hover{background-color:var(--ifm-dropdown-hover-background-color);color:var(--ifm-dropdown-link-color);text-decoration:none}.dropdown__link--active,.dropdown__link--active:hover{--ifm-dropdown-link-color:var(--ifm-link-color)}.dropdown>.navbar__link:after{border-color:currentcolor transparent;border-style:solid;border-width:.4em .4em 0;content:"";margin-left:.3em;position:relative;top:2px;transform:translateY(-50%)}.footer{background-color:var(--ifm-footer-background-color);color:var(--ifm-footer-color);padding:var(--ifm-footer-padding-vertical) var(--ifm-footer-padding-horizontal)}.footer--dark{--ifm-footer-background-color:#303846;--ifm-footer-color:var(--ifm-footer-link-color);--ifm-footer-link-color:var(--ifm-color-secondary);--ifm-footer-title-color:var(--ifm-color-white)}.footer__links{margin-bottom:1rem}.footer__link-item{color:var(--ifm-footer-link-color);line-height:2}.footer__link-item:hover{color:var(--ifm-footer-link-hover-color)}.footer__link-separator{margin:0 var(--ifm-footer-link-horizontal-spacing)}.footer__logo{margin-top:1rem;max-width:var(--ifm-footer-logo-max-width)}.docs-wrapper,.navbar__inner{max-width:var(--custom-content-max-width)}.footer__title{color:var(--ifm-footer-title-color);font:700 var(--ifm-h4-font-size)/var(--ifm-heading-line-height) var(--ifm-font-family-base);margin-bottom:var(--ifm-heading-margin-bottom)}.menu,.navbar__link{font-weight:var(--ifm-font-weight-semibold)}.docItemContainer_Djhp article>:first-child,.docItemContainer_Djhp header+*,.footer-legal li+li,.footer__item,.h1,.h2,.h3,.h4,.h5,.h6{margin-top:0}.admonitionContent_S0QG>:last-child,.cardContainer_fWXF :last-child,.collapsibleContent_i85q>:last-child,.footer-legal ul,.footer__items,.tabItem_Ymn6>:last-child{margin-bottom:0}.codeBlockStandalone_MEMb,[type=checkbox]{padding:0}.hero{align-items:center;background-color:var(--ifm-hero-background-color);color:var(--ifm-hero-text-color);display:flex;padding:4rem 2rem}.hero--primary{--ifm-hero-background-color:var(--ifm-color-primary);--ifm-hero-text-color:var(--ifm-font-color-base-inverse)}.hero--dark{--ifm-hero-background-color:#303846;--ifm-hero-text-color:var(--ifm-color-white)}.hero__title,.homeNavItem h1{font-size:3rem}.hero__subtitle{font-size:1.5rem}.menu__list{list-style:none;margin:0;padding-left:0}.menu__caret,.menu__link{padding:var(--ifm-menu-link-padding-vertical) var(--ifm-menu-link-padding-horizontal)}.menu__list .menu__list{flex:0 0 100%;margin-top:.25rem;padding-left:var(--ifm-menu-link-padding-horizontal)}.menu__list-item:not(:first-child){margin-top:.25rem}.menu__list-item--collapsed .menu__list{height:0;overflow:hidden}.details_lb9f[data-collapsed=false].isBrowser_bmU9>summary:before,.details_lb9f[open]:not(.isBrowser_bmU9)>summary:before,.menu__list-item--collapsed .menu__caret:before,.menu__list-item--collapsed .menu__link--sublist:after{transform:rotate(90deg)}.menu__list-item-collapsible{display:flex;flex-wrap:wrap;position:relative}.menu__caret:hover,.menu__link:hover,.menu__list-item-collapsible--active,.menu__list-item-collapsible:hover{background:var(--ifm-menu-color-background-hover)}.menu__list-item-collapsible .menu__link--active,.menu__list-item-collapsible .menu__link:hover{background:none!important}.menu__caret,.menu__link{align-items:center;display:flex}.navbar-sidebar,.navbar-sidebar__backdrop{bottom:0;opacity:0;transition-duration:var(--ifm-transition-fast);transition-timing-function:ease-in-out;left:0;top:0;visibility:hidden}.menu__link{color:var(--ifm-menu-color);flex:1;line-height:1.25}.menu__link:hover{color:var(--ifm-menu-color);text-decoration:none}.menu__caret:before,.menu__link--sublist-caret:after{height:1.25rem;transform:rotate(180deg);transition:transform var(--ifm-transition-fast) linear;width:1.25rem;content:"";filter:var(--ifm-menu-link-sublist-icon-filter)}.menu__link--sublist-caret:after{background:var(--ifm-menu-link-sublist-icon) 50%/2rem 2rem;margin-left:auto;min-width:1.25rem}.navbar__items--center .navbar__brand,body{margin:0}.menu__link--active,.menu__link--active:hover{color:var(--ifm-menu-color-active)}.navbar__brand,.navbar__link{color:var(--ifm-navbar-link-color)}.menu__link--active:not(.menu__link--sublist){background-color:var(--ifm-menu-color-background-active)}.menu__caret:before{background:var(--ifm-menu-link-sublist-icon) 50%/2rem 2rem}.navbar--dark,html[data-theme=dark]{--ifm-menu-link-sublist-icon-filter:invert(100%) sepia(94%) saturate(17%) hue-rotate(223deg) brightness(104%) contrast(98%)}.navbar{background-color:var(--ifm-navbar-background-color);box-shadow:var(--ifm-navbar-shadow);height:var(--ifm-navbar-height);padding:var(--ifm-navbar-padding-vertical) var(--ifm-navbar-padding-horizontal)}.navbar,.navbar>.container,.navbar>.container-fluid{display:flex}.navbar--fixed-top{position:sticky;top:0;z-index:var(--ifm-z-index-fixed)}.navbar__inner{display:flex;flex-wrap:wrap;justify-content:space-between;width:100%}.navbar__brand{align-items:center;display:flex;margin-right:1rem;min-width:0}.navbar__brand:hover{color:var(--ifm-navbar-link-hover-color);text-decoration:none}.announcementBarContent_xLdY,.navbar__title{flex:1 1 auto}.navbar__toggle{display:none;margin-right:.5rem}.navbar__logo{flex:0 0 auto;height:2rem;margin-right:.5rem}.navbar__items{align-items:center;display:flex;flex:1;min-width:0}.navbar__items--center{flex:0 0 auto}.navbar__items--center+.navbar__items--right{flex:1}.navbar__items--right{flex:0 0 auto;justify-content:flex-end}.navbar__items--right>:last-child{padding-right:0}.navbar__item{display:inline-block;padding:var(--ifm-navbar-item-padding-vertical) var(--ifm-navbar-item-padding-horizontal)}.navbar__link--active,.navbar__link:hover{color:var(--ifm-navbar-link-hover-color);text-decoration:none}.navbar--dark,.navbar--primary{--ifm-menu-color:var(--ifm-color-gray-300);--ifm-navbar-link-color:var(--ifm-color-gray-100);--ifm-navbar-search-input-background-color:hsla(0,0%,100%,.1);--ifm-navbar-search-input-placeholder-color:hsla(0,0%,100%,.5);color:var(--ifm-color-white)}.navbar--dark{--ifm-navbar-background-color:#242526;--ifm-menu-color-background-active:hsla(0,0%,100%,.05);--ifm-navbar-search-input-color:var(--ifm-color-white)}.navbar--primary{--ifm-navbar-background-color:var(--ifm-color-primary);--ifm-navbar-link-hover-color:var(--ifm-color-white);--ifm-menu-color-active:var(--ifm-color-white);--ifm-navbar-search-input-color:var(--ifm-color-emphasis-500)}.navbar__search-input{-webkit-appearance:none;-moz-appearance:none;appearance:none;background:var(--ifm-navbar-search-input-background-color) var(--ifm-navbar-search-input-icon) no-repeat .75rem center/1rem 1rem;border:none;border-radius:2rem;color:var(--ifm-navbar-search-input-color);cursor:text;display:inline-block;font-size:.9rem;height:2rem;padding:0 .5rem 0 2.25rem;width:12.5rem}.navbar__search-input::-moz-placeholder{color:var(--ifm-navbar-search-input-placeholder-color)}.navbar__search-input::placeholder{color:var(--ifm-navbar-search-input-placeholder-color)}.navbar-sidebar{background-color:var(--ifm-navbar-background-color);box-shadow:var(--ifm-global-shadow-md);position:fixed;transform:translate3d(-100%,0,0);transition-property:opacity,visibility,transform;width:var(--ifm-navbar-sidebar-width)}.navbar-sidebar--show .navbar-sidebar,.navbar-sidebar__items{transform:translateZ(0)}.navbar-sidebar--show .navbar-sidebar,.navbar-sidebar--show .navbar-sidebar__backdrop{opacity:1;visibility:visible}.navbar-sidebar__backdrop{background-color:rgba(0,0,0,.6);position:fixed;right:0;transition-property:opacity,visibility}.btn-primary,.cards,.nav-footer{position:relative}.navbar-sidebar__brand{align-items:center;box-shadow:var(--ifm-navbar-shadow);display:flex;flex:1;height:var(--ifm-navbar-height);padding:var(--ifm-navbar-padding-vertical) var(--ifm-navbar-padding-horizontal)}.navbar-sidebar__items{display:flex;height:calc(100% - var(--ifm-navbar-height));transition:transform var(--ifm-transition-fast) ease-in-out}.navbar-sidebar__items--show-secondary{transform:translate3d(calc((var(--ifm-navbar-sidebar-width))*-1),0,0)}.navbar-sidebar__item{flex-shrink:0;padding:.5rem;width:calc(var(--ifm-navbar-sidebar-width))}.navbar-sidebar__back{background:var(--ifm-menu-color-background-active);font-size:15px;font-weight:var(--ifm-button-font-weight);margin:0 0 .2rem -.5rem;padding:.6rem 1.5rem;position:relative;text-align:left;top:-.5rem;width:calc(100% + 1rem)}.container.container-custom,.navbar__inner,article iframe,article img{margin-left:auto;margin-right:auto}.navbar-sidebar__close{display:flex;margin-left:auto}.pagination{-moz-column-gap:var(--ifm-pagination-page-spacing);column-gap:var(--ifm-pagination-page-spacing);display:flex;font-size:var(--ifm-pagination-font-size);padding-left:0}.pagination--sm{--ifm-pagination-font-size:0.8rem;--ifm-pagination-padding-horizontal:0.8rem;--ifm-pagination-padding-vertical:0.2rem}.pagination--lg{--ifm-pagination-font-size:1.2rem;--ifm-pagination-padding-horizontal:1.2rem;--ifm-pagination-padding-vertical:0.3rem}.pagination__item{display:inline-flex}.pagination__item>span{padding:var(--ifm-pagination-padding-vertical)}.pagination__item--active .pagination__link{color:var(--ifm-pagination-color-active)}.pagination__item--active .pagination__link,.pagination__item:not(.pagination__item--active):hover .pagination__link{background:var(--ifm-pagination-item-active-background)}.pagination__item--disabled,.pagination__item[disabled]{opacity:.25;pointer-events:none}.pagination__link{border-radius:var(--ifm-pagination-border-radius);color:var(--ifm-font-color-base);display:inline-block;padding:var(--ifm-pagination-padding-vertical) var(--ifm-pagination-padding-horizontal);transition:background var(--ifm-transition-fast) var(--ifm-transition-timing-default)}.homeContainer a,.nav-footer a:hover,.pagination__link:hover{text-decoration:none}.pagination-nav{grid-gap:var(--ifm-spacing-horizontal);display:grid;gap:var(--ifm-spacing-horizontal);grid-template-columns:repeat(2,1fr)}.pagination-nav__link{border:1px solid var(--ifm-color-emphasis-300);border-radius:var(--ifm-pagination-nav-border-radius);display:block;height:100%;line-height:var(--ifm-heading-line-height);padding:var(--ifm-global-spacing);transition:border-color var(--ifm-transition-fast) var(--ifm-transition-timing-default)}.text-heading,h1{line-height:1.333333}.pagination-nav__link:hover{border-color:var(--ifm-pagination-nav-color-hover);text-decoration:none}.pagination-nav__link--next{grid-column:2/3;text-align:right}.pagination-nav__label{font-size:var(--ifm-h4-font-size);font-weight:var(--ifm-heading-font-weight);word-break:break-word}.pagination-nav__link--prev .pagination-nav__label:before{content:"« "}.pagination-nav__link--next .pagination-nav__label:after{content:" »"}.pagination-nav__sublabel{color:var(--ifm-color-content-secondary);font-size:var(--ifm-h5-font-size);font-weight:var(--ifm-font-weight-semibold);margin-bottom:.25rem}.pills__item,.tabs{font-weight:var(--ifm-font-weight-bold)}.pills{display:flex;gap:var(--ifm-pills-spacing);padding-left:0}.pills__item{border-radius:.5rem;cursor:pointer;display:inline-block;padding:.25rem 1rem;transition:background var(--ifm-transition-fast) var(--ifm-transition-timing-default)}.tabs,:not(.containsTaskList_mC6p>li)>.containsTaskList_mC6p{padding-left:0}.pills__item--active{color:var(--ifm-pills-color-active)}.pills__item--active,.pills__item:not(.pills__item--active):hover{background:var(--ifm-pills-color-background-active)}.pills--block{justify-content:stretch}.pills--block .pills__item{flex-grow:1;text-align:center}.tabs{color:var(--ifm-tabs-color);display:flex;margin-bottom:0;overflow-x:auto}.tabs__item{border-bottom:3px solid transparent;border-radius:var(--ifm-global-radius);cursor:pointer;display:inline-flex;padding:var(--ifm-tabs-padding-vertical) var(--ifm-tabs-padding-horizontal);transition:background-color var(--ifm-transition-fast) var(--ifm-transition-timing-default)}#__docusaurus-base-url-issue-banner-container,.DocSearch.DocSearch-Button .DocSearch-Button-Keys,.docSidebarContainer_b6E3,.navbar__inner .navbar__item:last-child a:after,.navbar__inner a.navbar__item svg[class^=iconExternalLink],.sidebarLogo_isFc,.themedImage_ToTc,[data-theme=dark] .lightToggleIcon_pyhR,[data-theme=light] .darkToggleIcon_wfgR,html[data-announcement-bar-initially-dismissed=true] .announcementBar_mb4j{display:none}.tabs__item--active{border-bottom-color:var(--ifm-tabs-color-active-border);border-bottom-left-radius:0;border-bottom-right-radius:0;color:var(--ifm-tabs-color-active)}.tabs__item:hover{background-color:var(--ifm-hover-overlay)}.tabs--block{justify-content:stretch}.tabs--block .tabs__item{flex-grow:1;justify-content:center}html[data-theme=dark]{--ifm-color-scheme:dark;--ifm-color-emphasis-0:var(--ifm-color-gray-1000);--ifm-color-emphasis-100:var(--ifm-color-gray-900);--ifm-color-emphasis-200:var(--ifm-color-gray-800);--ifm-color-emphasis-300:var(--ifm-color-gray-700);--ifm-color-emphasis-400:var(--ifm-color-gray-600);--ifm-color-emphasis-600:var(--ifm-color-gray-400);--ifm-color-emphasis-700:var(--ifm-color-gray-300);--ifm-color-emphasis-800:var(--ifm-color-gray-200);--ifm-color-emphasis-900:var(--ifm-color-gray-100);--ifm-color-emphasis-1000:var(--ifm-color-gray-0);--ifm-background-color:#1b1b1d;--ifm-background-surface-color:#242526;--ifm-hover-overlay:hsla(0,0%,100%,.05);--ifm-color-content:#e3e3e3;--ifm-color-content-secondary:#fff;--ifm-breadcrumb-separator-filter:invert(64%) sepia(11%) saturate(0%) hue-rotate(149deg) brightness(99%) contrast(95%);--ifm-code-background:hsla(0,0%,100%,.1);--ifm-scrollbar-track-background-color:#444;--ifm-scrollbar-thumb-background-color:#686868;--ifm-scrollbar-thumb-hover-background-color:#7a7a7a;--ifm-table-stripe-background:hsla(0,0%,100%,.07);--ifm-toc-border-color:var(--ifm-color-emphasis-200);--ifm-color-primary-contrast-background:#102445;--ifm-color-primary-contrast-foreground:#ebf2fc;--ifm-color-secondary-contrast-background:#474748;--ifm-color-secondary-contrast-foreground:#fdfdfe;--ifm-color-success-contrast-background:#003100;--ifm-color-success-contrast-foreground:#e6f6e6;--ifm-color-info-contrast-background:#193c47;--ifm-color-info-contrast-foreground:#eef9fd;--ifm-color-warning-contrast-background:#4d3800;--ifm-color-warning-contrast-foreground:#fff8e6;--ifm-color-danger-contrast-background:#4b1113;--ifm-color-danger-contrast-foreground:#ffebec;--docsearch-text-color:#f5f6f7;--docsearch-container-background:rgba(9,10,17,.8);--docsearch-modal-background:#15172a;--docsearch-modal-shadow:inset 1px 1px 0 0 #2c2e40,0 3px 8px 0 #000309;--docsearch-searchbox-background:#090a11;--docsearch-searchbox-focus-background:#000;--docsearch-hit-color:#bec3c9;--docsearch-hit-shadow:none;--docsearch-hit-background:#090a11;--docsearch-key-gradient:linear-gradient(-26.5deg,#565872,#31355b);--docsearch-key-shadow:inset 0 -2px 0 0 #282d55,inset 0 0 1px 1px #51577d,0 2px 2px 0 rgba(3,4,9,.3);--docsearch-footer-background:#1e2136;--docsearch-footer-shadow:inset 0 1px 0 0 rgba(73,76,106,.5),0 -4px 8px 0 rgba(0,0,0,.2);--docsearch-logo-color:#fff;--docsearch-muted-color:#7f8497}#nprogress .bar{background:var(--docusaurus-progress-bar-color);height:2px;left:0;position:fixed;top:0;width:100%;z-index:1031}#nprogress .peg{box-shadow:0 0 10px var(--docusaurus-progress-bar-color),0 0 5px var(--docusaurus-progress-bar-color);height:100%;opacity:1;position:absolute;right:0;transform:rotate(3deg) translateY(-4px);width:100px}@font-face{font-family:Unbounded;font-weight:100 900;src:url(/assets/fonts/Unbounded-Variable-a247d72576aff02445f8abeb96056589.woff2) format("woff2-variations")}body{font-family:var(--sansFontFamily)}h1{font-family:Unbounded,sans-serif!important;padding-top:1.2rem}h2,h3,h4,h5,h6{font-family:var(--sansFontFamily)}.text-heading{font-family:var(--headingFontFamily)}.font-weight-medium{font-weight:500!important}.font-weight-bolder{font-weight:900!important}button.menu__button{box-shadow:0 2px 5px 0 rgba(0,0,0,.26)}.img_ev3q,.navbar.navbar--fixed-top{height:auto}.btn-bg-primary.btn-primary:before,.btn-primary:before{height:100%;transition:.2s;z-index:-1;top:0;position:absolute}.DocSearch.DocSearch-Button{background-color:#fff;border:1px solid var(--snowColor);color:var(--silverColor);cursor:text;width:170px}.btn-primary:before,.btn-primary[type=submit]:active,.btn-primary[type=submit]:focus,.btn-primary[type=submit]:hover{background:var(--ifm-color-primary)}.DocSearch.DocSearch-Button .DocSearch-Search-Icon{color:var(--silverColor)}.DocSearch.DocSearch-Button:hover .DocSearch-Search-Icon{color:var(--secondaryColor)}.DocSearch.DocSearch-Button .DocSearch-Button-Placeholder{font-size:13px;font-weight:500}.navbar__inner .navbar__item:last-child{margin-left:5px;margin-right:5px;opacity:1}.navbar__inner .navbar__item:last-child .dropdown__menu{border-radius:1.5rem;box-shadow:0 1rem 3rem rgba(0,0,0,.175);right:0;text-align:center;top:32px}.navbar__inner .navbar__item:last-child .dropdown__menu>li a{color:var(--secondaryColor);padding:12px 24px}.navbar__inner .navbar__item:last-child .dropdown__menu>li a.dropdown__link--active{background-color:#fff;color:var(--blackColor)}.navbar__inner .navbar__item:last-child .dropdown__menu>li a.dropdown__link--active:hover,.wordWrapButtonEnabled_EoeP .wordWrapButtonIcon_Bwma{color:var(--ifm-color-primary)}.navbar__inner .navbar__item:last-child .dropdown__menu>li a:hover{background-color:var(--snowColor);color:var(--ifm-color-primary)}.homeContainer{background:#fff;text-align:center}.homeFooterContainer,div[role=banner]{background-image:linear-gradient(217deg,rgba(196,0,97,.8),rgba(196,0,97,0) 70%),linear-gradient(127deg,rgba(230,0,122,.8),rgba(230,0,122,0) 70%),linear-gradient(336deg,rgba(103,69,210,.7),rgba(103,69,210,0) 70%)}.text-dark{color:var(--secondaryColor)!important}.homeNavContainer,.homeNavItem{padding:3rem 0}.homeNavItem{border-radius:3.25rem!important;transition:.15s ease-in-out}.homeNavItem p{max-width:300px}div[role=banner]{padding:10px 0}div[role=banner] .close{color:#fff}div[role=banner] .close:focus,div[role=banner] .close:hover{color:#fff!important;opacity:1}.homeFooterContainer{background-color:#e6007a;padding:6rem 0 4rem}.homeFooterContainer .col-lg-6{align-items:flex-start;display:flex;flex-flow:column nowrap;margin-bottom:2rem}.homeFooterContainer .col-lg-6>:first-child{margin-bottom:1.3rem}.homeFooterContainer p{margin-bottom:2.5rem}.docs-wrapper{margin:0 auto;padding-bottom:80px}article blockquote{background-color:rgba(255,229,100,.3);border-left:8px solid #ffe564}article iframe,article img{display:block;max-width:100%}.prism-code{background-color:var(--custom-code-block-background)!important}.prism-code>div{width:100px!important}.table-of-contents__link--active,.table-of-contents__link--active code,.table-of-contents__link:hover,.table-of-contents__link:hover code{font-weight:600}.btn{font-size:16px;font-weight:700;padding:8px 16px}.btn,.btn:before{border-radius:1.5rem}.btn:before{left:-42px;width:42px}.btn-group-lg>.btn,.btn-lg{border-radius:2rem;padding:16px 20px}.btn-group-lg>.btn:before,.btn-lg:before{border-radius:2rem;left:-58px;width:58px}.btn-group-sm>.btn,.btn-sm{border-radius:1.5rem;font-size:16px;padding:8px 16px}.btn-group-sm>.btn:before,.btn-sm:before{border-radius:1.5rem;left:-42px;width:42px}.btn-primary{background-color:transparent;border-color:var(--ifm-color-primary);color:var(--ifm-color-primary);overflow:hidden;transform:scale(.999);transition:.2s,border 1ms;z-index:1}.btn-primary,.btn-primary:before{border:1px solid var(--ifm-color-primary);will-change:transform}.btn-primary:before{color:transparent;content:""}.btn-primary:active,.btn-primary:focus,.btn-primary:hover{background:none;border:1px solid transparent;color:#fff;transform:scale(1.05);will-change:transform}.btn-primary.focus,.btn-primary:focus{box-shadow:0 0 .2rem .2rem rgba(0,0,0,.1)}.btn-primary:not(:disabled):not(.disabled):active{background-color:transparent}.btn-primary:active:before,.btn-primary:focus:before,.btn-primary:hover:before{left:0;width:100%}.btn-bg-primary.btn-primary{border:1px solid #fff;color:#fff!important}.btn-bg-primary.btn-primary:active,.btn-bg-primary.btn-primary:focus,.btn-bg-primary.btn-primary:hover{background:#fff;color:var(--ifm-color-primary)!important}.btn-bg-primary.btn-primary:before{background:#fff;border:1px solid #fff;color:transparent;content:none;will-change:transform}.btn-white,.footer-legal a.text-white:hover,.nav-footer a.text-white:hover{color:#fff!important}.nav-footer.spacer-y-4{padding-bottom:3rem;padding-top:3rem}.nav-footer.pb-4{padding-bottom:2.25rem!important}.nav-footer .text-small{font-size:.875rem}.nav-footer{background:var(--secondaryColor);border:none;color:#202020;font-size:16px;line-height:24px}.nav-footer h5{font-size:1.25rem;font-weight:400;margin-top:0}.nav-footer a.text-white,.nav-footer a.text-white:visited{color:var(--silverColor)!important}.nav-footer-item-pill{background-color:#e6007a;border-radius:10px;color:#fff;font-size:.75rem;font-weight:700;padding:1px 8px}.list-social-links{display:flex;list-style:none;padding:0}.cardTitle_rnsV,footer .list-social-links i{font-size:1.2rem}footer .list-social-links a{text-decoration:none;background:0 0!important;border:1px solid #fff;border-radius:50%;color:#fff;display:block;padding:.25rem .9rem}footer [class^=socicon-]{line-height:2}footer .list-social-links{margin-left:0}.footer-legal .navbar-brand{display:block;padding-bottom:0}.footer-legal .list-pipe-separator>li:not(:last-child)>a:after{content:"|";margin:0 .375rem;opacity:.5}.footer-legal a.text-white,.footer-legal a.text-white:visited{color:#b5aeae!important}.cards-container{flex-flow:row wrap;max-width:100%;min-width:0}.cards,.cards-container{align-items:center;display:flex;justify-content:center}.cards{border:1px solid var(--primaryColor);border-radius:10px;box-shadow:0 .1rem .1rem rgba(0,0,0,.4);height:80px;margin:5px;padding:10px;top:0;transition:top .2s;width:350px}.cards:hover{top:-5px}.cards-body{align-items:flex-start;color:#000;display:flex;flex:1 auto;flex-flow:column nowrap;margin-left:5px}.cards-title{align-content:center;color:var(--ifm-color-primary-dark);font-size:1rem;font-weight:700}.cards-text{margin:1px 1px 1px 5px}.docusaurus-highlight-code-line{background-color:#faff9f;display:block;margin:0 calc(var(--ifm-pre-padding)*-1);padding:0 var(--ifm-pre-padding)}html[data-theme=dark] .docusaurus-highlight-code-line{background-color:#646464}.container.container-custom{width:100%}pre .btnIcon{background-color:hsla(0,0%,100%,.7);border:1px solid transparent;color:#000;cursor:pointer;height:30px;padding:3px;position:absolute;top:4px;transition:.25s ease-out;z-index:2}pre .btnIcon:hover{border:1px solid silver;text-decoration:none}.DocSearch-Button-Container,.btnIcon__body{align-items:center;display:flex}.btnIcon svg{fill:currentColor;margin-right:.4em}.btnIcon__label{font-size:11px}.btnClipboard{right:10px}@font-face{font-family:Socicon;font-style:normal;font-weight:400;src:url(/assets/fonts/Socicon-5e166614f1c831694816befaba8d03cf.eot);src:url(/assets/fonts/Socicon-5e166614f1c831694816befaba8d03cf.eot#iefix) format("embedded-opentype"),url(/assets/fonts/Socicon-d02985133d7e9e09bde470dd54104762.woff2) format("woff2"),url(/assets/fonts/Socicon-48b2d1e286d6b8d6ebefa630301dcf3b.ttf) format("truetype"),url(/assets/fonts/Socicon-9075c233656883ebc65aeb93d2fb76ba.woff) format("woff"),url(/assets/images/Socicon-620cd8c93935433c4e69112bb91768e8.svg#Socicon) format("svg")}[class*=" socicon-"],[class^=socicon-]{speak:none;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;font-family:Socicon!important;font-style:normal;font-variant:normal;font-weight:400;line-height:1;text-transform:none}.socicon-internet:before{content:"\e957"}.socicon-moddb:before{content:"\e94b"}.socicon-indiedb:before{content:"\e94c"}.socicon-traxsource:before{content:"\e94d"}.socicon-gamefor:before{content:"\e94e"}.socicon-pixiv:before{content:"\e94f"}.socicon-myanimelist:before{content:"\e950"}.socicon-blackberry:before{content:"\e951"}.socicon-wickr:before{content:"\e952"}.socicon-spip:before{content:"\e953"}.socicon-napster:before{content:"\e954"}.socicon-beatport:before{content:"\e955"}.socicon-hackerone:before{content:"\e956"}.socicon-hackernews:before{content:"\e946"}.socicon-smashwords:before{content:"\e947"}.socicon-kobo:before{content:"\e948"}.socicon-bookbub:before{content:"\e949"}.socicon-mailru:before{content:"\e94a"}.socicon-gitlab:before{content:"\e945"}.socicon-instructables:before{content:"\e944"}.socicon-portfolio:before{content:"\e943"}.socicon-codered:before{content:"\e940"}.socicon-origin:before{content:"\e941"}.socicon-nextdoor:before{content:"\e942"}.socicon-udemy:before{content:"\e93f"}.socicon-livemaster:before{content:"\e93e"}.socicon-crunchbase:before{content:"\e93b"}.socicon-homefy:before{content:"\e93c"}.socicon-calendly:before{content:"\e93d"}.socicon-realtor:before{content:"\e90f"}.socicon-tidal:before{content:"\e910"}.socicon-qobuz:before{content:"\e911"}.socicon-natgeo:before{content:"\e912"}.socicon-mastodon:before{content:"\e913"}.socicon-unsplash:before{content:"\e914"}.socicon-homeadvisor:before{content:"\e915"}.socicon-angieslist:before{content:"\e916"}.socicon-codepen:before{content:"\e917"}.socicon-slack:before{content:"\e918"}.socicon-openaigym:before{content:"\e919"}.socicon-logmein:before{content:"\e91a"}.socicon-fiverr:before{content:"\e91b"}.socicon-gotomeeting:before{content:"\e91c"}.socicon-aliexpress:before{content:"\e91d"}.socicon-guru:before{content:"\e91e"}.socicon-appstore:before{content:"\e91f"}.socicon-homes:before{content:"\e920"}.socicon-zoom:before{content:"\e921"}.socicon-alibaba:before{content:"\e922"}.socicon-craigslist:before{content:"\e923"}.socicon-wix:before{content:"\e924"}.socicon-redfin:before{content:"\e925"}.socicon-googlecalendar:before{content:"\e926"}.socicon-shopify:before{content:"\e927"}.socicon-freelancer:before{content:"\e928"}.socicon-seedrs:before{content:"\e929"}.socicon-bing:before{content:"\e92a"}.socicon-doodle:before{content:"\e92b"}.socicon-bonanza:before{content:"\e92c"}.socicon-squarespace:before{content:"\e92d"}.socicon-toptal:before{content:"\e92e"}.socicon-gust:before{content:"\e92f"}.socicon-ask:before{content:"\e930"}.socicon-trulia:before{content:"\e931"}.socicon-loomly:before{content:"\e932"}.socicon-ghost:before{content:"\e933"}.socicon-upwork:before{content:"\e934"}.socicon-fundable:before{content:"\e935"}.socicon-booking:before{content:"\e936"}.socicon-googlemaps:before{content:"\e937"}.socicon-zillow:before{content:"\e938"}.socicon-niconico:before{content:"\e939"}.socicon-toneden:before{content:"\e93a"}.socicon-augment:before{content:"\e908"}.socicon-bitbucket:before{content:"\e909"}.socicon-fyuse:before{content:"\e90a"}.socicon-yt-gaming:before{content:"\e90b"}.socicon-sketchfab:before{content:"\e90c"}.socicon-mobcrush:before{content:"\e90d"}.socicon-microsoft:before{content:"\e90e"}.socicon-pandora:before{content:"\e907"}.socicon-messenger:before{content:"\e906"}.socicon-gamewisp:before{content:"\e905"}.socicon-bloglovin:before{content:"\e904"}.socicon-tunein:before{content:"\e903"}.socicon-gamejolt:before{content:"\e901"}.socicon-trello:before{content:"\e902"}.socicon-spreadshirt:before{content:"\e900"}.socicon-500px:before{content:"\e000"}.socicon-8tracks:before{content:"\e001"}.socicon-airbnb:before{content:"\e002"}.socicon-alliance:before{content:"\e003"}.socicon-amazon:before{content:"\e004"}.socicon-amplement:before{content:"\e005"}.socicon-android:before{content:"\e006"}.socicon-angellist:before{content:"\e007"}.socicon-apple:before{content:"\e008"}.socicon-appnet:before{content:"\e009"}.socicon-baidu:before{content:"\e00a"}.socicon-bandcamp:before{content:"\e00b"}.socicon-battlenet:before{content:"\e00c"}.socicon-mixer:before{content:"\e00d"}.socicon-bebee:before{content:"\e00e"}.socicon-bebo:before{content:"\e00f"}.socicon-behance:before{content:"\e010"}.socicon-blizzard:before{content:"\e011"}.socicon-blogger:before{content:"\e012"}.socicon-buffer:before{content:"\e013"}.socicon-chrome:before{content:"\e014"}.socicon-coderwall:before{content:"\e015"}.socicon-curse:before{content:"\e016"}.socicon-dailymotion:before{content:"\e017"}.socicon-deezer:before{content:"\e018"}.socicon-delicious:before{content:"\e019"}.socicon-deviantart:before{content:"\e01a"}.socicon-diablo:before{content:"\e01b"}.socicon-digg:before{content:"\e01c"}.socicon-discord:before{content:"\e01d"}.socicon-disqus:before{content:"\e01e"}.socicon-douban:before{content:"\e01f"}.socicon-draugiem:before{content:"\e020"}.socicon-dribbble:before{content:"\e021"}.socicon-drupal:before{content:"\e022"}.socicon-ebay:before{content:"\e023"}.socicon-ello:before{content:"\e024"}.socicon-endomodo:before{content:"\e025"}.socicon-envato:before{content:"\e026"}.socicon-etsy:before{content:"\e027"}.socicon-facebook:before{content:"\e028"}.socicon-feedburner:before{content:"\e029"}.socicon-filmweb:before{content:"\e02a"}.socicon-firefox:before{content:"\e02b"}.socicon-flattr:before{content:"\e02c"}.socicon-flickr:before{content:"\e02d"}.socicon-formulr:before{content:"\e02e"}.socicon-forrst:before{content:"\e02f"}.socicon-foursquare:before{content:"\e030"}.socicon-friendfeed:before{content:"\e031"}.socicon-github:before{content:"\e032"}.socicon-goodreads:before{content:"\e033"}.socicon-google:before{content:"\e034"}.socicon-googlescholar:before{content:"\e035"}.socicon-googlegroups:before{content:"\e036"}.socicon-googlephotos:before{content:"\e037"}.socicon-googleplus:before{content:"\e038"}.socicon-grooveshark:before{content:"\e039"}.socicon-hackerrank:before{content:"\e03a"}.socicon-hearthstone:before{content:"\e03b"}.socicon-hellocoton:before{content:"\e03c"}.socicon-heroes:before{content:"\e03d"}.socicon-smashcast:before{content:"\e03e"}.socicon-horde:before{content:"\e03f"}.socicon-houzz:before{content:"\e040"}.socicon-icq:before{content:"\e041"}.socicon-identica:before{content:"\e042"}.socicon-imdb:before{content:"\e043"}.socicon-instagram:before{content:"\e044"}.socicon-issuu:before{content:"\e045"}.socicon-istock:before{content:"\e046"}.socicon-itunes:before{content:"\e047"}.socicon-keybase:before{content:"\e048"}.socicon-lanyrd:before{content:"\e049"}.socicon-lastfm:before{content:"\e04a"}.socicon-line:before{content:"\e04b"}.socicon-linkedin:before{content:"\e04c"}.socicon-livejournal:before{content:"\e04d"}.socicon-lyft:before{content:"\e04e"}.socicon-macos:before{content:"\e04f"}.socicon-mail:before{content:"\e050"}.socicon-medium:before{content:"\e051"}.socicon-meetup:before{content:"\e052"}.socicon-mixcloud:before{content:"\e053"}.socicon-modelmayhem:before{content:"\e054"}.socicon-mumble:before{content:"\e055"}.socicon-myspace:before{content:"\e056"}.socicon-newsvine:before{content:"\e057"}.socicon-nintendo:before{content:"\e058"}.socicon-npm:before{content:"\e059"}.socicon-odnoklassniki:before{content:"\e05a"}.socicon-openid:before{content:"\e05b"}.socicon-opera:before{content:"\e05c"}.socicon-outlook:before{content:"\e05d"}.socicon-overwatch:before{content:"\e05e"}.socicon-patreon:before{content:"\e05f"}.socicon-paypal:before{content:"\e060"}.socicon-periscope:before{content:"\e061"}.socicon-persona:before{content:"\e062"}.socicon-pinterest:before{content:"\e063"}.socicon-play:before{content:"\e064"}.socicon-player:before{content:"\e065"}.socicon-playstation:before{content:"\e066"}.socicon-pocket:before{content:"\e067"}.socicon-qq:before{content:"\e068"}.socicon-quora:before{content:"\e069"}.socicon-raidcall:before{content:"\e06a"}.socicon-ravelry:before{content:"\e06b"}.socicon-reddit:before{content:"\e06c"}.socicon-renren:before{content:"\e06d"}.socicon-researchgate:before{content:"\e06e"}.socicon-residentadvisor:before{content:"\e06f"}.socicon-reverbnation:before{content:"\e070"}.socicon-rss:before{content:"\e071"}.socicon-sharethis:before{content:"\e072"}.socicon-skype:before{content:"\e073"}.socicon-slideshare:before{content:"\e074"}.socicon-smugmug:before{content:"\e075"}.socicon-snapchat:before{content:"\e076"}.socicon-songkick:before{content:"\e077"}.socicon-soundcloud:before{content:"\e078"}.socicon-spotify:before{content:"\e079"}.socicon-stackexchange:before{content:"\e07a"}.socicon-stackoverflow:before{content:"\e07b"}.socicon-starcraft:before{content:"\e07c"}.socicon-stayfriends:before{content:"\e07d"}.socicon-steam:before{content:"\e07e"}.socicon-storehouse:before{content:"\e07f"}.socicon-strava:before{content:"\e080"}.socicon-streamjar:before{content:"\e081"}.socicon-stumbleupon:before{content:"\e082"}.socicon-swarm:before{content:"\e083"}.socicon-teamspeak:before{content:"\e084"}.socicon-teamviewer:before{content:"\e085"}.socicon-technorati:before{content:"\e086"}.socicon-telegram:before{content:"\e087"}.socicon-tripadvisor:before{content:"\e088"}.socicon-tripit:before{content:"\e089"}.socicon-triplej:before{content:"\e08a"}.socicon-tumblr:before{content:"\e08b"}.socicon-twitch:before{content:"\e08c"}.socicon-twitter:before{content:"\e08d"}.socicon-uber:before{content:"\e08e"}.socicon-ventrilo:before{content:"\e08f"}.socicon-viadeo:before{content:"\e090"}.socicon-viber:before{content:"\e091"}.socicon-viewbug:before{content:"\e092"}.socicon-vimeo:before{content:"\e093"}.socicon-vine:before{content:"\e094"}.socicon-vkontakte:before{content:"\e095"}.socicon-warcraft:before{content:"\e096"}.socicon-wechat:before{content:"\e097"}.socicon-weibo:before{content:"\e098"}.socicon-whatsapp:before{content:"\e099"}.socicon-wikipedia:before{content:"\e09a"}.socicon-windows:before{content:"\e09b"}.socicon-wordpress:before{content:"\e09c"}.socicon-wykop:before{content:"\e09d"}.socicon-xbox:before{content:"\e09e"}.socicon-xing:before{content:"\e09f"}.socicon-yahoo:before{content:"\e0a0"}.socicon-yammer:before{content:"\e0a1"}.socicon-yandex:before{content:"\e0a2"}.socicon-yelp:before{content:"\e0a3"}.socicon-younow:before{content:"\e0a4"}.socicon-youtube:before{content:"\e0a5"}.socicon-zapier:before{content:"\e0a6"}.socicon-zerply:before{content:"\e0a7"}.socicon-zomato:before{content:"\e0a8"}.socicon-zynga:before{content:"\e0a9"}body:not(.navigation-with-keyboard) :not(input):focus{outline:0}.skipToContent_fXgn{background-color:var(--ifm-background-surface-color);color:var(--ifm-color-emphasis-900);left:100%;padding:calc(var(--ifm-global-spacing)/2) var(--ifm-global-spacing);position:fixed;top:1rem;z-index:calc(var(--ifm-z-index-fixed) + 1)}.skipToContent_fXgn:focus{box-shadow:var(--ifm-global-shadow-md);left:1rem}.closeButton_CVFx{line-height:0;padding:0}.content_knG7{font-size:85%;padding:5px 0;text-align:center}.content_knG7 a{color:inherit;text-decoration:underline}.DocSearch-Container a,.tag_zVej:hover{text-decoration:none}.announcementBar_mb4j{align-items:center;background-color:var(--ifm-color-white);border-bottom:1px solid var(--ifm-color-emphasis-100);color:var(--ifm-color-black);display:flex;height:var(--docusaurus-announcement-bar-height)}.announcementBarPlaceholder_vyr4{flex:0 0 10px}.announcementBarClose_gvF7{align-self:stretch;flex:0 0 30px}.toggle_vylO{height:2rem;width:2rem}.toggleButton_gllP{align-items:center;border-radius:50%;display:flex;height:100%;justify-content:center;transition:background var(--ifm-transition-fast);width:100%}.toggleButton_gllP:hover{background:var(--ifm-color-emphasis-200)}.toggleButtonDisabled_aARS{cursor:not-allowed}.darkNavbarColorModeToggle_X3D1:hover{background:var(--ifm-color-gray-800)}[data-theme=dark] .themedImage--dark_i4oU,[data-theme=light] .themedImage--light_HNdA,html:not([data-theme]) .themedComponent--light_NU7w{display:initial}.iconExternalLink_nPIU{margin-left:.3rem}.iconLanguage_nlXk{margin-right:5px;vertical-align:text-bottom}.navbarHideable_m1mJ{transition:transform var(--ifm-transition-fast) ease}.navbarHidden_jGov{transform:translate3d(0,calc(-100% - 2px),0)}.errorBoundaryError_a6uf{color:red;white-space:pre-wrap}.mainWrapper_z2l0{display:flex;flex:1 0 auto;flex-direction:column}.docusaurus-mt-lg{margin-top:3rem}#__docusaurus{display:flex;flex-direction:column;min-height:100%}.iconEdit_Z9Sw{margin-right:.3em;vertical-align:sub}.tag_zVej{border:1px solid var(--docusaurus-tag-list-border);transition:border var(--ifm-transition-fast)}.tag_zVej:hover{--docusaurus-tag-list-border:var(--ifm-link-color)}.tagRegular_sFm0{border-radius:var(--ifm-global-radius);font-size:90%;padding:.2rem .5rem .3rem}.tagWithCount_h2kH{align-items:center;border-left:0;display:flex;padding:0 .5rem 0 1rem;position:relative}.tagWithCount_h2kH:after,.tagWithCount_h2kH:before{border:1px solid var(--docusaurus-tag-list-border);content:"";position:absolute;top:50%;transition:inherit}.tagWithCount_h2kH:before{border-bottom:0;border-right:0;height:1.18rem;right:100%;transform:translate(50%,-50%) rotate(-45deg);width:1.18rem}.tagWithCount_h2kH:after{border-radius:50%;height:.5rem;left:0;transform:translateY(-50%);width:.5rem}.tagWithCount_h2kH span{background:var(--ifm-color-secondary);border-radius:var(--ifm-global-radius);color:var(--ifm-color-black);font-size:.7rem;line-height:1.2;margin-left:.3rem;padding:.1rem .4rem}.tags_jXut{display:inline}.tag_QGVx{display:inline-block;margin:0 .4rem .5rem 0}.lastUpdated_vwxv{font-size:smaller;font-style:italic;margin-top:.2rem}.tocCollapsibleButton_TO0P{align-items:center;display:flex;font-size:inherit;justify-content:space-between;padding:.4rem .8rem;width:100%}.tocCollapsibleButton_TO0P:after{background:var(--ifm-menu-link-sublist-icon) 50% 50%/2rem 2rem no-repeat;content:"";filter:var(--ifm-menu-link-sublist-icon-filter);height:1.25rem;transform:rotate(180deg);transition:transform var(--ifm-transition-fast);width:1.25rem}.tocCollapsibleButtonExpanded_MG3E:after,.tocCollapsibleExpanded_sAul{transform:none}.tocCollapsible_ETCw{background-color:var(--ifm-menu-color-background-active);border-radius:var(--ifm-global-radius);margin:1rem 0}.tocCollapsibleContent_vkbj>ul{border-left:none;border-top:1px solid var(--ifm-color-emphasis-300);font-size:15px;padding:.2rem 0}.tocCollapsibleContent_vkbj ul li{margin:.4rem .8rem}.tocCollapsibleContent_vkbj a{display:block}.tableOfContents_bqdL{max-height:calc(100vh - var(--ifm-navbar-height) - 2rem);overflow-y:auto;position:sticky;top:calc(var(--ifm-navbar-height) + 1rem)}.searchQueryInput_u2C7,.searchVersionInput_m0Ui{background:var(--docsearch-searchbox-focus-background);border:2px solid var(--ifm-toc-border-color);border-radius:var(--ifm-global-radius);color:var(--docsearch-text-color);font:var(--ifm-font-size-base) var(--ifm-font-family-base);margin-bottom:.5rem;padding:.8rem;transition:border var(--ifm-transition-fast) ease;width:100%}.searchQueryInput_u2C7:focus,.searchVersionInput_m0Ui:focus{border-color:var(--docsearch-primary-color);outline:0}.searchQueryInput_u2C7::-moz-placeholder{color:var(--docsearch-muted-color)}.searchQueryInput_u2C7::placeholder{color:var(--docsearch-muted-color)}.searchResultsColumn_JPFH{font-size:.9rem;font-weight:700}.algoliaLogo_rT1R{max-width:150px}.algoliaLogoPathFill_WdUC{fill:var(--ifm-font-color-base)}.searchResultItem_Tv2o{border-bottom:1px solid var(--ifm-toc-border-color);padding:1rem 0}.searchResultItemHeading_KbCB{font-weight:400;margin-bottom:0}.searchResultItemPath_lhe1{--ifm-breadcrumb-separator-size-multiplier:1;color:var(--ifm-color-content-secondary);font-size:.8rem}.searchResultItemSummary_AEaO{font-style:italic;margin:.5rem 0 0}.loadingSpinner_XVxU{animation:1s linear infinite a;border:.4em solid #eee;border-radius:50%;border-top:.4em solid var(--ifm-color-primary);height:3rem;margin:0 auto;width:3rem}@keyframes a{to{transform:rotate(1turn)}}.loader_vvXV{margin-top:2rem}.search-result-match{background:rgba(255,215,142,.25);color:var(--docsearch-hit-color);padding:.09em 0}.backToTopButton_sjWU{background-color:var(--ifm-color-emphasis-200);border-radius:50%;bottom:1.3rem;box-shadow:var(--ifm-global-shadow-lw);height:3rem;opacity:0;position:fixed;right:1.3rem;transform:scale(0);transition:all var(--ifm-transition-fast) var(--ifm-transition-timing-default);visibility:hidden;width:3rem;z-index:calc(var(--ifm-z-index-fixed) - 1)}.backToTopButton_sjWU:after{background-color:var(--ifm-color-emphasis-1000);content:" ";display:inline-block;height:100%;-webkit-mask:var(--ifm-menu-link-sublist-icon) 50%/2rem 2rem no-repeat;mask:var(--ifm-menu-link-sublist-icon) 50%/2rem 2rem no-repeat;width:100%}.backToTopButtonShow_xfvO{opacity:1;transform:scale(1);visibility:visible}[data-theme=dark]:root{--docusaurus-collapse-button-bg:hsla(0,0%,100%,.05);--docusaurus-collapse-button-bg-hover:hsla(0,0%,100%,.1)}.collapseSidebarButton_PEFL{display:none;margin:0}.docMainContainer_gTbr,.docPage__5DB{display:flex;width:100%}.docPage__5DB{flex:1 0}.docsWrapper_BCFX{display:flex;flex:1 0 auto}.cardContainer_fWXF{--ifm-link-color:var(--ifm-color-emphasis-800);--ifm-link-hover-color:var(--ifm-color-emphasis-700);--ifm-link-hover-decoration:none;border:1px solid var(--ifm-color-emphasis-200);box-shadow:0 1.5px 3px 0 rgba(0,0,0,.15);transition:all var(--ifm-transition-fast) ease;transition-property:border,box-shadow}.cardContainer_fWXF:hover{border-color:var(--ifm-color-primary);box-shadow:0 3px 6px 0 rgba(0,0,0,.2)}.cardDescription_PWke{font-size:.8rem}.DocSearch-Button{align-items:center;background:var(--docsearch-searchbox-background);border:0;border-radius:40px;color:var(--docsearch-muted-color);cursor:pointer;display:flex;font-weight:500;height:36px;justify-content:space-between;padding:0 8px;user-select:none}.DocSearch-Footer,.DocSearch-Help{-webkit-user-select:none;-moz-user-select:none}.DocSearch-Button:active,.DocSearch-Button:focus,.DocSearch-Button:hover{background:var(--docsearch-searchbox-focus-background);box-shadow:var(--docsearch-searchbox-shadow);color:var(--docsearch-text-color);outline:0}.DocSearch-Search-Icon{stroke-width:1.6}.DocSearch-Hit-Tree,.DocSearch-Hit-action,.DocSearch-Hit-icon,.DocSearch-Reset{stroke-width:var(--docsearch-icon-stroke-width)}.DocSearch-Button .DocSearch-Search-Icon{color:var(--docsearch-text-color)}.DocSearch-Button-Placeholder{font-size:1rem;padding:0 12px 0 6px}.DocSearch-Input,.DocSearch-Link{-webkit-appearance:none;-moz-appearance:none;font:inherit}.DocSearch-Button-Keys{display:flex;min-width:calc(40px + .8em)}.DocSearch-Button-Key{align-items:center;background:var(--docsearch-key-gradient);border:0;border-radius:3px;box-shadow:var(--docsearch-key-shadow);color:var(--docsearch-muted-color);display:flex;height:18px;justify-content:center;margin-right:.4em;padding:0 0 2px;position:relative;top:-1px;width:20px}.DocSearch--active{overflow:hidden!important}.DocSearch-Container{background-color:var(--docsearch-container-background);height:100vh;left:0;position:fixed;top:0;width:100vw;z-index:200}.DocSearch-Link{appearance:none;background:none;border:0;color:var(--docsearch-highlight-color);cursor:pointer;margin:0;padding:0}.DocSearch-Modal{background:var(--docsearch-modal-background);border-radius:6px;box-shadow:var(--docsearch-modal-shadow);flex-direction:column;margin:60px auto auto;max-width:var(--docsearch-modal-width);position:relative}.DocSearch-SearchBar{display:flex;padding:var(--docsearch-spacing) var(--docsearch-spacing) 0}.DocSearch-Form{align-items:center;background:var(--docsearch-searchbox-focus-background);border-radius:4px;box-shadow:var(--docsearch-searchbox-shadow);display:flex;height:var(--docsearch-searchbox-height);margin:0;padding:0 var(--docsearch-spacing);position:relative;width:100%}.DocSearch-Input{appearance:none;background:0 0;border:0;color:var(--docsearch-text-color);flex:1;font-size:1.2em;height:100%;outline:0;padding:0 0 0 8px;width:80%}.DocSearch-Hit-action-button,.DocSearch-Reset{-webkit-appearance:none;-moz-appearance:none;border:0;cursor:pointer}.DocSearch-Input::-moz-placeholder{color:var(--docsearch-muted-color);opacity:1}.DocSearch-Input::placeholder{color:var(--docsearch-muted-color);opacity:1}.DocSearch-Input::-webkit-search-cancel-button,.DocSearch-Input::-webkit-search-decoration,.DocSearch-Input::-webkit-search-results-button,.DocSearch-Input::-webkit-search-results-decoration{display:none}.DocSearch-LoadingIndicator,.DocSearch-MagnifierLabel,.DocSearch-Reset{margin:0;padding:0}.DocSearch-Container--Stalled .DocSearch-LoadingIndicator,.DocSearch-MagnifierLabel,.DocSearch-Reset{align-items:center;color:var(--docsearch-highlight-color);display:flex;justify-content:center}.DocSearch-Cancel,.DocSearch-Container--Stalled .DocSearch-MagnifierLabel,.DocSearch-LoadingIndicator,.DocSearch-Reset[hidden]{display:none}.DocSearch-Reset{animation:.1s ease-in forwards b;appearance:none;background:none;border-radius:50%;color:var(--docsearch-icon-color);padding:2px;right:0}.DocSearch-Help,.DocSearch-HitsFooter,.DocSearch-Label{color:var(--docsearch-muted-color)}.DocSearch-Reset:hover{color:var(--docsearch-highlight-color)}.DocSearch-LoadingIndicator svg,.DocSearch-MagnifierLabel svg{height:24px;width:24px}.DocSearch-Dropdown{max-height:calc(var(--docsearch-modal-height) - var(--docsearch-searchbox-height) - var(--docsearch-spacing) - var(--docsearch-footer-height));min-height:var(--docsearch-spacing);overflow-y:auto;overflow-y:overlay;padding:0 var(--docsearch-spacing);scrollbar-color:var(--docsearch-muted-color) var(--docsearch-modal-background);scrollbar-width:thin}.DocSearch-Dropdown::-webkit-scrollbar{width:12px}.DocSearch-Dropdown::-webkit-scrollbar-track{background:0 0}.DocSearch-Dropdown::-webkit-scrollbar-thumb{background-color:var(--docsearch-muted-color);border:3px solid var(--docsearch-modal-background);border-radius:20px}.DocSearch-Dropdown ul{list-style:none;margin:0;padding:0}.DocSearch-Label{font-size:.75em;line-height:1.6em}.DocSearch-Help{font-size:.9em;margin:0;user-select:none}.DocSearch-Title{font-size:1.2em}.DocSearch-Logo a{display:flex}.DocSearch-Logo svg{color:var(--docsearch-logo-color);margin-left:8px}.DocSearch-Hits:last-of-type{margin-bottom:24px}.DocSearch-Hits mark{background:none;color:var(--docsearch-highlight-color)}.DocSearch-HitsFooter{display:flex;font-size:.85em;justify-content:center;margin-bottom:var(--docsearch-spacing);padding:var(--docsearch-spacing)}.DocSearch-HitsFooter a{border-bottom:1px solid;color:inherit}.DocSearch-Hit{border-radius:4px;display:flex;padding-bottom:4px;position:relative}.DocSearch-Hit--deleting{opacity:0;transition:.25s linear}.DocSearch-Hit--favoriting{transform:scale(0);transform-origin:top center;transition:.25s linear .25s}.DocSearch-Hit a{background:var(--docsearch-hit-background);border-radius:4px;box-shadow:var(--docsearch-hit-shadow);display:block;padding-left:var(--docsearch-spacing);width:100%}.DocSearch-Hit-source{background:var(--docsearch-modal-background);color:var(--docsearch-highlight-color);font-size:.85em;font-weight:600;line-height:32px;margin:0 -4px;padding:8px 4px 0;position:sticky;top:0;z-index:10}.DocSearch-Hit-Tree{color:var(--docsearch-muted-color);height:var(--docsearch-hit-height);opacity:.5;width:24px}.DocSearch-Hit[aria-selected=true] a{background-color:var(--docsearch-highlight-color)}.DocSearch-Hit[aria-selected=true] mark{text-decoration:underline}.DocSearch-Hit-Container{align-items:center;color:var(--docsearch-hit-color);display:flex;flex-direction:row;height:var(--docsearch-hit-height);padding:0 var(--docsearch-spacing) 0 0}.DocSearch-Hit-icon{height:20px;width:20px}.DocSearch-Hit-action,.DocSearch-Hit-icon{color:var(--docsearch-muted-color)}.DocSearch-Hit-action{align-items:center;display:flex;height:22px;width:22px}.DocSearch-Hit-action svg{display:block;height:18px;width:18px}.DocSearch-Hit-action+.DocSearch-Hit-action{margin-left:6px}.DocSearch-Hit-action-button{appearance:none;background:none;border-radius:50%;color:inherit;padding:2px}svg.DocSearch-Hit-Select-Icon{display:none}.DocSearch-Hit[aria-selected=true] .DocSearch-Hit-Select-Icon{display:block}.DocSearch-Hit-action-button:focus,.DocSearch-Hit-action-button:hover{background:rgba(0,0,0,.2);transition:background-color .1s ease-in}.DocSearch-Hit-action-button:focus path,.DocSearch-Hit-action-button:hover path{fill:#fff}.DocSearch-Hit-content-wrapper{display:flex;flex:1 1 auto;flex-direction:column;font-weight:500;justify-content:center;line-height:1.2em;margin:0 8px;overflow-x:hidden;position:relative;text-overflow:ellipsis;white-space:nowrap;width:80%}.DocSearch-Hit-title{font-size:.9em}.DocSearch-Hit-path{color:var(--docsearch-muted-color);font-size:.75em}.DocSearch-Hit[aria-selected=true] .DocSearch-Hit-Tree,.DocSearch-Hit[aria-selected=true] .DocSearch-Hit-action,.DocSearch-Hit[aria-selected=true] .DocSearch-Hit-icon,.DocSearch-Hit[aria-selected=true] .DocSearch-Hit-path,.DocSearch-Hit[aria-selected=true] .DocSearch-Hit-text,.DocSearch-Hit[aria-selected=true] .DocSearch-Hit-title,.DocSearch-Hit[aria-selected=true] mark{color:var(--docsearch-hit-active-color)!important}.DocSearch-ErrorScreen,.DocSearch-NoResults,.DocSearch-StartScreen{font-size:.9em;margin:0 auto;padding:36px 0;text-align:center;width:80%}.DocSearch-Screen-Icon{color:var(--docsearch-muted-color);padding-bottom:12px}.DocSearch-NoResults-Prefill-List{display:inline-block;padding-bottom:24px;text-align:left}.DocSearch-NoResults-Prefill-List ul{display:inline-block;padding:8px 0 0}.DocSearch-NoResults-Prefill-List li{list-style-position:inside;list-style-type:"» "}.DocSearch-Prefill{-webkit-appearance:none;-moz-appearance:none;appearance:none;background:none;border:0;border-radius:1em;color:var(--docsearch-highlight-color);cursor:pointer;display:inline-block;font-size:1em;font-weight:700;padding:0}.DocSearch-Prefill:focus,.DocSearch-Prefill:hover{outline:0;text-decoration:underline}.DocSearch-Footer{align-items:center;background:var(--docsearch-footer-background);border-radius:0 0 8px 8px;box-shadow:var(--docsearch-footer-shadow);display:flex;flex-direction:row-reverse;flex-shrink:0;height:var(--docsearch-footer-height);justify-content:space-between;padding:0 var(--docsearch-spacing);position:relative;user-select:none;width:100%;z-index:300}.DocSearch-Commands li,.DocSearch-Commands-Key{align-items:center;display:flex}.DocSearch-Commands{color:var(--docsearch-muted-color);display:flex;list-style:none;margin:0;padding:0}.DocSearch-Commands li:not(:last-of-type){margin-right:.8em}.DocSearch-Commands-Key{background:var(--docsearch-key-gradient);border:0;border-radius:2px;box-shadow:var(--docsearch-key-shadow);color:var(--docsearch-muted-color);height:18px;justify-content:center;margin-right:.4em;padding:0 0 1px;width:20px}.buttonGroup__atx button,.codeBlockContainer_Ckt0{background:var(--prism-background-color);color:var(--prism-color)}@keyframes b{0%{opacity:0}to{opacity:1}}.DocSearch-Button{margin:0;transition:all var(--ifm-transition-fast) var(--ifm-transition-timing-default)}.DocSearch-Container{z-index:calc(var(--ifm-z-index-fixed) + 1)}.anchorWithStickyNavbar_LWe7{scroll-margin-top:calc(var(--ifm-navbar-height) + .5rem)}.anchorWithHideOnScrollNavbar_WYt5{scroll-margin-top:.5rem}.hash-link{opacity:0;padding-left:.5rem;transition:opacity var(--ifm-transition-fast);-webkit-user-select:none;-moz-user-select:none;user-select:none}.hash-link:before{content:"#"}.codeBlockContainer_Ckt0{border-radius:var(--ifm-code-border-radius);box-shadow:var(--ifm-global-shadow-lw);margin-bottom:var(--ifm-leading)}.codeBlockContent_biex{border-radius:inherit;direction:ltr;position:relative}.codeBlockTitle_Ktv7{border-bottom:1px solid var(--ifm-color-emphasis-300);border-top-left-radius:inherit;border-top-right-radius:inherit;font-size:var(--ifm-code-font-size);font-weight:500;padding:.75rem var(--ifm-pre-padding)}.codeBlock_bY9V{--ifm-pre-background:var(--prism-background-color);margin:0;padding:0}.codeBlockTitle_Ktv7+.codeBlockContent_biex .codeBlock_bY9V{border-top-left-radius:0;border-top-right-radius:0}.codeBlockLines_e6Vv{float:left;font:inherit;min-width:100%;padding:var(--ifm-pre-padding)}.codeBlockLinesWithNumbering_o6Pm{display:table;padding:var(--ifm-pre-padding) 0}.buttonGroup__atx{-moz-column-gap:.2rem;column-gap:.2rem;display:flex;position:absolute;right:calc(var(--ifm-pre-padding)/2);top:calc(var(--ifm-pre-padding)/2)}.buttonGroup__atx button{align-items:center;border:1px solid var(--ifm-color-emphasis-300);border-radius:var(--ifm-global-radius);display:flex;line-height:0;opacity:0;padding:.4rem;transition:opacity var(--ifm-transition-fast) ease-in-out}.buttonGroup__atx button:focus-visible,.buttonGroup__atx button:hover{opacity:1!important}.theme-code-block:hover .buttonGroup__atx button{opacity:.4}:where(:root){--docusaurus-highlighted-code-line-bg:#484d5b}:where([data-theme=dark]){--docusaurus-highlighted-code-line-bg:#646464}.theme-code-block-highlighted-line{background-color:var(--docusaurus-highlighted-code-line-bg);display:block;margin:0 calc(var(--ifm-pre-padding)*-1);padding:0 var(--ifm-pre-padding)}.codeLine_lJS_{counter-increment:a;display:table-row}.codeLineNumber_Tfdd{background:var(--ifm-pre-background);display:table-cell;left:0;overflow-wrap:normal;padding:0 var(--ifm-pre-padding);position:sticky;text-align:right;width:1%}.codeLineNumber_Tfdd:before{content:counter(a);opacity:.4}.codeLineContent_feaV{padding-right:var(--ifm-pre-padding)}.theme-code-block:hover .copyButtonCopied_obH4{opacity:1!important}.copyButtonIcons_eSgA{height:1.125rem;position:relative;width:1.125rem}.copyButtonIcon_y97N,.copyButtonSuccessIcon_LjdS{fill:currentColor;height:inherit;left:0;opacity:inherit;position:absolute;top:0;transition:all var(--ifm-transition-fast) ease;width:inherit}.copyButtonSuccessIcon_LjdS{color:#00d600;left:50%;opacity:0;top:50%;transform:translate(-50%,-50%) scale(.33)}.copyButtonCopied_obH4 .copyButtonIcon_y97N{opacity:0;transform:scale(.33)}.copyButtonCopied_obH4 .copyButtonSuccessIcon_LjdS{opacity:1;transform:translate(-50%,-50%) scale(1);transition-delay:75ms}.wordWrapButtonIcon_Bwma{height:1.2rem;width:1.2rem}.details_lb9f{--docusaurus-details-summary-arrow-size:0.38rem;--docusaurus-details-transition:transform 200ms ease;--docusaurus-details-decoration-color:grey}.details_lb9f>summary{cursor:pointer;list-style:none;padding-left:1rem;position:relative}.details_lb9f>summary::-webkit-details-marker{display:none}.details_lb9f>summary:before{border-color:transparent transparent transparent var(--docusaurus-details-decoration-color);border-style:solid;border-width:var(--docusaurus-details-summary-arrow-size);content:"";left:0;position:absolute;top:.45rem;transform:rotate(0);transform-origin:calc(var(--docusaurus-details-summary-arrow-size)/2) 50%;transition:var(--docusaurus-details-transition)}.collapsibleContent_i85q{border-top:1px solid var(--docusaurus-details-decoration-color);margin-top:1rem;padding-top:1rem}.details_b_Ee{--docusaurus-details-decoration-color:var(--ifm-alert-border-color);--docusaurus-details-transition:transform var(--ifm-transition-fast) ease;border:1px solid var(--ifm-alert-border-color);margin:0 0 var(--ifm-spacing-vertical)}.containsTaskList_mC6p{list-style:none}.admonition_LlT9{margin-bottom:1em}.admonitionHeading_tbUL{font:var(--ifm-heading-font-weight) var(--ifm-h5-font-size)/var(--ifm-heading-line-height) var(--ifm-heading-font-family);margin-bottom:.3rem;text-transform:uppercase}.admonitionHeading_tbUL code{text-transform:none}.admonitionIcon_kALy{display:inline-block;margin-right:.4em;vertical-align:middle}.admonitionIcon_kALy svg{fill:var(--ifm-alert-foreground-color);display:inline-block;height:1.6em;width:1.6em}.breadcrumbHomeIcon_YNFT{height:1.1rem;position:relative;top:1px;vertical-align:top;width:1.1rem}.breadcrumbsContainer_Z_bl{--ifm-breadcrumb-size-multiplier:0.8;margin-bottom:.8rem}.title_kItE{--ifm-h1-font-size:3rem;margin-bottom:calc(var(--ifm-leading)*1.25)}@media (min-width:576px){.container.container-custom{max-width:540px}}@media (min-width:768px){.nav-footer.spacer-y-4{padding-bottom:6rem;padding-top:6rem}.nav-footer .py-md-1{padding-bottom:.375rem!important;padding-top:.375rem!important}.container.container-custom{max-width:720px}}@media (min-width:992px){.homeNavContainer{height:90vh;max-height:900px;min-height:600px}.homeNavItem{border-radius:3.25rem!important;margin-top:-3rem;min-height:400px;transition:.15s ease-in-out}.homeNavItem:after{-webkit-font-feature-settings:"liga";bottom:3rem;color:var(--silverColor);content:"arrow_upward";font-family:Material Icons;font-size:1.5rem;left:50%;opacity:0;position:absolute;transform:translate(-50%);transition:.2s ease-in-out}.homeNavItem:hover{box-shadow:0 1rem 3rem rgba(0,0,0,.04);transform:translateY(-1rem)}.homeNavItem:hover:after{opacity:1}.homeNavItemContent{margin-top:10%}.homeNavItem h1{font-size:4.2vw}.container.container-custom{max-width:960px}}@media (min-width:997px){.collapseSidebarButton_PEFL,.expandButton_m80_{background-color:var(--docusaurus-collapse-button-bg)}:root{--docusaurus-announcement-bar-height:30px}.announcementBarClose_gvF7,.announcementBarPlaceholder_vyr4{flex-basis:50px}.searchBox_ZlJk{padding:var(--ifm-navbar-item-padding-vertical) var(--ifm-navbar-item-padding-horizontal)}.lastUpdated_vwxv{text-align:right}.tocMobile_ITEo{display:none}.collapseSidebarButton_PEFL{border:1px solid var(--ifm-toc-border-color);border-radius:0;bottom:0;display:block!important;height:40px;position:sticky}.collapseSidebarButtonIcon_kv0_{margin-top:4px;transform:rotate(180deg)}.expandButtonIcon_BlDH,[dir=rtl] .collapseSidebarButtonIcon_kv0_{transform:rotate(0)}.collapseSidebarButton_PEFL:focus,.collapseSidebarButton_PEFL:hover,.expandButton_m80_:focus,.expandButton_m80_:hover{background-color:var(--docusaurus-collapse-button-bg-hover)}.menuHtmlItem_M9Kj{padding:var(--ifm-menu-link-padding-vertical) var(--ifm-menu-link-padding-horizontal)}.menu_SIkG{flex-grow:1;padding:.5rem}@supports (scrollbar-gutter:stable){.menu_SIkG{padding:.5rem 0 .5rem .5rem;scrollbar-gutter:stable}}.menuWithAnnouncementBar_GW3s{margin-bottom:var(--docusaurus-announcement-bar-height)}.sidebar_njMd{display:flex;flex-direction:column;height:100%;padding-top:var(--ifm-navbar-height);width:var(--doc-sidebar-width)}.sidebarWithHideableNavbar_wUlq{padding-top:0}.sidebarHidden_VK0M{opacity:0;visibility:hidden}.sidebarLogo_isFc{align-items:center;color:inherit!important;display:flex!important;margin:0 var(--ifm-navbar-padding-horizontal);max-height:var(--ifm-navbar-height);min-height:var(--ifm-navbar-height);text-decoration:none!important}.sidebarLogo_isFc img{height:2rem;margin-right:.5rem}.expandButton_m80_{align-items:center;display:flex;height:100%;justify-content:center;position:absolute;right:0;top:0;transition:background-color var(--ifm-transition-fast) ease;width:100%}[dir=rtl] .expandButtonIcon_BlDH{transform:rotate(180deg)}.docSidebarContainer_b6E3{border-right:1px solid var(--ifm-toc-border-color);-webkit-clip-path:inset(0);clip-path:inset(0);display:block;margin-top:calc(var(--ifm-navbar-height)*-1);transition:width var(--ifm-transition-fast) ease;width:var(--doc-sidebar-width);will-change:width}.docSidebarContainerHidden_b3ry{cursor:pointer;width:var(--doc-sidebar-hidden-width)}.sidebarViewport_Xe31{height:100%;max-height:100vh;position:sticky;top:0}.docMainContainer_gTbr{flex-grow:1;max-width:calc(100% - var(--doc-sidebar-width))}.docMainContainerEnhanced_Uz_u{max-width:calc(100% - var(--doc-sidebar-hidden-width))}.docItemWrapperEnhanced_czyv{max-width:calc(var(--ifm-container-width) + var(--doc-sidebar-width))!important}.docItemCol_VOVn,.generatedIndexPage_vN6x{max-width:75%!important}.list_eTzJ article:nth-last-child(-n+2){margin-bottom:0!important}}@media only screen and (min-width:1024px){.navbar__inner a.navbar__item[href*=contributing]{background:#fff;border:1px solid var(--ifm-color-primary);border-radius:20px;color:var(--ifm-color-primary);font-size:14px;font-weight:700;height:35px;line-height:35px;margin-left:16px;padding:0 16px}.navbar__inner a.navbar__item[href*=contributing]:hover{background:var(--ifm-color-primary);color:#fff}}@media (min-width:1200px){.homeNavItem h1{font-size:3.5rem;line-height:1.2}.container.container-custom{max-width:1140px}}@media (min-width:1440px){.container{max-width:var(--ifm-container-width-xl)}}@media (max-width:996px){.col{--ifm-col-width:100%;flex-basis:var(--ifm-col-width);margin-left:0}.footer{--ifm-footer-padding-horizontal:0}.colorModeToggle_DEke,.footer__link-separator,.navbar__item,.tableOfContents_bqdL{display:none}.footer__col{margin-bottom:calc(var(--ifm-spacing-vertical)*3)}.footer__link-item{display:block}.hero{padding-left:0;padding-right:0}.navbar>.container,.navbar>.container-fluid{padding:0}.navbar__toggle{display:inherit}.navbar__search-input{width:9rem}.pills--block,.tabs--block{flex-direction:column}.searchBox_ZlJk{position:absolute;right:var(--ifm-navbar-padding-horizontal)}.docItemContainer_F8PC{padding:0 .3rem}}@media only screen and (max-width:996px){.searchQueryColumn_RTkw,.searchResultsColumn_JPFH{max-width:60%!important}.searchLogoColumn_rJIA,.searchVersionColumn_ypXd{max-width:40%!important}.searchLogoColumn_rJIA{padding-left:0!important}}@media (max-width:768px){.DocSearch-Button-Keys,.DocSearch-Button-Placeholder,.DocSearch-Commands,.DocSearch-Hit-Tree{display:none}:root{--docsearch-spacing:10px;--docsearch-footer-height:40px}.DocSearch-Dropdown{height:100%;max-height:calc(var(--docsearch-vh,1vh)*100 - var(--docsearch-searchbox-height) - var(--docsearch-spacing) - var(--docsearch-footer-height))}.DocSearch-Container{height:100vh;height:-webkit-fill-available;height:calc(var(--docsearch-vh,1vh)*100);position:absolute}.DocSearch-Footer{border-radius:0;bottom:0;position:absolute}.DocSearch-Hit-content-wrapper{display:flex;position:relative;width:80%}.DocSearch-Modal{border-radius:0;box-shadow:none;height:100vh;height:-webkit-fill-available;height:calc(var(--docsearch-vh,1vh)*100);margin:0;max-width:100%;width:100%}.DocSearch-Cancel{-webkit-appearance:none;-moz-appearance:none;appearance:none;background:none;border:0;color:var(--docsearch-highlight-color);cursor:pointer;display:inline-block;flex:none;font:inherit;font-size:1em;font-weight:500;margin-left:var(--docsearch-spacing);outline:0;overflow:hidden;padding:0;-webkit-user-select:none;-moz-user-select:none;user-select:none;white-space:nowrap}}@media only screen and (max-width:750px){.DocSearch.DocSearch-Button{width:38px}}@media (max-width:576px){.markdown h1:first-child{--ifm-h1-font-size:2rem}.markdown>h2{--ifm-h2-font-size:1.5rem}.markdown>h3{--ifm-h3-font-size:1.25rem}}@media screen and (max-width:576px){.searchQueryColumn_RTkw{max-width:100%!important}.searchVersionColumn_ypXd{max-width:100%!important;padding-left:var(--ifm-spacing-horizontal)!important}}@media (hover:hover){.backToTopButton_sjWU:hover{background-color:var(--ifm-color-emphasis-300)}}@media (pointer:fine){.thin-scrollbar{scrollbar-width:thin}.thin-scrollbar::-webkit-scrollbar{height:var(--ifm-scrollbar-size);width:var(--ifm-scrollbar-size)}.thin-scrollbar::-webkit-scrollbar-track{background:var(--ifm-scrollbar-track-background-color);border-radius:10px}.thin-scrollbar::-webkit-scrollbar-thumb{background:var(--ifm-scrollbar-thumb-background-color);border-radius:10px}.thin-scrollbar::-webkit-scrollbar-thumb:hover{background:var(--ifm-scrollbar-thumb-hover-background-color)}}@media (prefers-reduced-motion:reduce){:root{--ifm-transition-fast:0ms;--ifm-transition-slow:0ms}}@media screen and (prefers-reduced-motion:reduce){.DocSearch-Reset{stroke-width:var(--docsearch-icon-stroke-width);animation:none;-webkit-appearance:none;-moz-appearance:none;appearance:none;background:none;border:0;border-radius:50%;color:var(--docsearch-icon-color);cursor:pointer;right:0}.DocSearch-Hit--deleting,.DocSearch-Hit--favoriting{transition:none}.DocSearch-Hit-action-button:focus,.DocSearch-Hit-action-button:hover{background:rgba(0,0,0,.2);transition:none}}@media print{.announcementBar_mb4j,.footer,.menu,.navbar,.pagination-nav,.table-of-contents,.tocMobile_ITEo{display:none}.tabs{page-break-inside:avoid}.codeBlockLines_e6Vv{white-space:pre-wrap}} \ No newline at end of file diff --git a/assets/images/async-backing-allow-multiple-12827c5ae8be763b2b2ec5b16ba59ece.png b/assets/images/async-backing-allow-multiple-12827c5ae8be763b2b2ec5b16ba59ece.png deleted file mode 100644 index cee6bcc9e209..000000000000 Binary files a/assets/images/async-backing-allow-multiple-12827c5ae8be763b2b2ec5b16ba59ece.png and /dev/null differ diff --git a/assets/images/async-backing-associated-relay-57246a3cb56d0030314ca79fef4b9ce0.png b/assets/images/async-backing-associated-relay-57246a3cb56d0030314ca79fef4b9ce0.png deleted file mode 100644 index 1cbda22edea5..000000000000 Binary files a/assets/images/async-backing-associated-relay-57246a3cb56d0030314ca79fef4b9ce0.png and /dev/null differ diff --git a/assets/images/async-backing-aura-api-32badf8707637f9b9b344d42c7056132.png b/assets/images/async-backing-aura-api-32badf8707637f9b9b344d42c7056132.png deleted file mode 100644 index 92fc2877bc5a..000000000000 Binary files a/assets/images/async-backing-aura-api-32badf8707637f9b9b344d42c7056132.png and /dev/null differ diff --git a/assets/images/async-backing-aura-params-b3ddee0fd3fdb97a624bbfe6aba4a1c2.png b/assets/images/async-backing-aura-params-b3ddee0fd3fdb97a624bbfe6aba4a1c2.png deleted file mode 100644 index 50e4236bcfc5..000000000000 Binary files a/assets/images/async-backing-aura-params-b3ddee0fd3fdb97a624bbfe6aba4a1c2.png and /dev/null differ diff --git a/assets/images/async-backing-aura-run-12845909492ef12ee7c65b411f2eb21c.png b/assets/images/async-backing-aura-run-12845909492ef12ee7c65b411f2eb21c.png deleted file mode 100644 index b60c347d050e..000000000000 Binary files a/assets/images/async-backing-aura-run-12845909492ef12ee7c65b411f2eb21c.png and /dev/null differ diff --git a/assets/images/async-backing-block-time-f377d59fc54bd7da4bc40ffda9a5bb42.png b/assets/images/async-backing-block-time-f377d59fc54bd7da4bc40ffda9a5bb42.png deleted file mode 100644 index 171694548e3b..000000000000 Binary files a/assets/images/async-backing-block-time-f377d59fc54bd7da4bc40ffda9a5bb42.png and /dev/null differ diff --git a/assets/images/async-backing-capacity-velocity-284086ee80ed6f362605da2861982fd4.png b/assets/images/async-backing-capacity-velocity-284086ee80ed6f362605da2861982fd4.png deleted file mode 100644 index 348905cb9a9c..000000000000 Binary files a/assets/images/async-backing-capacity-velocity-284086ee80ed6f362605da2861982fd4.png and /dev/null differ diff --git a/assets/images/async-backing-cargo-7a4e51836905ddfd6166d0c6585c8547.png b/assets/images/async-backing-cargo-7a4e51836905ddfd6166d0c6585c8547.png deleted file mode 100644 index 8ed3909d04a6..000000000000 Binary files a/assets/images/async-backing-cargo-7a4e51836905ddfd6166d0c6585c8547.png and /dev/null differ diff --git a/assets/images/async-backing-config-aura-78aaaceb60b158603d2536d22987de34.png b/assets/images/async-backing-config-aura-78aaaceb60b158603d2536d22987de34.png deleted file mode 100644 index 416b431f8e98..000000000000 Binary files a/assets/images/async-backing-config-aura-78aaaceb60b158603d2536d22987de34.png and /dev/null differ diff --git a/assets/images/async-backing-consensus-hook-d0b32b28cfd96c484bdbd33d3021469d.png b/assets/images/async-backing-consensus-hook-d0b32b28cfd96c484bdbd33d3021469d.png deleted file mode 100644 index 2a08438d389f..000000000000 Binary files a/assets/images/async-backing-consensus-hook-d0b32b28cfd96c484bdbd33d3021469d.png and /dev/null differ diff --git a/assets/images/async-backing-cumulus-primitives-1f9fdc12cf1dff0f1d180857797034ef.png b/assets/images/async-backing-cumulus-primitives-1f9fdc12cf1dff0f1d180857797034ef.png deleted file mode 100644 index 49596a7e02a4..000000000000 Binary files a/assets/images/async-backing-cumulus-primitives-1f9fdc12cf1dff0f1d180857797034ef.png and /dev/null differ diff --git a/assets/images/async-backing-lookahead-collator-c0ddf4595a07a3519a9f3ce39291b85b.png b/assets/images/async-backing-lookahead-collator-c0ddf4595a07a3519a9f3ce39291b85b.png deleted file mode 100644 index 570329c2a803..000000000000 Binary files a/assets/images/async-backing-lookahead-collator-c0ddf4595a07a3519a9f3ce39291b85b.png and /dev/null differ diff --git a/assets/images/async-backing-maxblock-weight-4a93f8ba093eb551f53beca9ae26940e.png b/assets/images/async-backing-maxblock-weight-4a93f8ba093eb551f53beca9ae26940e.png deleted file mode 100644 index 9796ff62dc4e..000000000000 Binary files a/assets/images/async-backing-maxblock-weight-4a93f8ba093eb551f53beca9ae26940e.png and /dev/null differ diff --git a/assets/images/async-backing-minimum-period-7ff2737538315419ff89dc7af0ce774a.png b/assets/images/async-backing-minimum-period-7ff2737538315419ff89dc7af0ce774a.png deleted file mode 100644 index ff87ceefc33c..000000000000 Binary files a/assets/images/async-backing-minimum-period-7ff2737538315419ff89dc7af0ce774a.png and /dev/null differ diff --git a/assets/images/async-backing-register-validate-d2b309bef0cf424dc03ec58bbe4b329c.png b/assets/images/async-backing-register-validate-d2b309bef0cf424dc03ec58bbe4b329c.png deleted file mode 100644 index 050c37e258b1..000000000000 Binary files a/assets/images/async-backing-register-validate-d2b309bef0cf424dc03ec58bbe4b329c.png and /dev/null differ diff --git a/assets/images/async-backing-slot-duration-8ae26819c2ecff7ebde87441782c315c.png b/assets/images/async-backing-slot-duration-8ae26819c2ecff7ebde87441782c315c.png deleted file mode 100644 index c2223b6fb09b..000000000000 Binary files a/assets/images/async-backing-slot-duration-8ae26819c2ecff7ebde87441782c315c.png and /dev/null differ diff --git a/assets/images/async-backing-spawn-tasks-e5041596b06c8c23c0e3b33f5cd0556d.png b/assets/images/async-backing-spawn-tasks-e5041596b06c8c23c0e3b33f5cd0556d.png deleted file mode 100644 index 8399a99c83c0..000000000000 Binary files a/assets/images/async-backing-spawn-tasks-e5041596b06c8c23c0e3b33f5cd0556d.png and /dev/null differ diff --git a/assets/images/async-backing-start-consensus-2-6a192785fc1b07d8ca69653c4a630824.png b/assets/images/async-backing-start-consensus-2-6a192785fc1b07d8ca69653c4a630824.png deleted file mode 100644 index 6f9098d88d2d..000000000000 Binary files a/assets/images/async-backing-start-consensus-2-6a192785fc1b07d8ca69653c4a630824.png and /dev/null differ diff --git a/assets/images/async-backing-start-consensus-623d270ec4a847084f8b9f7c338ad347.png b/assets/images/async-backing-start-consensus-623d270ec4a847084f8b9f7c338ad347.png deleted file mode 100644 index 9feadd3443ed..000000000000 Binary files a/assets/images/async-backing-start-consensus-623d270ec4a847084f8b9f7c338ad347.png and /dev/null differ diff --git a/assets/images/async-backing-unincluded-segment-a7371567ff6508ab3a59ed1b54bb28f0.png b/assets/images/async-backing-unincluded-segment-a7371567ff6508ab3a59ed1b54bb28f0.png deleted file mode 100644 index 5c236e334980..000000000000 Binary files a/assets/images/async-backing-unincluded-segment-a7371567ff6508ab3a59ed1b54bb28f0.png and /dev/null differ diff --git a/assets/images/async-backing-unincluded-segment-capacity-01035865c97ed701f209ff3869776d8a.png b/assets/images/async-backing-unincluded-segment-capacity-01035865c97ed701f209ff3869776d8a.png deleted file mode 100644 index 8398548e08ba..000000000000 Binary files a/assets/images/async-backing-unincluded-segment-capacity-01035865c97ed701f209ff3869776d8a.png and /dev/null differ diff --git a/assets/js/3d1bf5db.854dcdf2.js b/assets/js/3d1bf5db.854dcdf2.js new file mode 100644 index 000000000000..01762b9e7086 --- /dev/null +++ b/assets/js/3d1bf5db.854dcdf2.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunk=self.webpackChunk||[]).push([[3452],{3905:(e,a,n)=>{n.d(a,{Zo:()=>p,kt:()=>h});var t=n(67294);function i(e,a,n){return a in e?Object.defineProperty(e,a,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[a]=n,e}function r(e,a){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var t=Object.getOwnPropertySymbols(e);a&&(t=t.filter((function(a){return Object.getOwnPropertyDescriptor(e,a).enumerable}))),n.push.apply(n,t)}return n}function l(e){for(var a=1;a=0||(i[n]=e[n]);return i}(e,a);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);for(t=0;t=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(i[n]=e[n])}return i}var s=t.createContext({}),c=function(e){var a=t.useContext(s),n=a;return e&&(n="function"==typeof e?e(a):l(l({},a),e)),n},p=function(e){var a=c(e.components);return t.createElement(s.Provider,{value:a},e.children)},u="mdxType",m={inlineCode:"code",wrapper:function(e){var a=e.children;return t.createElement(t.Fragment,{},a)}},d=t.forwardRef((function(e,a){var n=e.components,i=e.mdxType,r=e.originalType,s=e.parentName,p=o(e,["components","mdxType","originalType","parentName"]),u=c(n),d=i,h=u["".concat(s,".").concat(d)]||u[d]||m[d]||r;return n?t.createElement(h,l(l({ref:a},p),{},{components:n})):t.createElement(h,l({ref:a},p))}));function h(e,a){var n=arguments,i=a&&a.mdxType;if("string"==typeof e||i){var r=n.length,l=new Array(r);l[0]=d;var o={};for(var s in a)hasOwnProperty.call(a,s)&&(o[s]=a[s]);o.originalType=e,o[u]="string"==typeof e?e:i,l[1]=o;for(var c=2;c{n.r(a),n.d(a,{assets:()=>p,contentTitle:()=>s,default:()=>h,frontMatter:()=>o,metadata:()=>c,toc:()=>u});var t=n(87462),i=n(63366),r=(n(67294),n(3905)),l=["components"],o={id:"maintain-guides-async-backing",title:"Upgrade Parachain for Asynchronous Backing Compatibility",sidebar_label:"Async Backing Upgrade",description:"Steps on how to upgrade a parachain to be compatible with the relay chain's async backing feature.",keywords:["async","backing","parachain","consensus"],slug:"../maintain-guides-async-backing"},s=void 0,c={unversionedId:"maintain/maintain-guides-async-backing",id:"maintain/maintain-guides-async-backing",title:"Upgrade Parachain for Asynchronous Backing Compatibility",description:"Steps on how to upgrade a parachain to be compatible with the relay chain's async backing feature.",source:"@site/../docs/maintain/maintain-guides-async-backing.md",sourceDirName:"maintain",slug:"/maintain-guides-async-backing",permalink:"/docs/maintain-guides-async-backing",draft:!1,editUrl:"https://github.com/w3f/polkadot-wiki/edit/master/docs/maintain/maintain-guides-async-backing.md",tags:[],version:"current",lastUpdatedBy:"Sebastian Kunert",lastUpdatedAt:1708102980,formattedLastUpdatedAt:"Feb 16, 2024",frontMatter:{id:"maintain-guides-async-backing",title:"Upgrade Parachain for Asynchronous Backing Compatibility",sidebar_label:"Async Backing Upgrade",description:"Steps on how to upgrade a parachain to be compatible with the relay chain's async backing feature.",keywords:["async","backing","parachain","consensus"],slug:"../maintain-guides-async-backing"},sidebar:"docs",previous:{title:"Node Endpoints",permalink:"/docs/maintain-endpoints"},next:{title:"Set up a Full Node",permalink:"/docs/maintain-sync"}},p={},u=[{value:"Async Backing Prerequisites",id:"async-backing-prerequisites",level:2},{value:"Async Backing Terminology and Parameters",id:"async-backing-terminology-and-parameters",level:2},{value:"Prerequisite",id:"prerequisite",level:2},{value:"Phase 1 - Update Parachain Runtime",id:"phase-1---update-parachain-runtime",level:2},{value:"Phase 2 - Update Parachain Nodes",id:"phase-2---update-parachain-nodes",level:2},{value:"Phase 3 - Activate Async Backing",id:"phase-3---activate-async-backing",level:2},{value:"Timing by Block Number",id:"timing-by-block-number",level:2}],m={toc:u},d="wrapper";function h(e){var a=e.components,n=(0,i.Z)(e,l);return(0,r.kt)(d,(0,t.Z)({},m,n,{components:a,mdxType:"MDXLayout"}),(0,r.kt)("admonition",{title:"Who is this guide for?",type:"info"},(0,r.kt)("p",{parentName:"admonition"},"This guide is relevant for cumulus based parachain projects started in 2023 or before. Later\nprojects should already be async backing compatible. If starting a new parachain project, please use\nan async backing compatible template such as\n",(0,r.kt)("a",{parentName:"p",href:"https://github.com/paritytech/polkadot-sdk/tree/master/cumulus/parachain-template"},(0,r.kt)("inlineCode",{parentName:"a"},"cumulus/parachain-template")),".")),(0,r.kt)("p",null,"The rollout process for Async Backing has three phases. Phases 1 and 2 below put new infrastructure\nin place. Then we can simply turn on async backing in phase 3. But first, some pre-reqs and context\nto set the stage."),(0,r.kt)("h2",{id:"async-backing-prerequisites"},"Async Backing Prerequisites"),(0,r.kt)("admonition",{type:"info"},(0,r.kt)("p",{parentName:"admonition"},"For more contextual information about asynchronous backing, see\n",(0,r.kt)("a",{parentName:"p",href:"/docs/learn-async-backing"},"this page"),".")),(0,r.kt)("p",null,"Pull the latest version of Cumulus for use with your parachain. It contains necessary changes for\nasync backing compatibility. Latest on master branch of\n",(0,r.kt)("a",{parentName:"p",href:"https://github.com/paritytech/polkadot-sdk"},"Polkadot-SDK")," is currently sufficient. Any 2024 release\nwill work as well."),(0,r.kt)("h2",{id:"async-backing-terminology-and-parameters"},"Async Backing Terminology and Parameters"),(0,r.kt)("p",null,"Time for a bit of context before we get started. The following concepts will aid in demystifying the\ncollator side of Async Backing and establish a basic understanding of the changes being made:"),(0,r.kt)("ul",null,(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("strong",{parentName:"li"},"Unincluded segment")," - From the perspective of a parachain block under construction, the\nunincluded segment describes a chain of recent block ancestors which have yet to be included on\nthe relay chain. The ability to build new blocks on top of the unincluded segment rather than on\ntop of blocks freshly included in the relay chain is the core of asynchronous backing."),(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("strong",{parentName:"li"},"Capacity")," - The maximum size of the unincluded segment. The longer this is, the farther ahead a\nparachain can work, producing new candidates before the ancestors of those candidates have been\nseen as included on-chain. Practically, a capacity of 2-3 is sufficient to realize the full\nbenefits of asynchronous backing, at least until the release of elastic scaling."),(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("strong",{parentName:"li"},"Velocity")," - The base rate at which a parachain should produce blocks. A velocity of 1 indicates\nthat 1 parachain block should be produced per relay chain block. In order to fill the unincluded\nsegment with candidates, collators may build up to ",(0,r.kt)("inlineCode",{parentName:"li"},"Velocity + 1")," candidates per aura slot while\nthere is remaining capacity. When elastic scaling has been released velocities greater than 1 will\nbe supported."),(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("strong",{parentName:"li"},"AllowMultipleBlocksPerSlot")," - If this is ",(0,r.kt)("inlineCode",{parentName:"li"},"true"),", Aura will allow slots to stay the same across\nsequential parablocks. Otherwise the slot number must increase with each block. To fill the\nunincluded segment as described above we need this to be ",(0,r.kt)("inlineCode",{parentName:"li"},"true"),"."),(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("strong",{parentName:"li"},"FixedVelocityConsensusHook")," - This is a variety of ",(0,r.kt)("inlineCode",{parentName:"li"},"ConsensusHook")," intended to be passed to\n",(0,r.kt)("inlineCode",{parentName:"li"},"parachain-system")," as part of its ",(0,r.kt)("inlineCode",{parentName:"li"},"Config"),". It is triggered on initialization of a new runtime. An\ninstance of ",(0,r.kt)("inlineCode",{parentName:"li"},"FixedVelocityConsensusHook")," is defined with both a fixed capacity and velocity. It\naborts the runtime early if either capacity or velocity is exceeded, as the collator shouldn\u2019t be\ncreating additional blocks in that case."),(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("strong",{parentName:"li"},"AsyncBackingParams.max_candidate_depth")," - This parameter determines the maximum unincluded\nsegment depth the relay chain will support. Candidates sent to validators which exceed\n",(0,r.kt)("inlineCode",{parentName:"li"},"max_candidate_depth")," will be ignored. ",(0,r.kt)("inlineCode",{parentName:"li"},"Capacity"),", as mentioned above, should not exceed\n",(0,r.kt)("inlineCode",{parentName:"li"},"max_candidate_depth"),"."),(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("strong",{parentName:"li"},"AsyncBackingParams.allowed_ancestry_len")," - Each parachain block candidate has a ",(0,r.kt)("inlineCode",{parentName:"li"},"relay_parent"),"\nfrom which its execution and validation context is derived. Before async backing the\n",(0,r.kt)("inlineCode",{parentName:"li"},"relay_parent")," for a candidate not yet backed was required to be the fresh head of a fork. With\nasync backing we can relax this requirement. Instead we set a conservative maximum age in blocks\nfor the ",(0,r.kt)("inlineCode",{parentName:"li"},"relay_parent"),"s of candidates in the unincluded segment. This age, ",(0,r.kt)("inlineCode",{parentName:"li"},"allowed_ancestry_len"),"\nlives on the relay chain and is queried by parachains when deciding which block to build on top\nof."),(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("strong",{parentName:"li"},"Lookahead Collator")," - A collator for Aura that looks ahead of the most recently included\nparachain block when determining what to build upon. This collator also builds additional blocks\nwhen the maximum backlog is not saturated. The size of the backlog is determined by invoking the\nAuraUnincludedSegmentApi. If that runtime API is not supported, this assumes a maximum backlog\nsize of 1.")),(0,r.kt)("h2",{id:"prerequisite"},"Prerequisite"),(0,r.kt)("p",null,"The relay chain needs to have async backing enabled so double-check that the relay-chain\nconfiguration contains the following three parameters (especially when testing locally e.g. with\nzombienet):"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-json"},'"async_backing_params": {\n "max_candidate_depth": 3,\n "allowed_ancestry_len": 2\n},\n"scheduling_lookahead": 2\n')),(0,r.kt)("admonition",{title:"warning ",type:"warning"},(0,r.kt)("p",{parentName:"admonition"},(0,r.kt)("inlineCode",{parentName:"p"},"scheduling_lookahead")," must be set to 2, otherwise parachain block times will\ndegrade to worse than with sync backing!")),(0,r.kt)("h2",{id:"phase-1---update-parachain-runtime"},"Phase 1 - Update Parachain Runtime"),(0,r.kt)("p",null,"This phase involves configuring your parachain\u2019s runtime to make use of async backing system."),(0,r.kt)("ol",null,(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("p",{parentName:"li"},"Establish constants for ",(0,r.kt)("inlineCode",{parentName:"p"},"capacity")," and ",(0,r.kt)("inlineCode",{parentName:"p"},"velocity")," and set both of them to 1 in\n",(0,r.kt)("inlineCode",{parentName:"p"},"/runtime/src/lib.rs"),".")),(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("p",{parentName:"li"},"Establish a constant relay chain slot duration measured in milliseconds equal to ",(0,r.kt)("inlineCode",{parentName:"p"},"6000")," in\n",(0,r.kt)("inlineCode",{parentName:"p"},"/runtime/src/lib.rs"),"."),(0,r.kt)("pre",{parentName:"li"},(0,r.kt)("code",{parentName:"pre",className:"language-rust"},"/// Maximum number of blocks simultaneously accepted by the Runtime, not yet included into the\n/// relay chain.\npub const UNINCLUDED_SEGMENT_CAPACITY: u32 = 1;\n/// How many parachain blocks are processed by the relay chain per parent. Limits the number of\n/// blocks authored per slot.\npub const BLOCK_PROCESSING_VELOCITY: u32 = 1;\n/// Relay chain slot duration, in milliseconds.\npub const RELAY_CHAIN_SLOT_DURATION_MILLIS: u32 = 6000;\n"))),(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("p",{parentName:"li"},"Establish constants ",(0,r.kt)("inlineCode",{parentName:"p"},"MILLISECS_PER_BLOCK")," and ",(0,r.kt)("inlineCode",{parentName:"p"},"SLOT_DURATION")," if not already present in\n",(0,r.kt)("inlineCode",{parentName:"p"},"/runtime/src/lib.rs"),"."),(0,r.kt)("pre",{parentName:"li"},(0,r.kt)("code",{parentName:"pre",className:"language-rust"},"\n/// BLOCKSkkhasd will be produced at a minimum duration defined by `SLOT_DURATION`.\n/// `SLOT_DURATION` is picked up by `pallet_timestamp` which is in turn picked\n/// up by `pallet_aura` to implement `fn slot_duration()`.\n///\n/// Change this to adjust the block time.\npub const MILLISECS_PER_BLOCK: u64 = 12000;\npub const SLOT_DURATION: u64 = MILLISECS_PER_BLOCK;\n"))),(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("p",{parentName:"li"},"Configure ",(0,r.kt)("inlineCode",{parentName:"p"},"cumulus_pallet_parachain_system")," in ",(0,r.kt)("inlineCode",{parentName:"p"},"runtime/src/lib.rs")),(0,r.kt)("ul",{parentName:"li"},(0,r.kt)("li",{parentName:"ul"},"Define a ",(0,r.kt)("inlineCode",{parentName:"li"},"FixedVelocityConsensusHook")," using our capacity, velocity, and relay slot duration\nconstants. Use this to set the parachain system ",(0,r.kt)("inlineCode",{parentName:"li"},"ConsensusHook")," property.")),(0,r.kt)("pre",{parentName:"li"},(0,r.kt)("code",{parentName:"pre",className:"language-rust"},"impl cumulus_pallet_parachain_system::Config for Runtime {\n type RuntimeEvent = RuntimeEvent;\n type OnSystemEvent = ();\n type SelfParaId = parachain_info::Pallet;\n type OutboundXcmpMessageSource = XcmpQueue;\n type DmpQueue = frame_support::traits::EnqueueWithOrigin;\n type ReservedDmpWeight = ReservedDmpWeight;\n type XcmpMessageHandler = XcmpQueue;\n type ReservedXcmpWeight = ReservedXcmpWeight;\n type CheckAssociatedRelayNumber = RelayNumberMonotonicallyIncreases;\n // highlight-next-line\n type ConsensusHook = ConsensusHook;\n type WeightInfo = weights::cumulus_pallet_parachain_system::WeightInfo;\n}\n// highlight-start\ntype ConsensusHook = cumulus_pallet_aura_ext::FixedVelocityConsensusHook<\n Runtime,\n RELAY_CHAIN_SLOT_DURATION_MILLIS,\n BLOCK_PROCESSING_VELOCITY,\n UNINCLUDED_SEGMENT_CAPACITY,\n>;\n// highlight-end\n")),(0,r.kt)("ul",{parentName:"li"},(0,r.kt)("li",{parentName:"ul"},"Set the parachain system property ",(0,r.kt)("inlineCode",{parentName:"li"},"CheckAssociatedRelayNumber")," to\n",(0,r.kt)("inlineCode",{parentName:"li"},"RelayNumberMonotonicallyIncreases"))),(0,r.kt)("pre",{parentName:"li"},(0,r.kt)("code",{parentName:"pre",className:"language-rust"},"impl cumulus_pallet_parachain_system::Config for Runtime {\n type RuntimeEvent = RuntimeEvent;\n type OnSystemEvent = ();\n type SelfParaId = parachain_info::Pallet;\n type OutboundXcmpMessageSource = XcmpQueue;\n type DmpQueue = frame_support::traits::EnqueueWithOrigin;\n type ReservedDmpWeight = ReservedDmpWeight;\n type XcmpMessageHandler = XcmpQueue;\n type ReservedXcmpWeight = ReservedXcmpWeight;\n // highlight-next-line\n type CheckAssociatedRelayNumber = RelayNumberMonotonicallyIncreases;\n type ConsensusHook = ConsensusHook;\n type WeightInfo = weights::cumulus_pallet_parachain_system::WeightInfo;\n}\ntype ConsensusHook = cumulus_pallet_aura_ext::FixedVelocityConsensusHook<\n Runtime,\n RELAY_CHAIN_SLOT_DURATION_MILLIS,\n BLOCK_PROCESSING_VELOCITY,\n UNINCLUDED_SEGMENT_CAPACITY,\n>;\n"))),(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("p",{parentName:"li"},"Configure ",(0,r.kt)("inlineCode",{parentName:"p"},"pallet_aura")," in ",(0,r.kt)("inlineCode",{parentName:"p"},"runtime/src/lib.rs")),(0,r.kt)("ul",{parentName:"li"},(0,r.kt)("li",{parentName:"ul"},"Set ",(0,r.kt)("inlineCode",{parentName:"li"},"AllowMultipleBlocksPerSlot")," to ",(0,r.kt)("inlineCode",{parentName:"li"},"false")," (don't worry, we will set it to ",(0,r.kt)("inlineCode",{parentName:"li"},"true")," when we\nactivate async backing in phase 3)."),(0,r.kt)("li",{parentName:"ul"},"Define ",(0,r.kt)("inlineCode",{parentName:"li"},"pallet_aura::SlotDuration")," using our constant ",(0,r.kt)("inlineCode",{parentName:"li"},"SLOT_DURATION"))),(0,r.kt)("pre",{parentName:"li"},(0,r.kt)("code",{parentName:"pre",className:"language-rust"},'impl pallet_aura::Config for Runtime {\n type AuthorityId = AuraId;\n type DisabledValidators = ();\n type MaxAuthorities = ConstU32<100_000>;\n // highlight-start\n type AllowMultipleBlocksPerSlot = ConstBool;\n #[cfg(feature = "experimental")]\n type SlotDuration = ConstU64;\n // highlight-end\n}\n'))),(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("p",{parentName:"li"},"Update ",(0,r.kt)("inlineCode",{parentName:"p"},"aura_api::SlotDuration()")," to match the constant ",(0,r.kt)("inlineCode",{parentName:"p"},"SLOT_DURATION")),(0,r.kt)("pre",{parentName:"li"},(0,r.kt)("code",{parentName:"pre",className:"language-rust"},"impl_runtime_apis! {\n impl sp_consensus_aura::AuraApi for Runtime {\n fn slot_duration() -> sp_consensus_aura::SlotDuration {\n // highlight-next-line\n sp_consensus_aura::SlotDuration::from_millis(SLOT_DURATION)\n }\n\n fn authorities() -> Vec {\n Aura::authorities().into_inner()\n }\n }\n...\n"))),(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("p",{parentName:"li"},"Implement the ",(0,r.kt)("inlineCode",{parentName:"p"},"AuraUnincludedSegmentApi"),", which allows the collator client to query its runtime\nto determine whether it should author a block."),(0,r.kt)("ul",{parentName:"li"},(0,r.kt)("li",{parentName:"ul"},"Add the dependency ",(0,r.kt)("inlineCode",{parentName:"li"},"cumulus-primitives-aura")," to the ",(0,r.kt)("inlineCode",{parentName:"li"},"runtime/Cargo.toml")," file for your runtime")))),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-rust"},'cumulus-pallet-aura-ext = { path = "../../../../pallets/aura-ext", default-features = false }\ncumulus-pallet-parachain-system = { path = "../../../../pallets/parachain-system", default-features = false, features = ["parameterized-consensus-hook"] }\ncumulus-pallet-session-benchmarking = { path = "../../../../pallets/session-benchmarking", default-features = false }\ncumulus-pallet-xcm = { path = "../../../../pallets/xcm", default-features = false }\ncumulus-pallet-xcmp-queue = { path = "../../../../pallets/xcmp-queue", default-features = false, features = ["bridging"] }\n// highlight-next-line\ncumulus-primitives-aura = { path = "../../../../primitives/aura", default-features = false }\n')),(0,r.kt)("ul",null,(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("p",{parentName:"li"},"In the same file, add ",(0,r.kt)("inlineCode",{parentName:"p"},'"cumulus-primitives-aura/std",')," to the ",(0,r.kt)("inlineCode",{parentName:"p"},"std")," feature.")),(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("p",{parentName:"li"},"Inside the ",(0,r.kt)("inlineCode",{parentName:"p"},"impl_runtime_apis!")," block for your runtime, implement the ",(0,r.kt)("inlineCode",{parentName:"p"},"AuraUnincludedSegmentApi"),"\nas shown below."))),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-rust"},"impl cumulus_primitives_aura::AuraUnincludedSegmentApi for Runtime {\n fn can_build_upon(\n included_hash: ::Hash,\n slot: cumulus_primitives_aura::Slot,\n ) -> bool {\n ConsensusHook::can_build_upon(included_hash, slot)\n }\n}\n")),(0,r.kt)("p",null,(0,r.kt)("strong",{parentName:"p"},"Note:")," With a capacity of 1 we have an effective velocity of \xbd even when velocity is configured\nto some larger value. This is because capacity will be filled after a single block is produced and\nwill only be freed up after that block is included on the relay chain, which takes 2 relay blocks to\naccomplish. Thus with capacity 1 and velocity 1 we get the customary 12 second parachain block time."),(0,r.kt)("ol",{start:8},(0,r.kt)("li",{parentName:"ol"},"If your ",(0,r.kt)("inlineCode",{parentName:"li"},"runtime/src/lib.rs")," provides a ",(0,r.kt)("inlineCode",{parentName:"li"},"CheckInherents")," type to ",(0,r.kt)("inlineCode",{parentName:"li"},"register_validate_block"),",\nremove it. ",(0,r.kt)("inlineCode",{parentName:"li"},"FixedVelocityConsensusHook")," makes it unnecessary. The following example shows how\n",(0,r.kt)("inlineCode",{parentName:"li"},"register_validate_block")," should look after removing ",(0,r.kt)("inlineCode",{parentName:"li"},"CheckInherents"),".")),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-rust"},"cumulus_pallet_parachain_system::register_validate_block! {\n Runtime = Runtime,\n BlockExecutor = cumulus_pallet_aura_ext::BlockExecutor::,\n}\n")),(0,r.kt)("h2",{id:"phase-2---update-parachain-nodes"},"Phase 2 - Update Parachain Nodes"),(0,r.kt)("p",null,"This phase consists of plugging in the new lookahead collator node."),(0,r.kt)("ol",null,(0,r.kt)("li",{parentName:"ol"},"Import ",(0,r.kt)("inlineCode",{parentName:"li"},"cumulus_primitives_core::ValidationCode")," to ",(0,r.kt)("inlineCode",{parentName:"li"},"node/src/service.rs"))),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-rust"},"use cumulus_primitives_core::{\n// highlight-next-line\n relay_chain::{CollatorPair, ValidationCode},\n ParaId,\n};\n")),(0,r.kt)("ol",{start:2},(0,r.kt)("li",{parentName:"ol"},"In ",(0,r.kt)("inlineCode",{parentName:"li"},"node/src/service.rs"),", modify ",(0,r.kt)("inlineCode",{parentName:"li"},"sc_service::spawn_tasks")," to use a clone of ",(0,r.kt)("inlineCode",{parentName:"li"},"Backend")," rather\nthan the original")),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-rust"},"sc_service::spawn_tasks(sc_service::SpawnTasksParams {\n rpc_builder,\n client: client.clone(),\n transaction_pool: transaction_pool.clone(),\n task_manager: &mut task_manager,\n config: parachain_config,\n keystore: params.keystore_container.keystore(),\n // highlight-next-line\n backend: backend.clone(),\n network: network.clone(),\n sync_service: sync_service.clone(),\n system_rpc_tx,\n tx_handler_controller,\n telemetry: telemetry.as_mut(),\n})?;\n")),(0,r.kt)("ol",{start:3},(0,r.kt)("li",{parentName:"ol"},"Add ",(0,r.kt)("inlineCode",{parentName:"li"},"backend")," as a parameter to ",(0,r.kt)("inlineCode",{parentName:"li"},"start_consensus()")," in ",(0,r.kt)("inlineCode",{parentName:"li"},"node/src/service.rs"))),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-rust"},"fn start_consensus(\n client: Arc,\n // highlight-next-line\n backend: Arc,\n block_import: ParachainBlockImport,\n prometheus_registry: Option<&Registry>,\n telemetry: Option,\n task_manager: &TaskManager,\n")),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-rust"},"if validator {\n start_consensus(\n client.clone(),\n // highlight-next-line\n backend.clone(),\n block_import,\n prometheus_registry.as_ref(),\n")),(0,r.kt)("ol",{start:4},(0,r.kt)("li",{parentName:"ol"},"In ",(0,r.kt)("inlineCode",{parentName:"li"},"node/src/service.rs")," import the lookahead collator rather than the basic collator")),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-rust"},"use cumulus_client_consensus_aura::collators::lookahead::{self as aura, Params as AuraParams};\n")),(0,r.kt)("ol",{start:5},(0,r.kt)("li",{parentName:"ol"},"In ",(0,r.kt)("inlineCode",{parentName:"li"},"start_consensus()")," replace the ",(0,r.kt)("inlineCode",{parentName:"li"},"BasicAuraParams")," struct with ",(0,r.kt)("inlineCode",{parentName:"li"},"AuraParams"),(0,r.kt)("ul",{parentName:"li"},(0,r.kt)("li",{parentName:"ul"},"Change the struct type from ",(0,r.kt)("inlineCode",{parentName:"li"},"BasicAuraParams")," to ",(0,r.kt)("inlineCode",{parentName:"li"},"AuraParams")),(0,r.kt)("li",{parentName:"ul"},"In the ",(0,r.kt)("inlineCode",{parentName:"li"},"para_client")," field, pass in a cloned para client rather than the original"),(0,r.kt)("li",{parentName:"ul"},"Add a ",(0,r.kt)("inlineCode",{parentName:"li"},"para_backend")," parameter after ",(0,r.kt)("inlineCode",{parentName:"li"},"para_client"),", passing in our para backend"),(0,r.kt)("li",{parentName:"ul"},"Provide a ",(0,r.kt)("inlineCode",{parentName:"li"},"code_hash_provider")," closure like that shown below"),(0,r.kt)("li",{parentName:"ul"},"Increase ",(0,r.kt)("inlineCode",{parentName:"li"},"authoring_duration")," from 500 milliseconds to 1500")))),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-rust"},"let params = AuraParams {\n create_inherent_data_providers: move |_, ()| async move { Ok(()) },\n block_import,\n para_client: client.clone(),\n para_backend: backend.clone(),\n relay_client: relay_chain_interface,\n code_hash_provider: move |block_hash| {\n client.code_at(block_hash).ok().map(|c| ValidationCode::from(c).hash())\n },\n sync_oracle,\n keystore,\n collator_key,\n para_id,\n overseer_handle,\n relay_chain_slot_duration,\n proposer,\n collator_service,\n // highlight-next-line\n authoring_duration: Duration::from_millis(1500),\n reinitialize: false,\n};\n")),(0,r.kt)("p",null,(0,r.kt)("strong",{parentName:"p"},"Note:")," Set ",(0,r.kt)("inlineCode",{parentName:"p"},"authoring_duration")," to whatever you want, taking your own hardware into account. But\nif the backer who should be slower than you due to reading from disk, times out at two seconds your\ncandidates will be rejected."),(0,r.kt)("ol",{start:6},(0,r.kt)("li",{parentName:"ol"},"In ",(0,r.kt)("inlineCode",{parentName:"li"},"start_consensus()")," replace ",(0,r.kt)("inlineCode",{parentName:"li"},"basic_aura::run")," with ",(0,r.kt)("inlineCode",{parentName:"li"},"aura::run"))),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-rust"},'let fut = aura::run::<\n Block,\n sp_consensus_aura::sr25519::AuthorityPair,\n _,\n _,\n _,\n _,\n _,\n _,\n _,\n _,\n _,\n >(params);\ntask_manager.spawn_essential_handle().spawn("aura", None, fut);\n')),(0,r.kt)("h2",{id:"phase-3---activate-async-backing"},"Phase 3 - Activate Async Backing"),(0,r.kt)("p",null,"This phase consists of changes to your parachain\u2019s runtime that activate async backing feature."),(0,r.kt)("ol",null,(0,r.kt)("li",{parentName:"ol"},"Configure ",(0,r.kt)("inlineCode",{parentName:"li"},"pallet_aura"),", setting ",(0,r.kt)("inlineCode",{parentName:"li"},"AllowMultipleBlocksPerSlot")," to true in ",(0,r.kt)("inlineCode",{parentName:"li"},"runtime/src/lib.rs"),".")),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-rust"},'impl pallet_aura::Config for Runtime {\n type AuthorityId = AuraId;\n type DisabledValidators = ();\n type MaxAuthorities = ConstU32<100_000>;\n // highlight-next-line\n type AllowMultipleBlocksPerSlot = ConstBool;\n #[cfg(feature = "experimental")]\n type SlotDuration = ConstU64;\n}\n')),(0,r.kt)("ol",null,(0,r.kt)("li",{parentName:"ol"},"Increase the maximum ",(0,r.kt)("inlineCode",{parentName:"li"},"UNINCLUDED_SEGMENT_CAPACITY")," in ",(0,r.kt)("inlineCode",{parentName:"li"},"runtime/src/lib.rs"),".")),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-rust"},"/// Maximum number of blocks simultaneously accepted by the Runtime, not yet included into the\n/// relay chain.\npub const UNINCLUDED_SEGMENT_CAPACITY: u32 = 3;\n/// How many parachain blocks are processed by the relay chain per parent. Limits the number of\n/// blocks authored per slot.\npub const BLOCK_PROCESSING_VELOCITY: u32 = 1;\n")),(0,r.kt)("ol",{start:3},(0,r.kt)("li",{parentName:"ol"},"Decrease ",(0,r.kt)("inlineCode",{parentName:"li"},"MILLISECS_PER_BLOCK")," to 6000.")),(0,r.kt)("ul",null,(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("p",{parentName:"li"},"Note: For a parachain which measures time in terms of its own block number rather than by relay\nblock number it may be preferable to increase velocity. Changing block time may cause\ncomplications, requiring additional changes. See the section \u201cTiming by Block Number\u201d."),(0,r.kt)("pre",{parentName:"li"},(0,r.kt)("code",{parentName:"pre",className:"language-rust"},"/// This determines the average expected block time that we are targeting.\n/// Blocks will be produced at a minimum duration defined by `SLOT_DURATION`.\n/// `SLOT_DURATION` is picked up by `pallet_timestamp` which is in turn picked\n/// up by `pallet_aura` to implement `fn slot_duration()`.\n///\n/// Change this to adjust the block time.\npub const MILLISECS_PER_BLOCK: u64 = 6000;\n")))),(0,r.kt)("ol",{start:4},(0,r.kt)("li",{parentName:"ol"},"Update ",(0,r.kt)("inlineCode",{parentName:"li"},"MAXIMUM_BLOCK_WEIGHT")," to reflect the increased time available for block production.")),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-rust"},"/// We allow for 2 seconds of compute with a 6 second average block.\npub const MAXIMUM_BLOCK_WEIGHT: Weight = Weight::from_parts(\n WEIGHT_REF_TIME_PER_SECOND.saturating_mul(2),\n cumulus_primitives_core::relay_chain::MAX_POV_SIZE as u64,\n);\n")),(0,r.kt)("ol",{start:5},(0,r.kt)("li",{parentName:"ol"},"Add a feature flagged alternative for ",(0,r.kt)("inlineCode",{parentName:"li"},"MinimumPeriod")," in ",(0,r.kt)("inlineCode",{parentName:"li"},"pallet_timestamp"),". The type should be\n",(0,r.kt)("inlineCode",{parentName:"li"},"ConstU64<0>")," with the feature flag experimental, and ",(0,r.kt)("inlineCode",{parentName:"li"},"ConstU64<{SLOT_DURATION / 2}>")," without.")),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-rust"},'impl pallet_timestamp::Config for Runtime {\n type Moment = u64;\n type OnTimestampSet = Aura;\n #[cfg(feature = "experimental")]\n type MinimumPeriod = ConstU64<0>;\n #[cfg(not(feature = "experimental"))]\n type MinimumPeriod = ConstU64<{ SLOT_DURATION / 2 }>;\n type WeightInfo = weights::pallet_timestamp::WeightInfo;\n}\n')),(0,r.kt)("h2",{id:"timing-by-block-number"},"Timing by Block Number"),(0,r.kt)("p",null,"With asynchronous backing it will be possible for parachains to opt for a block time of 6 seconds\nrather than 12 seconds. But modifying block duration isn\u2019t so simple for a parachain which was\nmeasuring time in terms of its own block number. It could result in expected and actual time not\nmatching up, stalling the parachain."),(0,r.kt)("p",null,"One strategy to deal with this issue is to instead rely on relay chain block numbers for timing.\nRelay block number is kept track of by each parachain in ",(0,r.kt)("inlineCode",{parentName:"p"},"pallet-parachain-system")," with the storage\nvalue ",(0,r.kt)("inlineCode",{parentName:"p"},"LastRelayChainBlockNumber"),". This value can be obtained and used wherever timing based on\nblock number is needed."))}h.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/3d1bf5db.dae9a60c.js b/assets/js/3d1bf5db.dae9a60c.js deleted file mode 100644 index cad94b9a6153..000000000000 --- a/assets/js/3d1bf5db.dae9a60c.js +++ /dev/null @@ -1 +0,0 @@ -"use strict";(self.webpackChunk=self.webpackChunk||[]).push([[3452],{3905:(e,a,t)=>{t.d(a,{Zo:()=>p,kt:()=>h});var n=t(67294);function i(e,a,t){return a in e?Object.defineProperty(e,a,{value:t,enumerable:!0,configurable:!0,writable:!0}):e[a]=t,e}function r(e,a){var t=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);a&&(n=n.filter((function(a){return Object.getOwnPropertyDescriptor(e,a).enumerable}))),t.push.apply(t,n)}return t}function l(e){for(var a=1;a=0||(i[t]=e[t]);return i}(e,a);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,t)&&(i[t]=e[t])}return i}var o=n.createContext({}),c=function(e){var a=n.useContext(o),t=a;return e&&(t="function"==typeof e?e(a):l(l({},a),e)),t},p=function(e){var a=c(e.components);return n.createElement(o.Provider,{value:a},e.children)},d="mdxType",m={inlineCode:"code",wrapper:function(e){var a=e.children;return n.createElement(n.Fragment,{},a)}},u=n.forwardRef((function(e,a){var t=e.components,i=e.mdxType,r=e.originalType,o=e.parentName,p=s(e,["components","mdxType","originalType","parentName"]),d=c(t),u=i,h=d["".concat(o,".").concat(u)]||d[u]||m[u]||r;return t?n.createElement(h,l(l({ref:a},p),{},{components:t})):n.createElement(h,l({ref:a},p))}));function h(e,a){var t=arguments,i=a&&a.mdxType;if("string"==typeof e||i){var r=t.length,l=new Array(r);l[0]=u;var s={};for(var o in a)hasOwnProperty.call(a,o)&&(s[o]=a[o]);s.originalType=e,s[d]="string"==typeof e?e:i,l[1]=s;for(var c=2;c{t.r(a),t.d(a,{assets:()=>p,contentTitle:()=>o,default:()=>h,frontMatter:()=>s,metadata:()=>c,toc:()=>d});var n=t(87462),i=t(63366),r=(t(67294),t(3905)),l=["components"],s={id:"maintain-guides-async-backing",title:"Upgrade Parachain for Asynchronous Backing Compatibility",sidebar_label:"Async Backing Upgrade",description:"Steps on how to upgrade a parachain to be compatible with the relay chain's async backing feature.",keywords:["async","backing","parachain","consensus"],slug:"../maintain-guides-async-backing"},o=void 0,c={unversionedId:"maintain/maintain-guides-async-backing",id:"maintain/maintain-guides-async-backing",title:"Upgrade Parachain for Asynchronous Backing Compatibility",description:"Steps on how to upgrade a parachain to be compatible with the relay chain's async backing feature.",source:"@site/../docs/maintain/maintain-guides-async-backing.md",sourceDirName:"maintain",slug:"/maintain-guides-async-backing",permalink:"/docs/maintain-guides-async-backing",draft:!1,editUrl:"https://github.com/w3f/polkadot-wiki/edit/master/docs/maintain/maintain-guides-async-backing.md",tags:[],version:"current",lastUpdatedBy:"github-actions[bot]",lastUpdatedAt:1707118323,formattedLastUpdatedAt:"Feb 5, 2024",frontMatter:{id:"maintain-guides-async-backing",title:"Upgrade Parachain for Asynchronous Backing Compatibility",sidebar_label:"Async Backing Upgrade",description:"Steps on how to upgrade a parachain to be compatible with the relay chain's async backing feature.",keywords:["async","backing","parachain","consensus"],slug:"../maintain-guides-async-backing"},sidebar:"docs",previous:{title:"Node Endpoints",permalink:"/docs/maintain-endpoints"},next:{title:"Set up a Full Node",permalink:"/docs/maintain-sync"}},p={},d=[{value:"Async Backing Prerequisites",id:"async-backing-prerequisites",level:2},{value:"Async Backing Terminology and Parameters",id:"async-backing-terminology-and-parameters",level:2},{value:"Prerequisite",id:"prerequisite",level:2},{value:"Phase 1 - Update Parachain Runtime",id:"phase-1---update-parachain-runtime",level:2},{value:"Phase 2 - Update Parachain Nodes",id:"phase-2---update-parachain-nodes",level:2},{value:"Phase 3 - Activate Async Backing",id:"phase-3---activate-async-backing",level:2},{value:"Timing by Block Number",id:"timing-by-block-number",level:2}],m={toc:d},u="wrapper";function h(e){var a=e.components,s=(0,i.Z)(e,l);return(0,r.kt)(u,(0,n.Z)({},m,s,{components:a,mdxType:"MDXLayout"}),(0,r.kt)("admonition",{title:"Who is this guide for?",type:"info"},(0,r.kt)("p",{parentName:"admonition"},"This guide is relevant for cumulus based parachain projects started in 2023 or before. Later\nprojects should already be async backing compatible. If starting a new parachain project, please use\nan async backing compatible template such as\n",(0,r.kt)("a",{parentName:"p",href:"https://github.com/paritytech/polkadot-sdk/tree/master/cumulus/parachain-template"},(0,r.kt)("inlineCode",{parentName:"a"},"cumulus/parachain-template")),".")),(0,r.kt)("p",null,"The rollout process for Async Backing has three phases. Phases 1 and 2 below put new infrastructure\nin place. Then we can simply turn on async backing in phase 3. But first, some pre-reqs and context\nto set the stage."),(0,r.kt)("h2",{id:"async-backing-prerequisites"},"Async Backing Prerequisites"),(0,r.kt)("admonition",{type:"info"},(0,r.kt)("p",{parentName:"admonition"},"For more contextual information about asynchronous backing, see\n",(0,r.kt)("a",{parentName:"p",href:"/docs/learn-async-backing"},"this page"),".")),(0,r.kt)("p",null,"Pull the latest version of Cumulus for use with your parachain. It contains necessary changes for\nasync backing compatibility. Latest on master branch of\n",(0,r.kt)("a",{parentName:"p",href:"https://github.com/paritytech/polkadot-sdk"},"Polkadot-SDK")," is currently sufficient. Any 2024 release\nwill work as well."),(0,r.kt)("h2",{id:"async-backing-terminology-and-parameters"},"Async Backing Terminology and Parameters"),(0,r.kt)("p",null,"Time for a bit of context before we get started. The following concepts will aid in demystifying the\ncollator side of Async Backing and establish a basic understanding of the changes being made:"),(0,r.kt)("ul",null,(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("strong",{parentName:"li"},"Unincluded segment")," - From the perspective of a parachain block under construction, the\nunincluded segment describes a chain of recent block ancestors which have yet to be included on\nthe relay chain. The ability to build new blocks on top of the unincluded segment rather than on\ntop of blocks freshly included in the relay chain is the core of asynchronous backing."),(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("strong",{parentName:"li"},"Capacity")," - The maximum size of the unincluded segment. The longer this is, the farther ahead a\nparachain can work, producing new candidates before the ancestors of those candidates have been\nseen as included on-chain. Practically, a capacity of 2-3 is sufficient to realize the full\nbenefits of asynchronous backing, at least until the release of elastic scaling."),(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("strong",{parentName:"li"},"Velocity")," - The base rate at which a parachain should produce blocks. A velocity of 1 indicates\nthat 1 parachain block should be produced per relay chain block. In order to fill the unincluded\nsegment with candidates, collators may build up to ",(0,r.kt)("inlineCode",{parentName:"li"},"Velocity + 1")," candidates per aura slot while\nthere is remaining capacity. When elastic scaling has been released velocities greater than 1 will\nbe supported."),(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("strong",{parentName:"li"},"AllowMultipleBlocksPerSlot")," - If this is ",(0,r.kt)("inlineCode",{parentName:"li"},"true"),", Aura will allow slots to stay the same across\nsequential parablocks. Otherwise the slot number must increase with each block. To fill the\nunincluded segment as described above we need this to be ",(0,r.kt)("inlineCode",{parentName:"li"},"true"),"."),(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("strong",{parentName:"li"},"FixedVelocityConsensusHook")," - This is a variety of ",(0,r.kt)("inlineCode",{parentName:"li"},"ConsensusHook")," intended to be passed to\n",(0,r.kt)("inlineCode",{parentName:"li"},"parachain-system")," as part of its ",(0,r.kt)("inlineCode",{parentName:"li"},"Config"),". It is triggered on initialization of a new runtime. An\ninstance of ",(0,r.kt)("inlineCode",{parentName:"li"},"FixedVelocityConsensusHook")," is defined with both a fixed capacity and velocity. It\naborts the runtime early if either capacity or velocity is exceeded, as the collator shouldn\u2019t be\ncreating additional blocks in that case."),(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("strong",{parentName:"li"},"AsyncBackingParams.max_candidate_depth")," - This parameter determines the maximum unincluded\nsegment depth the relay chain will support. Candidates sent to validators which exceed\n",(0,r.kt)("inlineCode",{parentName:"li"},"max_candidate_depth")," will be ignored. ",(0,r.kt)("inlineCode",{parentName:"li"},"Capacity"),", as mentioned above, should not exceed\n",(0,r.kt)("inlineCode",{parentName:"li"},"max_candidate_depth"),"."),(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("strong",{parentName:"li"},"AsyncBackingParams.allowed_ancestry_len")," - Each parachain block candidate has a ",(0,r.kt)("inlineCode",{parentName:"li"},"relay_parent"),"\nfrom which its execution and validation context is derived. Before async backing the\n",(0,r.kt)("inlineCode",{parentName:"li"},"relay_parent")," for a candidate not yet backed was required to be the fresh head of a fork. With\nasync backing we can relax this requirement. Instead we set a conservative maximum age in blocks\nfor the ",(0,r.kt)("inlineCode",{parentName:"li"},"relay_parent"),"s of candidates in the unincluded segment. This age, ",(0,r.kt)("inlineCode",{parentName:"li"},"allowed_ancestry_len"),"\nlives on the relay chain and is queried by parachains when deciding which block to build on top\nof."),(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("strong",{parentName:"li"},"Lookahead Collator")," - A collator for Aura that looks ahead of the most recently included\nparachain block when determining what to build upon. This collator also builds additional blocks\nwhen the maximum backlog is not saturated. The size of the backlog is determined by invoking the\nAuraUnincludedSegmentApi. If that runtime API is not supported, this assumes a maximum backlog\nsize of 1.")),(0,r.kt)("h2",{id:"prerequisite"},"Prerequisite"),(0,r.kt)("p",null,"The relay chain needs to have async backing enabled so double-check that the relay-chain\nconfiguration contains the following three parameters (especially when testing locally e.g. with\nzombienet):"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-json"},'"async_backing_params": {\n "max_candidate_depth": 3,\n "allowed_ancestry_len": 2\n},\n"scheduling_lookahead": 2\n')),(0,r.kt)("p",null,"\u26a0\ufe0f ",(0,r.kt)("inlineCode",{parentName:"p"},"scheduling_lookahead")," must be set to 2, otherwise parachain block times will degrade to worse\nthan with sync backing! \u26a0\ufe0f"),(0,r.kt)("h2",{id:"phase-1---update-parachain-runtime"},"Phase 1 - Update Parachain Runtime"),(0,r.kt)("p",null,"This phase involves configuring your parachain\u2019s runtime to make use of async backing system."),(0,r.kt)("ol",null,(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("p",{parentName:"li"},"Establish constants for ",(0,r.kt)("inlineCode",{parentName:"p"},"capacity")," and ",(0,r.kt)("inlineCode",{parentName:"p"},"velocity")," and set both of them to 1 in\n",(0,r.kt)("inlineCode",{parentName:"p"},"/runtime/src/lib.rs"),".")),(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("p",{parentName:"li"},"Establish a constant relay chain slot duration measured in milliseconds equal to ",(0,r.kt)("inlineCode",{parentName:"p"},"6000")," in\n",(0,r.kt)("inlineCode",{parentName:"p"},"/runtime/src/lib.rs"),"."))),(0,r.kt)("p",null,(0,r.kt)("img",{alt:"capacity-velocity",src:t(14668).Z,width:"3024",height:"732"})),(0,r.kt)("ol",{start:3},(0,r.kt)("li",{parentName:"ol"},"Establish constants ",(0,r.kt)("inlineCode",{parentName:"li"},"MILLISECS_PER_BLOCK")," and ",(0,r.kt)("inlineCode",{parentName:"li"},"SLOT_DURATION")," if not already present in\n",(0,r.kt)("inlineCode",{parentName:"li"},"/runtime/src/lib.rs"),".")),(0,r.kt)("p",null,(0,r.kt)("img",{alt:"capacity-velocity",src:t(73294).Z,width:"2744",height:"712"})),(0,r.kt)("ol",{start:4},(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("p",{parentName:"li"},"Configure ",(0,r.kt)("inlineCode",{parentName:"p"},"cumulus_pallet_parachain_system")," in ",(0,r.kt)("inlineCode",{parentName:"p"},"runtime/src/lib.rs")),(0,r.kt)("ul",{parentName:"li"},(0,r.kt)("li",{parentName:"ul"},"Define a ",(0,r.kt)("inlineCode",{parentName:"li"},"FixedVelocityConsensusHook")," using our capacity, velocity, and relay slot duration\nconstants. Use this to set the parachain system ",(0,r.kt)("inlineCode",{parentName:"li"},"ConsensusHook")," property.")),(0,r.kt)("p",{parentName:"li"},(0,r.kt)("img",{alt:"consensus-hook",src:t(58503).Z,width:"2818",height:"1704"})),(0,r.kt)("ul",{parentName:"li"},(0,r.kt)("li",{parentName:"ul"},"Set the parachain system property ",(0,r.kt)("inlineCode",{parentName:"li"},"CheckAssociatedRelayNumber")," to\n",(0,r.kt)("inlineCode",{parentName:"li"},"RelayNumberMonotonicallyIncreases"))),(0,r.kt)("p",{parentName:"li"},(0,r.kt)("img",{alt:"Associated-Relay-number",src:t(93730).Z,width:"3194",height:"900"}))),(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("p",{parentName:"li"},"Configure ",(0,r.kt)("inlineCode",{parentName:"p"},"pallet_aura")," in ",(0,r.kt)("inlineCode",{parentName:"p"},"runtime/src/lib.rs")),(0,r.kt)("ul",{parentName:"li"},(0,r.kt)("li",{parentName:"ul"},"Set ",(0,r.kt)("inlineCode",{parentName:"li"},"AllowMultipleBlocksPerSlot")," to ",(0,r.kt)("inlineCode",{parentName:"li"},"false")," (don't worry, we will set it to ",(0,r.kt)("inlineCode",{parentName:"li"},"true")," when we\nactivate async backing in step 3)."),(0,r.kt)("li",{parentName:"ul"},"Define ",(0,r.kt)("inlineCode",{parentName:"li"},"pallet_aura::SlotDuration")," using our constant ",(0,r.kt)("inlineCode",{parentName:"li"},"SLOT_DURATION"))),(0,r.kt)("p",{parentName:"li"},(0,r.kt)("img",{alt:"Aura-config",src:t(13257).Z,width:"1964",height:"704"}))),(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("p",{parentName:"li"},"Update ",(0,r.kt)("inlineCode",{parentName:"p"},"aura_api::SlotDuration()")," to match the constant ",(0,r.kt)("inlineCode",{parentName:"p"},"SLOT_DURATION")),(0,r.kt)("p",{parentName:"li"},(0,r.kt)("img",{alt:"Aura-spi",src:t(72841).Z,width:"2372",height:"380"}))),(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("p",{parentName:"li"},"Implement the ",(0,r.kt)("inlineCode",{parentName:"p"},"AuraUnincludedSegmentApi"),", which allows the collator client to query its runtime\nto determine whether it should author a block."),(0,r.kt)("ul",{parentName:"li"},(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("p",{parentName:"li"},"Add the dependency ",(0,r.kt)("inlineCode",{parentName:"p"},"cumulus-primitives-aura")," to the ",(0,r.kt)("inlineCode",{parentName:"p"},"runtime/Cargo.toml")," file for your runtime"),(0,r.kt)("p",{parentName:"li"},(0,r.kt)("img",{alt:"cargo-toml",src:t(57245).Z,width:"3200",height:"602"}))),(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("p",{parentName:"li"},"In the same file, add ",(0,r.kt)("inlineCode",{parentName:"p"},'"cumulus-primitives-aura/std",')," to the ",(0,r.kt)("inlineCode",{parentName:"p"},"std")," feature.")),(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("p",{parentName:"li"},"Inside the ",(0,r.kt)("inlineCode",{parentName:"p"},"impl_runtime_apis!")," block for your runtime, implement the\n",(0,r.kt)("inlineCode",{parentName:"p"},"AuraUnincludedSegmentApi")," as shown below."),(0,r.kt)("p",{parentName:"li"},(0,r.kt)("img",{alt:"unincluded-segment",src:t(979).Z,width:"2686",height:"700"})),(0,r.kt)("p",{parentName:"li"},"Important note: With a capacity of 1 we have an effective velocity of \xbd even when velocity is\nconfigured to some larger value. This is because capacity will be filled after a single block\nis produced and will only be freed up after that block is included on the relay chain, which\ntakes 2 relay blocks to accomplish. Thus with capacity 1 and velocity 1 we get the customary 12\nsecond parachain block time.")))),(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("p",{parentName:"li"},"If your ",(0,r.kt)("inlineCode",{parentName:"p"},"runtime/src/lib.rs")," provides a ",(0,r.kt)("inlineCode",{parentName:"p"},"CheckInherents")," type to ",(0,r.kt)("inlineCode",{parentName:"p"},"register_validate_block"),",\nremove it. ",(0,r.kt)("inlineCode",{parentName:"p"},"FixedVelocityConsensusHook")," makes it unnecessary. The following example shows how\n",(0,r.kt)("inlineCode",{parentName:"p"},"register_validate_block")," should look after removing ",(0,r.kt)("inlineCode",{parentName:"p"},"CheckInherents"),"."),(0,r.kt)("p",{parentName:"li"},(0,r.kt)("img",{alt:"register-validate-block",src:t(67170).Z,width:"2852",height:"354"})))),(0,r.kt)("h2",{id:"phase-2---update-parachain-nodes"},"Phase 2 - Update Parachain Nodes"),(0,r.kt)("p",null,"This phase consists of plugging in the new lookahead collator node."),(0,r.kt)("ol",null,(0,r.kt)("li",{parentName:"ol"},"Import ",(0,r.kt)("inlineCode",{parentName:"li"},"cumulus_primitives_core::ValidationCode")," to ",(0,r.kt)("inlineCode",{parentName:"li"},"node/src/service.rs"))),(0,r.kt)("p",null,(0,r.kt)("img",{alt:"import-validation-code",src:t(33650).Z,width:"1676",height:"312"})),(0,r.kt)("ol",{start:2},(0,r.kt)("li",{parentName:"ol"},"In ",(0,r.kt)("inlineCode",{parentName:"li"},"node/src/service.rs"),", modify ",(0,r.kt)("inlineCode",{parentName:"li"},"sc_service::spawn_tasks")," to use a clone of ",(0,r.kt)("inlineCode",{parentName:"li"},"Backend")," rather\nthan the original")),(0,r.kt)("p",null,(0,r.kt)("img",{alt:"spawn-tasks",src:t(39729).Z,width:"2182",height:"1224"})),(0,r.kt)("ol",{start:3},(0,r.kt)("li",{parentName:"ol"},"Add ",(0,r.kt)("inlineCode",{parentName:"li"},"backend")," as a parameter to ",(0,r.kt)("inlineCode",{parentName:"li"},"start_consensus()")," in ",(0,r.kt)("inlineCode",{parentName:"li"},"node/src/service.rs"))),(0,r.kt)("p",null,(0,r.kt)("img",{alt:"start-consensus-1",src:t(7939).Z,width:"3040",height:"616"})),(0,r.kt)("p",null,(0,r.kt)("img",{alt:"start-consensus-2",src:t(14005).Z,width:"2890",height:"614"})),(0,r.kt)("ol",{start:4},(0,r.kt)("li",{parentName:"ol"},"In ",(0,r.kt)("inlineCode",{parentName:"li"},"start_consensus()")," import the lookahead collator rather than the basic collator")),(0,r.kt)("p",null,(0,r.kt)("img",{alt:"lookahead-collator",src:t(64937).Z,width:"3192",height:"98"})),(0,r.kt)("ol",{start:5},(0,r.kt)("li",{parentName:"ol"},"In ",(0,r.kt)("inlineCode",{parentName:"li"},"start_consensus()")," replace the ",(0,r.kt)("inlineCode",{parentName:"li"},"BasicAuraParams")," struct with ",(0,r.kt)("inlineCode",{parentName:"li"},"AuraParams"),(0,r.kt)("ul",{parentName:"li"},(0,r.kt)("li",{parentName:"ul"},"Change the struct type from ",(0,r.kt)("inlineCode",{parentName:"li"},"BasicAuraParams")," to ",(0,r.kt)("inlineCode",{parentName:"li"},"AuraParams")),(0,r.kt)("li",{parentName:"ul"},"In the ",(0,r.kt)("inlineCode",{parentName:"li"},"para_client")," field, pass in a cloned para client rather than the original"),(0,r.kt)("li",{parentName:"ul"},"Add a ",(0,r.kt)("inlineCode",{parentName:"li"},"para_backend")," parameter after ",(0,r.kt)("inlineCode",{parentName:"li"},"para_client"),", passing in our para backend"),(0,r.kt)("li",{parentName:"ul"},"Provide a ",(0,r.kt)("inlineCode",{parentName:"li"},"code_hash_provider")," closure like that shown below"),(0,r.kt)("li",{parentName:"ul"},"Increase ",(0,r.kt)("inlineCode",{parentName:"li"},"authoring_duration")," from 500 milliseconds to 1500")))),(0,r.kt)("p",null,"Note: Set ",(0,r.kt)("inlineCode",{parentName:"p"},"authoring_duration")," to whatever you want, taking your own hardware into account. But if\nthe backer who should be slower than you due to reading from disk, times out at two seconds your\ncandidates will be rejected."),(0,r.kt)("p",null,(0,r.kt)("img",{alt:"Aura-params",src:t(19303).Z,width:"3196",height:"1726"})),(0,r.kt)("ol",{start:6},(0,r.kt)("li",{parentName:"ol"},"In ",(0,r.kt)("inlineCode",{parentName:"li"},"start_consensus()")," replace ",(0,r.kt)("inlineCode",{parentName:"li"},"basic_aura::run")," with ",(0,r.kt)("inlineCode",{parentName:"li"},"aura::run"))),(0,r.kt)("p",null,(0,r.kt)("img",{alt:"Aura-run",src:t(27317).Z,width:"3190",height:"598"})),(0,r.kt)("h2",{id:"phase-3---activate-async-backing"},"Phase 3 - Activate Async Backing"),(0,r.kt)("p",null,"This phase consists of changes to your parachain\u2019s runtime that activate async backing feature."),(0,r.kt)("ol",null,(0,r.kt)("li",{parentName:"ol"},"Configure ",(0,r.kt)("inlineCode",{parentName:"li"},"pallet_aura"),", setting ",(0,r.kt)("inlineCode",{parentName:"li"},"AllowMultipleBlocksPerSlot")," to true in ",(0,r.kt)("inlineCode",{parentName:"li"},"runtime/src/lib.rs"),".")),(0,r.kt)("p",null,(0,r.kt)("img",{alt:"Aura-allow-multiple-blocks",src:t(88692).Z,width:"1920",height:"678"})),(0,r.kt)("ol",null,(0,r.kt)("li",{parentName:"ol"},"Increase the maximum ",(0,r.kt)("inlineCode",{parentName:"li"},"UNINCLUDED_SEGMENT_CAPACITY")," in ",(0,r.kt)("inlineCode",{parentName:"li"},"runtime/src/lib.rs"),".")),(0,r.kt)("p",null,(0,r.kt)("img",{alt:"Unincluded-segment-capacity",src:t(55716).Z,width:"1274",height:"226"})),(0,r.kt)("ol",{start:3},(0,r.kt)("li",{parentName:"ol"},"Decrease ",(0,r.kt)("inlineCode",{parentName:"li"},"MILLISECS_PER_BLOCK")," to 6000.")),(0,r.kt)("ul",null,(0,r.kt)("li",{parentName:"ul"},"Note: For a parachain which measures time in terms of its own block number rather than by relay\nblock number it may be preferable to increase velocity. Changing block time may cause\ncomplications, requiring additional changes. See the section \u201cTiming by Block Number\u201d.")),(0,r.kt)("p",null,(0,r.kt)("img",{alt:"block-time",src:t(56330).Z,width:"2740",height:"626"})),(0,r.kt)("ol",{start:4},(0,r.kt)("li",{parentName:"ol"},"Update ",(0,r.kt)("inlineCode",{parentName:"li"},"MAXIMUM_BLOCK_WEIGHT")," to reflect the increased time available for block production.")),(0,r.kt)("p",null,(0,r.kt)("img",{alt:"block-weight",src:t(37458).Z,width:"2614",height:"428"})),(0,r.kt)("ol",{start:5},(0,r.kt)("li",{parentName:"ol"},"Add a feature flagged alternative for ",(0,r.kt)("inlineCode",{parentName:"li"},"MinimumPeriod")," in ",(0,r.kt)("inlineCode",{parentName:"li"},"pallet_timestamp"),". The type should be\n",(0,r.kt)("inlineCode",{parentName:"li"},"ConstU64<0>")," with the feature flag experimental, and ",(0,r.kt)("inlineCode",{parentName:"li"},"ConstU64<{SLOT_DURATION / 2}>")," without.")),(0,r.kt)("p",null,(0,r.kt)("img",{alt:"minimum-period",src:t(83693).Z,width:"2422",height:"814"})),(0,r.kt)("h2",{id:"timing-by-block-number"},"Timing by Block Number"),(0,r.kt)("p",null,"With asynchronous backing it will be possible for parachains to opt for a block time of 6 seconds\nrather than 12 seconds. But modifying block duration isn\u2019t so simple for a parachain which was\nmeasuring time in terms of its own block number. It could result in expected and actual time not\nmatching up, stalling the parachain."),(0,r.kt)("p",null,"One strategy to deal with this issue is to instead rely on relay chain block numbers for timing.\nRelay block number is kept track of by each parachain in ",(0,r.kt)("inlineCode",{parentName:"p"},"pallet-parachain-system")," with the storage\nvalue ",(0,r.kt)("inlineCode",{parentName:"p"},"LastRelayChainBlockNumber"),". This value can be obtained and used wherever timing based on\nblock number is needed."))}h.isMDXComponent=!0},88692:(e,a,t)=>{t.d(a,{Z:()=>n});const n=t.p+"assets/images/async-backing-allow-multiple-12827c5ae8be763b2b2ec5b16ba59ece.png"},93730:(e,a,t)=>{t.d(a,{Z:()=>n});const n=t.p+"assets/images/async-backing-associated-relay-57246a3cb56d0030314ca79fef4b9ce0.png"},72841:(e,a,t)=>{t.d(a,{Z:()=>n});const n=t.p+"assets/images/async-backing-aura-api-32badf8707637f9b9b344d42c7056132.png"},19303:(e,a,t)=>{t.d(a,{Z:()=>n});const n=t.p+"assets/images/async-backing-aura-params-b3ddee0fd3fdb97a624bbfe6aba4a1c2.png"},27317:(e,a,t)=>{t.d(a,{Z:()=>n});const n=t.p+"assets/images/async-backing-aura-run-12845909492ef12ee7c65b411f2eb21c.png"},56330:(e,a,t)=>{t.d(a,{Z:()=>n});const n=t.p+"assets/images/async-backing-block-time-f377d59fc54bd7da4bc40ffda9a5bb42.png"},14668:(e,a,t)=>{t.d(a,{Z:()=>n});const n=t.p+"assets/images/async-backing-capacity-velocity-284086ee80ed6f362605da2861982fd4.png"},57245:(e,a,t)=>{t.d(a,{Z:()=>n});const n=t.p+"assets/images/async-backing-cargo-7a4e51836905ddfd6166d0c6585c8547.png"},13257:(e,a,t)=>{t.d(a,{Z:()=>n});const n=t.p+"assets/images/async-backing-config-aura-78aaaceb60b158603d2536d22987de34.png"},58503:(e,a,t)=>{t.d(a,{Z:()=>n});const n=t.p+"assets/images/async-backing-consensus-hook-d0b32b28cfd96c484bdbd33d3021469d.png"},33650:(e,a,t)=>{t.d(a,{Z:()=>n});const n=t.p+"assets/images/async-backing-cumulus-primitives-1f9fdc12cf1dff0f1d180857797034ef.png"},64937:(e,a,t)=>{t.d(a,{Z:()=>n});const n=t.p+"assets/images/async-backing-lookahead-collator-c0ddf4595a07a3519a9f3ce39291b85b.png"},37458:(e,a,t)=>{t.d(a,{Z:()=>n});const n=t.p+"assets/images/async-backing-maxblock-weight-4a93f8ba093eb551f53beca9ae26940e.png"},83693:(e,a,t)=>{t.d(a,{Z:()=>n});const n=t.p+"assets/images/async-backing-minimum-period-7ff2737538315419ff89dc7af0ce774a.png"},67170:(e,a,t)=>{t.d(a,{Z:()=>n});const n=t.p+"assets/images/async-backing-register-validate-d2b309bef0cf424dc03ec58bbe4b329c.png"},73294:(e,a,t)=>{t.d(a,{Z:()=>n});const n=t.p+"assets/images/async-backing-slot-duration-8ae26819c2ecff7ebde87441782c315c.png"},39729:(e,a,t)=>{t.d(a,{Z:()=>n});const n=t.p+"assets/images/async-backing-spawn-tasks-e5041596b06c8c23c0e3b33f5cd0556d.png"},14005:(e,a,t)=>{t.d(a,{Z:()=>n});const n=t.p+"assets/images/async-backing-start-consensus-2-6a192785fc1b07d8ca69653c4a630824.png"},7939:(e,a,t)=>{t.d(a,{Z:()=>n});const n=t.p+"assets/images/async-backing-start-consensus-623d270ec4a847084f8b9f7c338ad347.png"},55716:(e,a,t)=>{t.d(a,{Z:()=>n});const n=t.p+"assets/images/async-backing-unincluded-segment-capacity-01035865c97ed701f209ff3869776d8a.png"},979:(e,a,t)=>{t.d(a,{Z:()=>n});const n=t.p+"assets/images/async-backing-unincluded-segment-a7371567ff6508ab3a59ed1b54bb28f0.png"}}]); \ No newline at end of file diff --git a/assets/js/d3a753cf.9d00af7a.js b/assets/js/d3a753cf.142c7fbf.js similarity index 53% rename from assets/js/d3a753cf.9d00af7a.js rename to assets/js/d3a753cf.142c7fbf.js index a0c9f07c734c..9302bfa21379 100644 --- a/assets/js/d3a753cf.9d00af7a.js +++ b/assets/js/d3a753cf.142c7fbf.js @@ -1 +1 @@ -"use strict";(self.webpackChunk=self.webpackChunk||[]).push([[8855],{3905:(e,t,n)=>{n.d(t,{Zo:()=>u,kt:()=>f});var a=n(67294);function r(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function o(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,a)}return n}function l(e){for(var t=1;t=0||(r[n]=e[n]);return r}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(r[n]=e[n])}return r}var c=a.createContext({}),s=function(e){var t=a.useContext(c),n=t;return e&&(n="function"==typeof e?e(t):l(l({},t),e)),n},u=function(e){var t=s(e.components);return a.createElement(c.Provider,{value:t},e.children)},m="mdxType",p={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},d=a.forwardRef((function(e,t){var n=e.components,r=e.mdxType,o=e.originalType,c=e.parentName,u=i(e,["components","mdxType","originalType","parentName"]),m=s(n),d=r,f=m["".concat(c,".").concat(d)]||m[d]||p[d]||o;return n?a.createElement(f,l(l({ref:t},u),{},{components:n})):a.createElement(f,l({ref:t},u))}));function f(e,t){var n=arguments,r=t&&t.mdxType;if("string"==typeof e||r){var o=n.length,l=new Array(o);l[0]=d;var i={};for(var c in t)hasOwnProperty.call(t,c)&&(i[c]=t[c]);i.originalType=e,i[m]="string"==typeof e?e:r,l[1]=i;for(var s=2;s{n.r(t),n.d(t,{assets:()=>u,contentTitle:()=>c,default:()=>f,frontMatter:()=>i,metadata:()=>s,toc:()=>m});var a=n(87462),r=n(63366),o=(n(67294),n(3905)),l=["components"],i={id:"learn-xcm-docs-multilocation-example",title:"Example",sidebar_label:"Example",description:"A MultiLocation Example.",keywords:["xcm","cross-consensus messaging","multilocation"],slug:"../multilocation-example"},c="Example",s={unversionedId:"learn/xcm/fundamentals/multilocation/learn-xcm-docs-multilocation-example",id:"learn/xcm/fundamentals/multilocation/learn-xcm-docs-multilocation-example",title:"Example",description:"A MultiLocation Example.",source:"@site/../docs/learn/xcm/fundamentals/multilocation/example.md",sourceDirName:"learn/xcm/fundamentals/multilocation",slug:"/learn/xcm/fundamentals/multilocation-example",permalink:"/docs/learn/xcm/fundamentals/multilocation-example",draft:!1,editUrl:"https://github.com/w3f/polkadot-wiki/edit/master/docs/learn/xcm/fundamentals/multilocation/example.md",tags:[],version:"current",lastUpdatedBy:"bader y",lastUpdatedAt:1694099593,formattedLastUpdatedAt:"Sep 7, 2023",frontMatter:{id:"learn-xcm-docs-multilocation-example",title:"Example",sidebar_label:"Example",description:"A MultiLocation Example.",keywords:["xcm","cross-consensus messaging","multilocation"],slug:"../multilocation-example"},sidebar:"docs",previous:{title:"Junction(s)",permalink:"/docs/learn/xcm/fundamentals/multilocation-junctions"},next:{title:"MultiAsset",permalink:"/docs/learn/xcm/fundamentals-multiasset"}},u={},m=[],p={toc:m},d="wrapper";function f(e){var t=e.components,i=(0,r.Z)(e,l);return(0,o.kt)(d,(0,a.Z)({},p,i,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("h1",{id:"example"},"Example"),(0,o.kt)("p",null,"In this example we show different ",(0,o.kt)("inlineCode",{parentName:"p"},"MultiLocation"),"s for the system hierarchy in the image below.\n",(0,o.kt)("img",{alt:"Example",src:n(49740).Z,width:"871",height:"526"})),(0,o.kt)("p",null,"From the perspective of RelayA"),(0,o.kt)("pre",null,(0,o.kt)("code",{parentName:"pre",className:"language-rust"},"// ParaA\nlet _: MultiLocation = Parachain(1000).into();\n// AccountId32 in Parachain A\nlet _: MultiLocation = (Parachain(1000), AccountId32 { network: RELAY_A_NETWORK, id: [0u8; 32]}).into();\n// Asset in Parachain A\nlet _: MultiLocation = (Parachain(1000), PalletInstance(1), GeneralIndex(1)).into();\n// Ethereum based account on Parachain B\nlet _: MultiLocation = (Parachain(2000), AccountKey20 { network: RELAY_A_NETWORK, key: [0u8; 20] }).into();\n// Smart Contract\nlet _: MultiLocation = (Parachain(2000), PalletInstance(1), AccountKey20 { network: RELAY_A_NETWORK, key: [0u8; 20] }).into();\n// RelayB\nlet _: MultiLocation = (Parent, GlobalConsensus(RELAY_B_NETWORK)).into();\n// NFT on Parachain C\nlet _: MultiLocation = (Parent, GlobalConsensus(RELAY_B_NETWORK), Parachain(1000), GeneralIndex(1)).into();\n")),(0,o.kt)("p",null,"From the perspective of Parachain C"),(0,o.kt)("pre",null,(0,o.kt)("code",{parentName:"pre",className:"language-rust"},"// Relay A\nlet _: MultiLocation = Parent.into();\n// Plurality Example. Many more BodyId/BodyPart combos imaginable\nlet _: MultiLocation = (Parent, Plurality { id: BodyId::Index(0), part: BodyPart::Members { count: 10 } }).into();\n// Account in Relay\nlet _: MultiLocation = (Parent, AccountId32 { network: None, id: [0u8; 32] }).into();\n")),(0,o.kt)("p",null,"From the perspective of the Smart Contract"),(0,o.kt)("pre",null,(0,o.kt)("code",{parentName:"pre",className:"language-rust"},"// Asset in Parachain A\nlet _: MultiLocation = (Parent, Parent, Parachain(1000), PalletInstance(1), GeneralIndex(1)).into();\n\n")))}f.isMDXComponent=!0},49740:(e,t,n)=>{n.d(t,{Z:()=>a});const a=n.p+"assets/images/MultiLocation_Example-f123c564a25cab510cf5486df6402c4a.png"}}]); \ No newline at end of file +"use strict";(self.webpackChunk=self.webpackChunk||[]).push([[8855],{3905:(e,t,n)=>{n.d(t,{Zo:()=>u,kt:()=>f});var a=n(67294);function r(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function o(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,a)}return n}function l(e){for(var t=1;t=0||(r[n]=e[n]);return r}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(r[n]=e[n])}return r}var c=a.createContext({}),s=function(e){var t=a.useContext(c),n=t;return e&&(n="function"==typeof e?e(t):l(l({},t),e)),n},u=function(e){var t=s(e.components);return a.createElement(c.Provider,{value:t},e.children)},m="mdxType",p={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},d=a.forwardRef((function(e,t){var n=e.components,r=e.mdxType,o=e.originalType,c=e.parentName,u=i(e,["components","mdxType","originalType","parentName"]),m=s(n),d=r,f=m["".concat(c,".").concat(d)]||m[d]||p[d]||o;return n?a.createElement(f,l(l({ref:t},u),{},{components:n})):a.createElement(f,l({ref:t},u))}));function f(e,t){var n=arguments,r=t&&t.mdxType;if("string"==typeof e||r){var o=n.length,l=new Array(o);l[0]=d;var i={};for(var c in t)hasOwnProperty.call(t,c)&&(i[c]=t[c]);i.originalType=e,i[m]="string"==typeof e?e:r,l[1]=i;for(var s=2;s{n.r(t),n.d(t,{assets:()=>u,contentTitle:()=>c,default:()=>f,frontMatter:()=>i,metadata:()=>s,toc:()=>m});var a=n(87462),r=n(63366),o=(n(67294),n(3905)),l=["components"],i={id:"learn-xcm-docs-multilocation-example",title:"Example",sidebar_label:"Example",description:"A MultiLocation Example.",keywords:["xcm","cross-consensus messaging","multilocation"],slug:"../multilocation-example"},c="Example",s={unversionedId:"learn/xcm/fundamentals/multilocation/learn-xcm-docs-multilocation-example",id:"learn/xcm/fundamentals/multilocation/learn-xcm-docs-multilocation-example",title:"Example",description:"A MultiLocation Example.",source:"@site/../docs/learn/xcm/fundamentals/multilocation/example.md",sourceDirName:"learn/xcm/fundamentals/multilocation",slug:"/learn/xcm/fundamentals/multilocation-example",permalink:"/docs/learn/xcm/fundamentals/multilocation-example",draft:!1,editUrl:"https://github.com/w3f/polkadot-wiki/edit/master/docs/learn/xcm/fundamentals/multilocation/example.md",tags:[],version:"current",lastUpdatedBy:"Roger J. Bos, CFA",lastUpdatedAt:1708049218,formattedLastUpdatedAt:"Feb 16, 2024",frontMatter:{id:"learn-xcm-docs-multilocation-example",title:"Example",sidebar_label:"Example",description:"A MultiLocation Example.",keywords:["xcm","cross-consensus messaging","multilocation"],slug:"../multilocation-example"},sidebar:"docs",previous:{title:"Junction(s)",permalink:"/docs/learn/xcm/fundamentals/multilocation-junctions"},next:{title:"MultiAsset",permalink:"/docs/learn/xcm/fundamentals-multiasset"}},u={},m=[],p={toc:m},d="wrapper";function f(e){var t=e.components,i=(0,r.Z)(e,l);return(0,o.kt)(d,(0,a.Z)({},p,i,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("h1",{id:"example"},"Example"),(0,o.kt)("p",null,"In this example we show different ",(0,o.kt)("inlineCode",{parentName:"p"},"MultiLocation"),"s for the system hierarchy in the image below.\n",(0,o.kt)("img",{alt:"Example",src:n(49740).Z,width:"871",height:"526"})),(0,o.kt)("p",null,"From the perspective of RelayA"),(0,o.kt)("pre",null,(0,o.kt)("code",{parentName:"pre",className:"language-rust"},"// ParaA\nlet _: MultiLocation = Parachain(1000).into();\n// AccountId32 in Parachain A\nlet _: MultiLocation = (Parachain(1000), AccountId32 { network: RELAY_A_NETWORK, id: [0u8; 32]}).into();\n// Asset in Parachain A\nlet _: MultiLocation = (Parachain(1000), PalletInstance(1), GeneralIndex(1)).into();\n// Ethereum based account on Parachain B\nlet _: MultiLocation = (Parachain(2000), AccountKey20 { network: RELAY_A_NETWORK, key: [0u8; 20] }).into();\n// Smart Contract\nlet _: MultiLocation = (Parachain(2000), PalletInstance(1), AccountKey20 { network: RELAY_A_NETWORK, key: [0u8; 20] }).into();\n// RelayB\nlet _: MultiLocation = (Parent, GlobalConsensus(RELAY_B_NETWORK)).into();\n// NFT on Parachain C\nlet _: MultiLocation = (Parent, GlobalConsensus(RELAY_B_NETWORK), Parachain(1000), GeneralIndex(1)).into();\n")),(0,o.kt)("p",null,"From the perspective of Parachain C"),(0,o.kt)("pre",null,(0,o.kt)("code",{parentName:"pre",className:"language-rust"},"// Relay B\nlet _: MultiLocation = Parent.into();\n// Plurality Example. Many more BodyId/BodyPart combos imaginable\nlet _: MultiLocation = (Parent, Plurality { id: BodyId::Index(0), part: BodyPart::Members { count: 10 } }).into();\n// Account in Relay\nlet _: MultiLocation = (Parent, AccountId32 { network: None, id: [0u8; 32] }).into();\n")),(0,o.kt)("p",null,"From the perspective of the Smart Contract"),(0,o.kt)("pre",null,(0,o.kt)("code",{parentName:"pre",className:"language-rust"},"// Asset in Parachain A\nlet _: MultiLocation = (Parent, Parent, Parachain(1000), PalletInstance(1), GeneralIndex(1)).into();\n\n")))}f.isMDXComponent=!0},49740:(e,t,n)=>{n.d(t,{Z:()=>a});const a=n.p+"assets/images/MultiLocation_Example-f123c564a25cab510cf5486df6402c4a.png"}}]); \ No newline at end of file diff --git a/assets/js/runtime~main.7b58b688.js b/assets/js/runtime~main.a0d48e55.js similarity index 99% rename from assets/js/runtime~main.7b58b688.js rename to assets/js/runtime~main.a0d48e55.js index db6ba7b04c15..e29f4173dd79 100644 --- a/assets/js/runtime~main.7b58b688.js +++ b/assets/js/runtime~main.a0d48e55.js @@ -1 +1 @@ -(()=>{"use strict";var e,d,f,b,a={},c={};function r(e){var d=c[e];if(void 0!==d)return d.exports;var f=c[e]={id:e,loaded:!1,exports:{}};return a[e].call(f.exports,f,f.exports,r),f.loaded=!0,f.exports}r.m=a,e=[],r.O=(d,f,b,a)=>{if(!f){var c=1/0;for(i=0;i=a)&&Object.keys(r.O).every((e=>r.O[e](f[o])))?f.splice(o--,1):(t=!1,a0&&e[i-1][2]>a;i--)e[i]=e[i-1];e[i]=[f,b,a]},r.n=e=>{var d=e&&e.__esModule?()=>e.default:()=>e;return r.d(d,{a:d}),d},f=Object.getPrototypeOf?e=>Object.getPrototypeOf(e):e=>e.__proto__,r.t=function(e,b){if(1&b&&(e=this(e)),8&b)return e;if("object"==typeof e&&e){if(4&b&&e.__esModule)return e;if(16&b&&"function"==typeof e.then)return e}var a=Object.create(null);r.r(a);var c={};d=d||[null,f({}),f([]),f(f)];for(var t=2&b&&e;"object"==typeof t&&!~d.indexOf(t);t=f(t))Object.getOwnPropertyNames(t).forEach((d=>c[d]=()=>e[d]));return c.default=()=>e,r.d(a,c),a},r.d=(e,d)=>{for(var f in d)r.o(d,f)&&!r.o(e,f)&&Object.defineProperty(e,f,{enumerable:!0,get:d[f]})},r.f={},r.e=e=>Promise.all(Object.keys(r.f).reduce(((d,f)=>(r.f[f](e,d),d)),[])),r.u=e=>"assets/js/"+({1:"f4fb6e9c",6:"408829bd",12:"1d6d4797",43:"74985360",53:"935f2afb",63:"9f319605",150:"77c23c97",192:"f189ca9f",217:"c7a044bb",250:"f2717f8e",315:"9528ac88",356:"797239df",502:"2d429218",537:"3829cf1d",576:"f52abf29",601:"0c06bca3",609:"d569989b",657:"386bfe51",691:"145746f5",810:"23498fd5",1062:"f90fa732",1083:"899aadcc",1090:"cfd53ea4",1211:"73c3bebc",1213:"25f2bd2a",1239:"f359a251",1288:"fabebe44",1299:"74df6a22",1372:"b61f6dc7",1415:"4d76887f",1419:"f750c690",1446:"5136ee31",1451:"f44679e7",1486:"8dd7cee0",1494:"b21dd8a7",1506:"c977dfe8",1529:"ffe9c3c9",1585:"33b0bcab",1598:"7fbac68a",1635:"5db34cd0",1678:"fa343ad1",1686:"f7191335",1703:"a5002e4a",1723:"0df78d26",1748:"987d08ef",1774:"9e6341e5",1786:"d9ef69a7",1825:"48074a08",1872:"78e1e977",1953:"1ed3671a",1957:"df154d69",1966:"f47489cd",1979:"0cb62240",2008:"4f031749",2042:"dd32e389",2078:"84f79495",2117:"21877fa5",2119:"6d5c9a28",2136:"ecb495b7",2169:"1646726c",2194:"6151e7ce",2242:"f3027c84",2248:"da9f79cb",2354:"493c7fdf",2399:"8d3a1bf8",2483:"d6d2b2d5",2507:"7c78c461",2508:"918b38b6",2552:"863c4753",2581:"967fa6d4",2609:"db0b42b0",2633:"e2e89062",2635:"0b632434",2665:"f4130007",2677:"ece9fdae",2704:"f3bde756",2712:"c2c6a3a6",2749:"b906f375",2754:"78868b16",2758:"9e3f6a8a",2791:"7d54ab5a",2884:"5d69d9d4",2909:"f4200fe5",2914:"2be0d940",2949:"2ea50c63",3066:"af40287e",3091:"b0a48d97",3132:"85afe03a",3262:"8a8a7d05",3330:"e31fc461",3332:"3497b7c6",3347:"32dac8d4",3348:"7ccc428f",3356:"f14351c1",3452:"3d1bf5db",3484:"5c90fc9b",3513:"41b7b3e8",3554:"d5909206",3599:"21899dd2",3620:"f137ce68",3643:"cb9afd28",3665:"f1585bfb",3667:"b0cbc1d4",3668:"b225a2ce",3669:"dbbd9e76",3757:"bea375d6",3837:"beb5436b",3842:"ff6596ea",3933:"cda87995",3945:"f8518919",3978:"c8dd560b",4004:"ec3b6a32",4097:"eef3f1dd",4105:"702d5d94",4126:"5355b952",4143:"9f804621",4174:"a7c27f4d",4195:"c4f5d8e4",4338:"84ede15a",4355:"19ed4d4c",4363:"f2c21b54",4379:"c662f00a",4428:"991ceaa9",4445:"4d9b9869",4476:"f4003c83",4507:"a7b37b86",4537:"1ae2b102",4541:"3e56470e",4566:"694e7470",4620:"48d75399",4634:"54338ffb",4666:"f41c4e9d",4672:"43ee4f22",4674:"fea93377",4825:"06ea9e61",4885:"2462cc91",4909:"f0855ff9",4916:"c1bbdb2a",5005:"320c8a05",5011:"7e9389ad",5013:"c41801b5",5103:"db039c7f",5157:"d27ae88d",5281:"31bd35e0",5422:"b3719d54",5483:"f7acb151",5492:"1882e65d",5526:"0c68fb82",5548:"d6b0148d",5651:"9e2042f5",5704:"b9b4ec9e",5752:"73a7060c",5989:"fbf58567",6104:"c7c5ba1a",6110:"b9c2850c",6140:"32e8da05",6220:"d01f45b7",6253:"a29dc56e",6255:"452ad91d",6277:"a62d9768",6286:"059e0573",6294:"bbba852d",6312:"dbc4065c",6325:"3002ebf4",6357:"43cda9e8",6373:"ceaa29cb",6482:"49816380",6585:"13b7bafa",6598:"ca9fe671",6673:"af3013e9",6687:"bf789d83",6689:"f2521980",6730:"73617284",6776:"666ba125",6779:"c5d9e474",6827:"279fb1d6",6862:"60e73337",6918:"29a046f3",6920:"ccc1222e",6946:"4642ab5c",7022:"543610b9",7061:"feea648c",7202:"4a8eb552",7211:"f44ed8f8",7280:"fbea1897",7288:"6f1a81b8",7313:"db3d6c4d",7368:"bb8b1738",7388:"bd701914",7466:"a5b3561d",7485:"d3db551a",7584:"98a431f4",7633:"b940de31",7654:"c07c2447",7683:"cc44e8fd",7714:"591eca19",7778:"41871d53",7799:"8b670b2b",7823:"9e76b49d",7830:"15985664",7837:"0a3f0c9b",7858:"d6a97e7e",7908:"33bbe353",7918:"17896441",7920:"1a4e3797",7940:"ad762f86",7961:"a2800a5b",8034:"fecdcc34",8067:"69b97ecd",8115:"8247eba8",8138:"694672cd",8139:"386099fc",8178:"9a679a70",8191:"f0ff685a",8215:"30d868e8",8236:"ffd76171",8270:"12331e8b",8355:"c91a9c06",8361:"824749c6",8444:"28b84bbb",8609:"ed3409b3",8648:"71ed82b9",8702:"a74a59a0",8757:"83d4859f",8791:"ab138bf8",8831:"3bd77df4",8855:"d3a753cf",8860:"766a10e1",8866:"98a30fd8",8876:"31c99aa1",8901:"b48c599b",9062:"b38833d4",9071:"60738e36",9112:"a4b71220",9126:"924835c1",9217:"64c7e1cc",9226:"2f3b630e",9247:"8167490d",9276:"e344dd79",9315:"6d2ffbf3",9323:"131c7f55",9478:"c7a2145e",9514:"1be78505",9548:"f95cee6f",9626:"32c9742a",9764:"dc776cbc",9779:"cd144357",9802:"1e15616a",9806:"51fbc2c9",9817:"14eb3368",9905:"b0cb055f",9993:"482bfb5c"}[e]||e)+"."+{1:"5563b650",6:"7d30c008",12:"9f327517",43:"c0a56a28",53:"c42cf623",63:"4e5acc1b",150:"71dd83d2",192:"2ac0e4f9",217:"0102c432",250:"8eadc19e",315:"1fbe91c6",356:"220d0258",502:"3789530f",537:"2aa85719",576:"34d1ab01",601:"6806af70",609:"7ea29085",657:"f5513d14",691:"fb2a7037",810:"f27faee3",1062:"e04ac837",1083:"ac5baa92",1090:"26932415",1211:"84a813cb",1213:"fee6731f",1239:"5f1e8cea",1288:"3482a532",1299:"7dda7011",1372:"44b4d9b2",1415:"68f49da4",1419:"825f6b74",1426:"ad86846c",1446:"2265d608",1451:"311181b0",1486:"58a943ee",1494:"b887110e",1506:"6aafb024",1529:"fe5b909c",1585:"e1ec66d3",1598:"c2253902",1635:"3f87f940",1678:"b3589c09",1686:"ce7ae0b6",1703:"62855a55",1723:"86de2f74",1748:"61758801",1774:"1c405b46",1786:"6a2d15ec",1825:"c534a999",1872:"342366ba",1953:"e4392cf0",1957:"d99c9092",1966:"70e3ff3a",1979:"6d282955",2008:"07ac2f2d",2042:"2483fb69",2078:"17164550",2117:"5ec49133",2119:"783b1699",2136:"dbf5ae7f",2169:"157780d6",2194:"f4d1111f",2242:"f254b300",2248:"230f9ee5",2354:"aa4e409f",2399:"1c71cead",2483:"d7277ae7",2507:"1df35914",2508:"bdd7c956",2552:"6484aed3",2581:"b74affd6",2609:"53e26c77",2633:"52d5c353",2635:"830edb6d",2665:"c197c6c2",2677:"3eca83ca",2704:"c83746c5",2712:"d084caff",2749:"9a8b4034",2754:"82d7eade",2758:"7a12fb0f",2791:"13476d06",2884:"3b223315",2909:"5449596f",2914:"bc303193",2949:"7738f0eb",3066:"2d6ba895",3091:"49ed30e6",3132:"85a16703",3262:"9288e4b5",3330:"f8f9d28c",3332:"59059207",3347:"bc5aa7bf",3348:"32c50c47",3356:"6ee81354",3452:"dae9a60c",3484:"e60b3258",3513:"e1213088",3554:"6dc12371",3599:"3cf04fd0",3620:"289ad75c",3643:"df0de861",3665:"fb1d42b5",3667:"6774df02",3668:"b34aa74c",3669:"1aa1629f",3757:"df6a40c5",3837:"7aa1b869",3842:"fd04194a",3933:"5c9b1648",3945:"bfaf98a6",3978:"31cc483a",4004:"03a19c6b",4097:"b16e87d3",4105:"5e24a8e9",4126:"0661c853",4143:"fdd58e98",4174:"d074f050",4195:"e4766880",4338:"376a1589",4355:"5f97f4b9",4363:"3d90cfe3",4379:"2d13fe17",4428:"ec0e4535",4445:"75e079a4",4476:"c64cea00",4507:"f1de04f5",4537:"f3487f37",4541:"978ae83c",4566:"ab0d60ad",4620:"33e8ed09",4634:"19df48c8",4666:"abf3d2b4",4672:"1f4a5801",4674:"1398c4a2",4825:"36571112",4885:"68afaf38",4909:"3ae4713d",4916:"4b3a7688",4972:"2c004fcc",5005:"20bc3398",5011:"98b0975e",5013:"20a37569",5103:"3f268ad3",5157:"a57342ae",5281:"6761b31b",5422:"30e3a253",5483:"2aa4602b",5492:"7b10a32b",5526:"ad82cb49",5548:"e68f018e",5651:"701df6e6",5704:"70bd0ba6",5752:"325458f3",5989:"0b1cb12b",6104:"5b69caa9",6110:"0933da80",6140:"eabdf9de",6220:"8b344451",6253:"50057d87",6255:"8509f60e",6277:"0a2828ba",6286:"2d39bee6",6294:"b077023f",6312:"6138d82c",6316:"24db8bc9",6325:"9fcf1b01",6357:"de0a02d5",6373:"b8a24443",6482:"502a0b67",6495:"66df9496",6585:"a67b97ef",6598:"5f760aa9",6673:"4c461033",6687:"65686742",6689:"b049b890",6730:"ec349f4d",6776:"0a7bd7c5",6779:"78c472da",6827:"d577ff47",6862:"1ab7f2a1",6918:"61dac2e1",6920:"8b4888f2",6945:"96d36007",6946:"62348511",7022:"fea426f7",7061:"0b068046",7202:"1191d455",7211:"4266a392",7280:"47e41d56",7288:"6beacd01",7313:"196896d2",7368:"d78c2f6b",7388:"53d48c10",7466:"6c38d255",7485:"54197f47",7584:"351e4cd6",7633:"38c08482",7654:"c09ee850",7683:"d3462a4d",7714:"65c31731",7724:"2906ce0b",7778:"8da5b4da",7799:"88bce1a8",7823:"6c8a30f2",7830:"a2703576",7837:"e772d597",7858:"f9862ed2",7908:"0da511b2",7918:"916bc4d8",7920:"16d7152d",7940:"d1702251",7961:"05b141e2",8034:"dca0d1af",8047:"ce7a90ea",8067:"af36ecc3",8115:"2ebb714e",8138:"002569e9",8139:"ccae76ac",8178:"62f5ed0b",8191:"441f4ca4",8215:"775d309b",8236:"63fecdb9",8270:"37d9cdce",8355:"5da79cc6",8361:"7e27723e",8444:"d1bb4e6e",8493:"ee6301a9",8609:"2b8ffa98",8648:"f89d9a5f",8702:"83fcd08f",8757:"4f1ee155",8791:"a3448ed7",8831:"ec7cac70",8855:"9d00af7a",8860:"48171767",8866:"4bdda915",8876:"a30609d2",8894:"ba661129",8901:"cc3ae736",9062:"af09e497",9071:"2e160d34",9112:"38b794db",9126:"c1b79774",9217:"697f935c",9226:"10d8728e",9247:"3b67c817",9276:"5fcd6da7",9315:"d5006aa3",9323:"1d8405cd",9478:"44736e74",9487:"48bf43fe",9514:"693800c6",9548:"f095b5ce",9626:"b43c6d01",9764:"012ce7bf",9779:"4c7efdf9",9802:"11684b0f",9806:"c3977137",9817:"5ba13cdf",9905:"3e1ce1bd",9993:"6a9e0649"}[e]+".js",r.miniCssF=e=>{},r.g=function(){if("object"==typeof globalThis)return globalThis;try{return this||new Function("return this")()}catch(e){if("object"==typeof window)return window}}(),r.o=(e,d)=>Object.prototype.hasOwnProperty.call(e,d),b={},r.l=(e,d,f,a)=>{if(b[e])b[e].push(d);else{var c,t;if(void 0!==f)for(var o=document.getElementsByTagName("script"),n=0;n{c.onerror=c.onload=null,clearTimeout(u);var a=b[e];if(delete b[e],c.parentNode&&c.parentNode.removeChild(c),a&&a.forEach((e=>e(f))),d)return d(f)},u=setTimeout(l.bind(null,void 0,{type:"timeout",target:c}),12e4);c.onerror=l.bind(null,c.onerror),c.onload=l.bind(null,c.onload),t&&document.head.appendChild(c)}},r.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},r.nmd=e=>(e.paths=[],e.children||(e.children=[]),e),r.p="/",r.gca=function(e){return e={15985664:"7830",17896441:"7918",49816380:"6482",73617284:"6730",74985360:"43",f4fb6e9c:"1","408829bd":"6","1d6d4797":"12","935f2afb":"53","9f319605":"63","77c23c97":"150",f189ca9f:"192",c7a044bb:"217",f2717f8e:"250","9528ac88":"315","797239df":"356","2d429218":"502","3829cf1d":"537",f52abf29:"576","0c06bca3":"601",d569989b:"609","386bfe51":"657","145746f5":"691","23498fd5":"810",f90fa732:"1062","899aadcc":"1083",cfd53ea4:"1090","73c3bebc":"1211","25f2bd2a":"1213",f359a251:"1239",fabebe44:"1288","74df6a22":"1299",b61f6dc7:"1372","4d76887f":"1415",f750c690:"1419","5136ee31":"1446",f44679e7:"1451","8dd7cee0":"1486",b21dd8a7:"1494",c977dfe8:"1506",ffe9c3c9:"1529","33b0bcab":"1585","7fbac68a":"1598","5db34cd0":"1635",fa343ad1:"1678",f7191335:"1686",a5002e4a:"1703","0df78d26":"1723","987d08ef":"1748","9e6341e5":"1774",d9ef69a7:"1786","48074a08":"1825","78e1e977":"1872","1ed3671a":"1953",df154d69:"1957",f47489cd:"1966","0cb62240":"1979","4f031749":"2008",dd32e389:"2042","84f79495":"2078","21877fa5":"2117","6d5c9a28":"2119",ecb495b7:"2136","1646726c":"2169","6151e7ce":"2194",f3027c84:"2242",da9f79cb:"2248","493c7fdf":"2354","8d3a1bf8":"2399",d6d2b2d5:"2483","7c78c461":"2507","918b38b6":"2508","863c4753":"2552","967fa6d4":"2581",db0b42b0:"2609",e2e89062:"2633","0b632434":"2635",f4130007:"2665",ece9fdae:"2677",f3bde756:"2704",c2c6a3a6:"2712",b906f375:"2749","78868b16":"2754","9e3f6a8a":"2758","7d54ab5a":"2791","5d69d9d4":"2884",f4200fe5:"2909","2be0d940":"2914","2ea50c63":"2949",af40287e:"3066",b0a48d97:"3091","85afe03a":"3132","8a8a7d05":"3262",e31fc461:"3330","3497b7c6":"3332","32dac8d4":"3347","7ccc428f":"3348",f14351c1:"3356","3d1bf5db":"3452","5c90fc9b":"3484","41b7b3e8":"3513",d5909206:"3554","21899dd2":"3599",f137ce68:"3620",cb9afd28:"3643",f1585bfb:"3665",b0cbc1d4:"3667",b225a2ce:"3668",dbbd9e76:"3669",bea375d6:"3757",beb5436b:"3837",ff6596ea:"3842",cda87995:"3933",f8518919:"3945",c8dd560b:"3978",ec3b6a32:"4004",eef3f1dd:"4097","702d5d94":"4105","5355b952":"4126","9f804621":"4143",a7c27f4d:"4174",c4f5d8e4:"4195","84ede15a":"4338","19ed4d4c":"4355",f2c21b54:"4363",c662f00a:"4379","991ceaa9":"4428","4d9b9869":"4445",f4003c83:"4476",a7b37b86:"4507","1ae2b102":"4537","3e56470e":"4541","694e7470":"4566","48d75399":"4620","54338ffb":"4634",f41c4e9d:"4666","43ee4f22":"4672",fea93377:"4674","06ea9e61":"4825","2462cc91":"4885",f0855ff9:"4909",c1bbdb2a:"4916","320c8a05":"5005","7e9389ad":"5011",c41801b5:"5013",db039c7f:"5103",d27ae88d:"5157","31bd35e0":"5281",b3719d54:"5422",f7acb151:"5483","1882e65d":"5492","0c68fb82":"5526",d6b0148d:"5548","9e2042f5":"5651",b9b4ec9e:"5704","73a7060c":"5752",fbf58567:"5989",c7c5ba1a:"6104",b9c2850c:"6110","32e8da05":"6140",d01f45b7:"6220",a29dc56e:"6253","452ad91d":"6255",a62d9768:"6277","059e0573":"6286",bbba852d:"6294",dbc4065c:"6312","3002ebf4":"6325","43cda9e8":"6357",ceaa29cb:"6373","13b7bafa":"6585",ca9fe671:"6598",af3013e9:"6673",bf789d83:"6687",f2521980:"6689","666ba125":"6776",c5d9e474:"6779","279fb1d6":"6827","60e73337":"6862","29a046f3":"6918",ccc1222e:"6920","4642ab5c":"6946","543610b9":"7022",feea648c:"7061","4a8eb552":"7202",f44ed8f8:"7211",fbea1897:"7280","6f1a81b8":"7288",db3d6c4d:"7313",bb8b1738:"7368",bd701914:"7388",a5b3561d:"7466",d3db551a:"7485","98a431f4":"7584",b940de31:"7633",c07c2447:"7654",cc44e8fd:"7683","591eca19":"7714","41871d53":"7778","8b670b2b":"7799","9e76b49d":"7823","0a3f0c9b":"7837",d6a97e7e:"7858","33bbe353":"7908","1a4e3797":"7920",ad762f86:"7940",a2800a5b:"7961",fecdcc34:"8034","69b97ecd":"8067","8247eba8":"8115","694672cd":"8138","386099fc":"8139","9a679a70":"8178",f0ff685a:"8191","30d868e8":"8215",ffd76171:"8236","12331e8b":"8270",c91a9c06:"8355","824749c6":"8361","28b84bbb":"8444",ed3409b3:"8609","71ed82b9":"8648",a74a59a0:"8702","83d4859f":"8757",ab138bf8:"8791","3bd77df4":"8831",d3a753cf:"8855","766a10e1":"8860","98a30fd8":"8866","31c99aa1":"8876",b48c599b:"8901",b38833d4:"9062","60738e36":"9071",a4b71220:"9112","924835c1":"9126","64c7e1cc":"9217","2f3b630e":"9226","8167490d":"9247",e344dd79:"9276","6d2ffbf3":"9315","131c7f55":"9323",c7a2145e:"9478","1be78505":"9514",f95cee6f:"9548","32c9742a":"9626",dc776cbc:"9764",cd144357:"9779","1e15616a":"9802","51fbc2c9":"9806","14eb3368":"9817",b0cb055f:"9905","482bfb5c":"9993"}[e]||e,r.p+r.u(e)},(()=>{var e={1303:0,532:0};r.f.j=(d,f)=>{var b=r.o(e,d)?e[d]:void 0;if(0!==b)if(b)f.push(b[2]);else if(/^(1303|532)$/.test(d))e[d]=0;else{var a=new Promise(((f,a)=>b=e[d]=[f,a]));f.push(b[2]=a);var c=r.p+r.u(d),t=new Error;r.l(c,(f=>{if(r.o(e,d)&&(0!==(b=e[d])&&(e[d]=void 0),b)){var a=f&&("load"===f.type?"missing":f.type),c=f&&f.target&&f.target.src;t.message="Loading chunk "+d+" failed.\n("+a+": "+c+")",t.name="ChunkLoadError",t.type=a,t.request=c,b[1](t)}}),"chunk-"+d,d)}},r.O.j=d=>0===e[d];var d=(d,f)=>{var b,a,[c,t,o]=f,n=0;if(c.some((d=>0!==e[d]))){for(b in t)r.o(t,b)&&(r.m[b]=t[b]);if(o)var i=o(r)}for(d&&d(f);n{"use strict";var e,d,f,b,a={},c={};function r(e){var d=c[e];if(void 0!==d)return d.exports;var f=c[e]={id:e,loaded:!1,exports:{}};return a[e].call(f.exports,f,f.exports,r),f.loaded=!0,f.exports}r.m=a,e=[],r.O=(d,f,b,a)=>{if(!f){var c=1/0;for(i=0;i=a)&&Object.keys(r.O).every((e=>r.O[e](f[o])))?f.splice(o--,1):(t=!1,a0&&e[i-1][2]>a;i--)e[i]=e[i-1];e[i]=[f,b,a]},r.n=e=>{var d=e&&e.__esModule?()=>e.default:()=>e;return r.d(d,{a:d}),d},f=Object.getPrototypeOf?e=>Object.getPrototypeOf(e):e=>e.__proto__,r.t=function(e,b){if(1&b&&(e=this(e)),8&b)return e;if("object"==typeof e&&e){if(4&b&&e.__esModule)return e;if(16&b&&"function"==typeof e.then)return e}var a=Object.create(null);r.r(a);var c={};d=d||[null,f({}),f([]),f(f)];for(var t=2&b&&e;"object"==typeof t&&!~d.indexOf(t);t=f(t))Object.getOwnPropertyNames(t).forEach((d=>c[d]=()=>e[d]));return c.default=()=>e,r.d(a,c),a},r.d=(e,d)=>{for(var f in d)r.o(d,f)&&!r.o(e,f)&&Object.defineProperty(e,f,{enumerable:!0,get:d[f]})},r.f={},r.e=e=>Promise.all(Object.keys(r.f).reduce(((d,f)=>(r.f[f](e,d),d)),[])),r.u=e=>"assets/js/"+({1:"f4fb6e9c",6:"408829bd",12:"1d6d4797",43:"74985360",53:"935f2afb",63:"9f319605",150:"77c23c97",192:"f189ca9f",217:"c7a044bb",250:"f2717f8e",315:"9528ac88",356:"797239df",502:"2d429218",537:"3829cf1d",576:"f52abf29",601:"0c06bca3",609:"d569989b",657:"386bfe51",691:"145746f5",810:"23498fd5",1062:"f90fa732",1083:"899aadcc",1090:"cfd53ea4",1211:"73c3bebc",1213:"25f2bd2a",1239:"f359a251",1288:"fabebe44",1299:"74df6a22",1372:"b61f6dc7",1415:"4d76887f",1419:"f750c690",1446:"5136ee31",1451:"f44679e7",1486:"8dd7cee0",1494:"b21dd8a7",1506:"c977dfe8",1529:"ffe9c3c9",1585:"33b0bcab",1598:"7fbac68a",1635:"5db34cd0",1678:"fa343ad1",1686:"f7191335",1703:"a5002e4a",1723:"0df78d26",1748:"987d08ef",1774:"9e6341e5",1786:"d9ef69a7",1825:"48074a08",1872:"78e1e977",1953:"1ed3671a",1957:"df154d69",1966:"f47489cd",1979:"0cb62240",2008:"4f031749",2042:"dd32e389",2078:"84f79495",2117:"21877fa5",2119:"6d5c9a28",2136:"ecb495b7",2169:"1646726c",2194:"6151e7ce",2242:"f3027c84",2248:"da9f79cb",2354:"493c7fdf",2399:"8d3a1bf8",2483:"d6d2b2d5",2507:"7c78c461",2508:"918b38b6",2552:"863c4753",2581:"967fa6d4",2609:"db0b42b0",2633:"e2e89062",2635:"0b632434",2665:"f4130007",2677:"ece9fdae",2704:"f3bde756",2712:"c2c6a3a6",2749:"b906f375",2754:"78868b16",2758:"9e3f6a8a",2791:"7d54ab5a",2884:"5d69d9d4",2909:"f4200fe5",2914:"2be0d940",2949:"2ea50c63",3066:"af40287e",3091:"b0a48d97",3132:"85afe03a",3262:"8a8a7d05",3330:"e31fc461",3332:"3497b7c6",3347:"32dac8d4",3348:"7ccc428f",3356:"f14351c1",3452:"3d1bf5db",3484:"5c90fc9b",3513:"41b7b3e8",3554:"d5909206",3599:"21899dd2",3620:"f137ce68",3643:"cb9afd28",3665:"f1585bfb",3667:"b0cbc1d4",3668:"b225a2ce",3669:"dbbd9e76",3757:"bea375d6",3837:"beb5436b",3842:"ff6596ea",3933:"cda87995",3945:"f8518919",3978:"c8dd560b",4004:"ec3b6a32",4097:"eef3f1dd",4105:"702d5d94",4126:"5355b952",4143:"9f804621",4174:"a7c27f4d",4195:"c4f5d8e4",4338:"84ede15a",4355:"19ed4d4c",4363:"f2c21b54",4379:"c662f00a",4428:"991ceaa9",4445:"4d9b9869",4476:"f4003c83",4507:"a7b37b86",4537:"1ae2b102",4541:"3e56470e",4566:"694e7470",4620:"48d75399",4634:"54338ffb",4666:"f41c4e9d",4672:"43ee4f22",4674:"fea93377",4825:"06ea9e61",4885:"2462cc91",4909:"f0855ff9",4916:"c1bbdb2a",5005:"320c8a05",5011:"7e9389ad",5013:"c41801b5",5103:"db039c7f",5157:"d27ae88d",5281:"31bd35e0",5422:"b3719d54",5483:"f7acb151",5492:"1882e65d",5526:"0c68fb82",5548:"d6b0148d",5651:"9e2042f5",5704:"b9b4ec9e",5752:"73a7060c",5989:"fbf58567",6104:"c7c5ba1a",6110:"b9c2850c",6140:"32e8da05",6220:"d01f45b7",6253:"a29dc56e",6255:"452ad91d",6277:"a62d9768",6286:"059e0573",6294:"bbba852d",6312:"dbc4065c",6325:"3002ebf4",6357:"43cda9e8",6373:"ceaa29cb",6482:"49816380",6585:"13b7bafa",6598:"ca9fe671",6673:"af3013e9",6687:"bf789d83",6689:"f2521980",6730:"73617284",6776:"666ba125",6779:"c5d9e474",6827:"279fb1d6",6862:"60e73337",6918:"29a046f3",6920:"ccc1222e",6946:"4642ab5c",7022:"543610b9",7061:"feea648c",7202:"4a8eb552",7211:"f44ed8f8",7280:"fbea1897",7288:"6f1a81b8",7313:"db3d6c4d",7368:"bb8b1738",7388:"bd701914",7466:"a5b3561d",7485:"d3db551a",7584:"98a431f4",7633:"b940de31",7654:"c07c2447",7683:"cc44e8fd",7714:"591eca19",7778:"41871d53",7799:"8b670b2b",7823:"9e76b49d",7830:"15985664",7837:"0a3f0c9b",7858:"d6a97e7e",7908:"33bbe353",7918:"17896441",7920:"1a4e3797",7940:"ad762f86",7961:"a2800a5b",8034:"fecdcc34",8067:"69b97ecd",8115:"8247eba8",8138:"694672cd",8139:"386099fc",8178:"9a679a70",8191:"f0ff685a",8215:"30d868e8",8236:"ffd76171",8270:"12331e8b",8355:"c91a9c06",8361:"824749c6",8444:"28b84bbb",8609:"ed3409b3",8648:"71ed82b9",8702:"a74a59a0",8757:"83d4859f",8791:"ab138bf8",8831:"3bd77df4",8855:"d3a753cf",8860:"766a10e1",8866:"98a30fd8",8876:"31c99aa1",8901:"b48c599b",9062:"b38833d4",9071:"60738e36",9112:"a4b71220",9126:"924835c1",9217:"64c7e1cc",9226:"2f3b630e",9247:"8167490d",9276:"e344dd79",9315:"6d2ffbf3",9323:"131c7f55",9478:"c7a2145e",9514:"1be78505",9548:"f95cee6f",9626:"32c9742a",9764:"dc776cbc",9779:"cd144357",9802:"1e15616a",9806:"51fbc2c9",9817:"14eb3368",9905:"b0cb055f",9993:"482bfb5c"}[e]||e)+"."+{1:"5563b650",6:"7d30c008",12:"9f327517",43:"c0a56a28",53:"c42cf623",63:"4e5acc1b",150:"71dd83d2",192:"2ac0e4f9",217:"0102c432",250:"8eadc19e",315:"1fbe91c6",356:"220d0258",502:"3789530f",537:"2aa85719",576:"34d1ab01",601:"6806af70",609:"7ea29085",657:"f5513d14",691:"fb2a7037",810:"f27faee3",1062:"e04ac837",1083:"ac5baa92",1090:"26932415",1211:"84a813cb",1213:"fee6731f",1239:"5f1e8cea",1288:"3482a532",1299:"7dda7011",1372:"44b4d9b2",1415:"68f49da4",1419:"825f6b74",1426:"ad86846c",1446:"2265d608",1451:"311181b0",1486:"58a943ee",1494:"b887110e",1506:"6aafb024",1529:"fe5b909c",1585:"e1ec66d3",1598:"c2253902",1635:"3f87f940",1678:"b3589c09",1686:"ce7ae0b6",1703:"62855a55",1723:"86de2f74",1748:"61758801",1774:"1c405b46",1786:"6a2d15ec",1825:"c534a999",1872:"342366ba",1953:"e4392cf0",1957:"d99c9092",1966:"70e3ff3a",1979:"6d282955",2008:"07ac2f2d",2042:"2483fb69",2078:"17164550",2117:"5ec49133",2119:"783b1699",2136:"dbf5ae7f",2169:"157780d6",2194:"f4d1111f",2242:"f254b300",2248:"230f9ee5",2354:"aa4e409f",2399:"1c71cead",2483:"d7277ae7",2507:"1df35914",2508:"bdd7c956",2552:"6484aed3",2581:"b74affd6",2609:"53e26c77",2633:"52d5c353",2635:"830edb6d",2665:"c197c6c2",2677:"3eca83ca",2704:"c83746c5",2712:"d084caff",2749:"9a8b4034",2754:"82d7eade",2758:"7a12fb0f",2791:"13476d06",2884:"3b223315",2909:"5449596f",2914:"bc303193",2949:"7738f0eb",3066:"2d6ba895",3091:"49ed30e6",3132:"85a16703",3262:"9288e4b5",3330:"f8f9d28c",3332:"59059207",3347:"bc5aa7bf",3348:"32c50c47",3356:"6ee81354",3452:"854dcdf2",3484:"e60b3258",3513:"e1213088",3554:"6dc12371",3599:"3cf04fd0",3620:"289ad75c",3643:"df0de861",3665:"fb1d42b5",3667:"6774df02",3668:"b34aa74c",3669:"1aa1629f",3757:"df6a40c5",3837:"7aa1b869",3842:"fd04194a",3933:"5c9b1648",3945:"bfaf98a6",3978:"31cc483a",4004:"03a19c6b",4097:"b16e87d3",4105:"5e24a8e9",4126:"0661c853",4143:"fdd58e98",4174:"d074f050",4195:"e4766880",4338:"376a1589",4355:"5f97f4b9",4363:"3d90cfe3",4379:"2d13fe17",4428:"ec0e4535",4445:"75e079a4",4476:"c64cea00",4507:"f1de04f5",4537:"f3487f37",4541:"978ae83c",4566:"ab0d60ad",4620:"33e8ed09",4634:"19df48c8",4666:"abf3d2b4",4672:"1f4a5801",4674:"1398c4a2",4825:"36571112",4885:"68afaf38",4909:"3ae4713d",4916:"4b3a7688",4972:"2c004fcc",5005:"20bc3398",5011:"98b0975e",5013:"20a37569",5103:"3f268ad3",5157:"a57342ae",5281:"6761b31b",5422:"30e3a253",5483:"2aa4602b",5492:"7b10a32b",5526:"ad82cb49",5548:"e68f018e",5651:"701df6e6",5704:"70bd0ba6",5752:"325458f3",5989:"0b1cb12b",6104:"5b69caa9",6110:"0933da80",6140:"eabdf9de",6220:"8b344451",6253:"50057d87",6255:"8509f60e",6277:"0a2828ba",6286:"2d39bee6",6294:"b077023f",6312:"6138d82c",6316:"24db8bc9",6325:"9fcf1b01",6357:"de0a02d5",6373:"b8a24443",6482:"502a0b67",6495:"66df9496",6585:"a67b97ef",6598:"5f760aa9",6673:"4c461033",6687:"65686742",6689:"b049b890",6730:"ec349f4d",6776:"0a7bd7c5",6779:"78c472da",6827:"d577ff47",6862:"1ab7f2a1",6918:"61dac2e1",6920:"8b4888f2",6945:"96d36007",6946:"62348511",7022:"fea426f7",7061:"0b068046",7202:"1191d455",7211:"4266a392",7280:"47e41d56",7288:"6beacd01",7313:"196896d2",7368:"d78c2f6b",7388:"53d48c10",7466:"6c38d255",7485:"54197f47",7584:"351e4cd6",7633:"38c08482",7654:"c09ee850",7683:"d3462a4d",7714:"65c31731",7724:"2906ce0b",7778:"8da5b4da",7799:"88bce1a8",7823:"6c8a30f2",7830:"a2703576",7837:"e772d597",7858:"f9862ed2",7908:"0da511b2",7918:"916bc4d8",7920:"16d7152d",7940:"d1702251",7961:"05b141e2",8034:"dca0d1af",8047:"ce7a90ea",8067:"af36ecc3",8115:"2ebb714e",8138:"002569e9",8139:"ccae76ac",8178:"62f5ed0b",8191:"441f4ca4",8215:"775d309b",8236:"63fecdb9",8270:"37d9cdce",8355:"5da79cc6",8361:"7e27723e",8444:"d1bb4e6e",8493:"ee6301a9",8609:"2b8ffa98",8648:"f89d9a5f",8702:"83fcd08f",8757:"4f1ee155",8791:"a3448ed7",8831:"ec7cac70",8855:"142c7fbf",8860:"48171767",8866:"4bdda915",8876:"a30609d2",8894:"ba661129",8901:"cc3ae736",9062:"af09e497",9071:"2e160d34",9112:"38b794db",9126:"c1b79774",9217:"697f935c",9226:"10d8728e",9247:"3b67c817",9276:"5fcd6da7",9315:"d5006aa3",9323:"1d8405cd",9478:"44736e74",9487:"48bf43fe",9514:"693800c6",9548:"f095b5ce",9626:"b43c6d01",9764:"012ce7bf",9779:"4c7efdf9",9802:"11684b0f",9806:"c3977137",9817:"5ba13cdf",9905:"3e1ce1bd",9993:"6a9e0649"}[e]+".js",r.miniCssF=e=>{},r.g=function(){if("object"==typeof globalThis)return globalThis;try{return this||new Function("return this")()}catch(e){if("object"==typeof window)return window}}(),r.o=(e,d)=>Object.prototype.hasOwnProperty.call(e,d),b={},r.l=(e,d,f,a)=>{if(b[e])b[e].push(d);else{var c,t;if(void 0!==f)for(var o=document.getElementsByTagName("script"),n=0;n{c.onerror=c.onload=null,clearTimeout(u);var a=b[e];if(delete b[e],c.parentNode&&c.parentNode.removeChild(c),a&&a.forEach((e=>e(f))),d)return d(f)},u=setTimeout(l.bind(null,void 0,{type:"timeout",target:c}),12e4);c.onerror=l.bind(null,c.onerror),c.onload=l.bind(null,c.onload),t&&document.head.appendChild(c)}},r.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},r.nmd=e=>(e.paths=[],e.children||(e.children=[]),e),r.p="/",r.gca=function(e){return e={15985664:"7830",17896441:"7918",49816380:"6482",73617284:"6730",74985360:"43",f4fb6e9c:"1","408829bd":"6","1d6d4797":"12","935f2afb":"53","9f319605":"63","77c23c97":"150",f189ca9f:"192",c7a044bb:"217",f2717f8e:"250","9528ac88":"315","797239df":"356","2d429218":"502","3829cf1d":"537",f52abf29:"576","0c06bca3":"601",d569989b:"609","386bfe51":"657","145746f5":"691","23498fd5":"810",f90fa732:"1062","899aadcc":"1083",cfd53ea4:"1090","73c3bebc":"1211","25f2bd2a":"1213",f359a251:"1239",fabebe44:"1288","74df6a22":"1299",b61f6dc7:"1372","4d76887f":"1415",f750c690:"1419","5136ee31":"1446",f44679e7:"1451","8dd7cee0":"1486",b21dd8a7:"1494",c977dfe8:"1506",ffe9c3c9:"1529","33b0bcab":"1585","7fbac68a":"1598","5db34cd0":"1635",fa343ad1:"1678",f7191335:"1686",a5002e4a:"1703","0df78d26":"1723","987d08ef":"1748","9e6341e5":"1774",d9ef69a7:"1786","48074a08":"1825","78e1e977":"1872","1ed3671a":"1953",df154d69:"1957",f47489cd:"1966","0cb62240":"1979","4f031749":"2008",dd32e389:"2042","84f79495":"2078","21877fa5":"2117","6d5c9a28":"2119",ecb495b7:"2136","1646726c":"2169","6151e7ce":"2194",f3027c84:"2242",da9f79cb:"2248","493c7fdf":"2354","8d3a1bf8":"2399",d6d2b2d5:"2483","7c78c461":"2507","918b38b6":"2508","863c4753":"2552","967fa6d4":"2581",db0b42b0:"2609",e2e89062:"2633","0b632434":"2635",f4130007:"2665",ece9fdae:"2677",f3bde756:"2704",c2c6a3a6:"2712",b906f375:"2749","78868b16":"2754","9e3f6a8a":"2758","7d54ab5a":"2791","5d69d9d4":"2884",f4200fe5:"2909","2be0d940":"2914","2ea50c63":"2949",af40287e:"3066",b0a48d97:"3091","85afe03a":"3132","8a8a7d05":"3262",e31fc461:"3330","3497b7c6":"3332","32dac8d4":"3347","7ccc428f":"3348",f14351c1:"3356","3d1bf5db":"3452","5c90fc9b":"3484","41b7b3e8":"3513",d5909206:"3554","21899dd2":"3599",f137ce68:"3620",cb9afd28:"3643",f1585bfb:"3665",b0cbc1d4:"3667",b225a2ce:"3668",dbbd9e76:"3669",bea375d6:"3757",beb5436b:"3837",ff6596ea:"3842",cda87995:"3933",f8518919:"3945",c8dd560b:"3978",ec3b6a32:"4004",eef3f1dd:"4097","702d5d94":"4105","5355b952":"4126","9f804621":"4143",a7c27f4d:"4174",c4f5d8e4:"4195","84ede15a":"4338","19ed4d4c":"4355",f2c21b54:"4363",c662f00a:"4379","991ceaa9":"4428","4d9b9869":"4445",f4003c83:"4476",a7b37b86:"4507","1ae2b102":"4537","3e56470e":"4541","694e7470":"4566","48d75399":"4620","54338ffb":"4634",f41c4e9d:"4666","43ee4f22":"4672",fea93377:"4674","06ea9e61":"4825","2462cc91":"4885",f0855ff9:"4909",c1bbdb2a:"4916","320c8a05":"5005","7e9389ad":"5011",c41801b5:"5013",db039c7f:"5103",d27ae88d:"5157","31bd35e0":"5281",b3719d54:"5422",f7acb151:"5483","1882e65d":"5492","0c68fb82":"5526",d6b0148d:"5548","9e2042f5":"5651",b9b4ec9e:"5704","73a7060c":"5752",fbf58567:"5989",c7c5ba1a:"6104",b9c2850c:"6110","32e8da05":"6140",d01f45b7:"6220",a29dc56e:"6253","452ad91d":"6255",a62d9768:"6277","059e0573":"6286",bbba852d:"6294",dbc4065c:"6312","3002ebf4":"6325","43cda9e8":"6357",ceaa29cb:"6373","13b7bafa":"6585",ca9fe671:"6598",af3013e9:"6673",bf789d83:"6687",f2521980:"6689","666ba125":"6776",c5d9e474:"6779","279fb1d6":"6827","60e73337":"6862","29a046f3":"6918",ccc1222e:"6920","4642ab5c":"6946","543610b9":"7022",feea648c:"7061","4a8eb552":"7202",f44ed8f8:"7211",fbea1897:"7280","6f1a81b8":"7288",db3d6c4d:"7313",bb8b1738:"7368",bd701914:"7388",a5b3561d:"7466",d3db551a:"7485","98a431f4":"7584",b940de31:"7633",c07c2447:"7654",cc44e8fd:"7683","591eca19":"7714","41871d53":"7778","8b670b2b":"7799","9e76b49d":"7823","0a3f0c9b":"7837",d6a97e7e:"7858","33bbe353":"7908","1a4e3797":"7920",ad762f86:"7940",a2800a5b:"7961",fecdcc34:"8034","69b97ecd":"8067","8247eba8":"8115","694672cd":"8138","386099fc":"8139","9a679a70":"8178",f0ff685a:"8191","30d868e8":"8215",ffd76171:"8236","12331e8b":"8270",c91a9c06:"8355","824749c6":"8361","28b84bbb":"8444",ed3409b3:"8609","71ed82b9":"8648",a74a59a0:"8702","83d4859f":"8757",ab138bf8:"8791","3bd77df4":"8831",d3a753cf:"8855","766a10e1":"8860","98a30fd8":"8866","31c99aa1":"8876",b48c599b:"8901",b38833d4:"9062","60738e36":"9071",a4b71220:"9112","924835c1":"9126","64c7e1cc":"9217","2f3b630e":"9226","8167490d":"9247",e344dd79:"9276","6d2ffbf3":"9315","131c7f55":"9323",c7a2145e:"9478","1be78505":"9514",f95cee6f:"9548","32c9742a":"9626",dc776cbc:"9764",cd144357:"9779","1e15616a":"9802","51fbc2c9":"9806","14eb3368":"9817",b0cb055f:"9905","482bfb5c":"9993"}[e]||e,r.p+r.u(e)},(()=>{var e={1303:0,532:0};r.f.j=(d,f)=>{var b=r.o(e,d)?e[d]:void 0;if(0!==b)if(b)f.push(b[2]);else if(/^(1303|532)$/.test(d))e[d]=0;else{var a=new Promise(((f,a)=>b=e[d]=[f,a]));f.push(b[2]=a);var c=r.p+r.u(d),t=new Error;r.l(c,(f=>{if(r.o(e,d)&&(0!==(b=e[d])&&(e[d]=void 0),b)){var a=f&&("load"===f.type?"missing":f.type),c=f&&f.target&&f.target.src;t.message="Loading chunk "+d+" failed.\n("+a+": "+c+")",t.name="ChunkLoadError",t.type=a,t.request=c,b[1](t)}}),"chunk-"+d,d)}},r.O.j=d=>0===e[d];var d=(d,f)=>{var b,a,[c,t,o]=f,n=0;if(c.some((d=>0!==e[d]))){for(b in t)r.o(t,b)&&(r.m[b]=t[b]);if(o)var i=o(r)}for(d&&d(f);n - - + + @@ -30,7 +30,7 @@ communication channels of core team members, and gain access to Polkadot events.

There are many ways you can get involved in expanding Polkadot’s ecosystem, such as:

  • Contributing code and documentation related to the ecosystem
  • Speaking about Polkadot at events, workshops, and meetups
  • Writing blog posts
  • Representing Polkadot in your region
  • Mentoring and onboarding newcomers
  • Identifying partnerships and opportunities for the Polkadot ecosystem
  • Participating in calls and tasks that help drive the ecosystem forward

How to apply:​

To become a Polkadot Ambassador, please fill out your application here.

Find out more about the programme and how to join here.

- + \ No newline at end of file diff --git a/docs/apps-index.html b/docs/apps-index.html index 900a80845d01..787edfa4cd50 100644 --- a/docs/apps-index.html +++ b/docs/apps-index.html @@ -18,14 +18,14 @@ - - + +

Apps

Explore the different applications in the Polkadot and Kusama ecosystems.

- + \ No newline at end of file diff --git a/docs/bug-bounty.html b/docs/bug-bounty.html index fe8cb6dc8eed..fe302b05747a 100644 --- a/docs/bug-bounty.html +++ b/docs/bug-bounty.html @@ -18,8 +18,8 @@ - - + + @@ -43,7 +43,7 @@ not to be disruptive or harmful to our users or us. Otherwise, your actions might be interpreted as an attack rather than an effort to be helpful.

How to report a bug​

Please follow the instructions at web3.foundation/security-report/.

- + \ No newline at end of file diff --git a/docs/build-client-index.html b/docs/build-client-index.html index ac20111c3467..6e452d4354bd 100644 --- a/docs/build-client-index.html +++ b/docs/build-client-index.html @@ -18,14 +18,14 @@ - - + +

Client-side Development

Learn about different options for building client-side apps on Polkadot.

- + \ No newline at end of file diff --git a/docs/build-dapp.html b/docs/build-dapp.html index 861f06571d88..586bf02a6baf 100644 --- a/docs/build-dapp.html +++ b/docs/build-dapp.html @@ -18,8 +18,8 @@ - - + + @@ -37,7 +37,7 @@ see the tooling page for a detailed overview of different SDKs and libraries that are available.

Frameworks & Toolkits​

For front-end applications, several options exist for interfacing with Substrate-based chains (parachains, relay chains, etc.) and smart contracts. These often will interact with the RPC of a Substrate node:

Promise and RxJS APIs around Polkadot and Substrate-based chains via RPC calls. It is dynamically generated based on what the Substrate runtime provides regarding metadata. Full documentation & examples available here.
- + \ No newline at end of file diff --git a/docs/build-data.html b/docs/build-data.html index 8d3da650ddeb..cfd378c7c572 100644 --- a/docs/build-data.html +++ b/docs/build-data.html @@ -18,8 +18,8 @@ - - + + @@ -50,7 +50,7 @@ for details on how to access the data.

Block Explorers​

As you can imagine, blockchain explorers also offer data analytics through an interface where users can examine common data points.

Some block explorers in the Polkadot ecosystem are listed on the tools page.

- + \ No newline at end of file diff --git a/docs/build-guide.html b/docs/build-guide.html index 19a42ec91d10..1e59fadcc140 100644 --- a/docs/build-guide.html +++ b/docs/build-guide.html @@ -18,8 +18,8 @@ - - + + @@ -131,7 +131,7 @@ (parachains, relay chains, etc.) and smart contracts. These often will interact with the RPC of a Substrate node.

Please visit the full documentation for developing dApps and other general client-side development resources.

For a complete list of tools, please take a look here: Tools, APIs, and Languages

- + \ No newline at end of file diff --git a/docs/build-hackathon.html b/docs/build-hackathon.html index 2a6336fc41a1..ae7a174d107e 100644 --- a/docs/build-hackathon.html +++ b/docs/build-hackathon.html @@ -18,8 +18,8 @@ - - + + @@ -46,7 +46,7 @@ that can be a feature of you hackathon or suggested prerequisite for those joining to use.

Support / Contact​

If you have any questions regarding organizing a hackathon, please free feel to contact us by email or ask us via Element chat.

- + \ No newline at end of file diff --git a/docs/build-hrmp-channels.html b/docs/build-hrmp-channels.html index b840641747af..d62456350f58 100644 --- a/docs/build-hrmp-channels.html +++ b/docs/build-hrmp-channels.html @@ -18,8 +18,8 @@ - - + + @@ -62,7 +62,7 @@ forceOpenHrmpChannel calls.

Opening HRMP Channels Between Two System Parachains​

As of Polkadot and Kusama runtimes 1,001,000, anyone can call an establishSystemChannel extrinsic with two system parachains as arguments in order to establish a channel from the given sender to receiver.

- + \ No newline at end of file diff --git a/docs/build-index.html b/docs/build-index.html index 495102b55086..d7158c612719 100644 --- a/docs/build-index.html +++ b/docs/build-index.html @@ -18,8 +18,8 @@ - - + + @@ -39,7 +39,7 @@ are building.

Grants​

  • Grants - Information regarding grants and funding sources available in the Polkadot ecosystem.

PCPs​

Polkadot Contracts Proposals (PCPs) are standards for smart contracts in the Polkadot ecosystem.

Hackathon​

- + \ No newline at end of file diff --git a/docs/build-integrate-assets.html b/docs/build-integrate-assets.html index 7339689b3c9a..19ff6a4b8e19 100644 --- a/docs/build-integrate-assets.html +++ b/docs/build-integrate-assets.html @@ -18,8 +18,8 @@ - - + + @@ -127,7 +127,7 @@ can be claimed).

A great resource to learn more about Error Management in XCM is the Polkadot blog post from Gavin Wood, XCM Part III: Execution and Error Management.

- + \ No newline at end of file diff --git a/docs/build-integration.html b/docs/build-integration.html index a7f4a5693795..8d5a4dc2dbef 100644 --- a/docs/build-integration.html +++ b/docs/build-integration.html @@ -18,8 +18,8 @@ - - + + @@ -42,7 +42,7 @@ transactions. Parity and Web3 Foundation will be able to provide the best support if you use these tools.

If your team would like support, join some of our community channels or contact support@polkadot.network.

- + \ No newline at end of file diff --git a/docs/build-light-clients.html b/docs/build-light-clients.html index f21fe533d9b4..edcc033a9501 100644 --- a/docs/build-light-clients.html +++ b/docs/build-light-clients.html @@ -18,8 +18,8 @@ - - + + @@ -54,7 +54,7 @@ end-users to interact with applications connected to multiple blockchains or connect their own blockchains to applications that support it.

note

Substrate Connect will auto-detect whether a user is using the extension. If not, the Wasm light client will be created in-page for them.

Resources​

- + \ No newline at end of file diff --git a/docs/build-network-index.html b/docs/build-network-index.html index ccd09aedc9bb..a3757cc65c0b 100644 --- a/docs/build-network-index.html +++ b/docs/build-network-index.html @@ -18,14 +18,14 @@ - - + +

Development Networks & Node Management

Learn how to get started with building parachains, solo-chains, and other aspects of protocol development.

- + \ No newline at end of file diff --git a/docs/build-network-overview.html b/docs/build-network-overview.html index 0332cfe9a663..7bc422a1edc0 100644 --- a/docs/build-network-overview.html +++ b/docs/build-network-overview.html @@ -18,8 +18,8 @@ - - + + @@ -39,7 +39,7 @@ here.

For other programmatic ways of interacting with these networks (including PolkadotJS), please view the Node Interactions page.

Testnet Faucets​

Almost all tesnets either have a web-based interface for getting test currency or a Matrix room which you can post !drip <ADDRESS>

See here for all available faucets and how to obtain testnet tokens.

- + \ No newline at end of file diff --git a/docs/build-node-interaction.html b/docs/build-node-interaction.html index b5d4fd8c57ee..a298f8a89129 100644 --- a/docs/build-node-interaction.html +++ b/docs/build-node-interaction.html @@ -18,8 +18,8 @@ - - + + @@ -57,7 +57,7 @@ block by the block author.

{
   "number":"7409038",
   "hash":"0x0e9610f3c89fac046ef83aa625ad414d5403031faa026b7ab2a918184e389968",
   "parentHash":"0xba308541eb207bc639f36d392706309a031c21622f883fb07411060389c5ffdd",
   "stateRoot":"0x4426383b64a944ad7222a4019aefd558c749da0c6920cfcdfd587741d54abbe2",
   "extrinsicsRoot":"0x74749e5f5aeb610bc23fd6d8d79fd8bbf5e4b6053f70ba94ea6b3cc271df4b3a",
   "authorId":"Fvvz6Ej1D5ZR5ZTK1vE1dCjBvkbxE1VncptEtmFaecXe4PF",
   "logs":[
      {
         "type":"PreRuntime",
         "index":"6",
         "value":[
            "BABE",
            "0x023a0200009c7d191000000000"
         ]
      },
      {
         "type":"Seal",
         "index":"5",
         "value":[
            "BABE",
            "0x2296a50fa4fea3a46a95ad5b1f09de76d22c6ed3dc6755718c976e2d14c63e4dd3c6257813d9bdc03bb180b1e20393f1558ae1204982e5c7570df393e11f908b"
         ]
      }
   ],
   "onInitialize":{
      "events":[

      ]
   },
   "extrinsics":[
      {
         "method":{
            "pallet":"timestamp",
            "method":"set"
         },
         "signature":null,
         "nonce":null,
         "args":{
            "now":"1620636072000"
         },
         "tip":null,
         "hash":"0x8b853f49b6543e4fcbc796ad3574ea5601d2869d80629e080e501da4cb7b74b4",
         "info":{

         },
         "events":[
            {
               "method":{
                  "pallet":"system",
                  "method":"ExtrinsicSuccess"
               },
               "data":[
                  {
                     "weight":"185253000",
                     "class":"Mandatory",
                     "paysFee":"Yes"
                  }
               ]
            }
         ],
         "success":true,
         "paysFee":false
      },
      {
         "method":{
            "pallet":"balances",
            "method":"transfer"
         },
         "signature":{
            "signature":"0x94b63112648e8e692f0076fa1ccab3a04510c269d1392c1df2560503865e144e3afd578f1e37e98063b64b98a77a89a9cdc8ade579dcac0984e78d90646a052001",
            "signer":{
               "id":"Gr5sBB1EgdmQ7FG3Ud2BdECWQTMDXNgGPfdHMMtDsmT4Dj3"
            }
         },
         "nonce":"12",
         "args":{
            "dest":{
               "id":"J6ksma2jVeHRcRoYPZBkJRzRbckys7oSmgvjKLrVbj1U8bE"
            },
            "value":"100000000"
         },
         "tip":"0",
         "hash":"0xfbc5e5de75d64abe5aa3ee9272a3112b3ce53710664f6f2b9416b2ffda8799c2",
         "info":{
            "weight":"201217000",
            "class":"Normal",
            "partialFee":"2583332634"
         },
         "events":[
            {
               "method":{
                  "pallet":"balances",
                  "method":"Transfer"
               },
               "data":[
                  "Gr5sBB1EgdmQ7FG3Ud2BdECWQTMDXNgGPfdHMMtDsmT4Dj3",
                  "J6ksma2jVeHRcRoYPZBkJRzRbckys7oSmgvjKLrVbj1U8bE",
                  "100000000"
               ]
            },
            {
               "method":{
                  "pallet":"balances",
                  "method":"Deposit"
               },
               "data":[
                  "Fvvz6Ej1D5ZR5ZTK1vE1dCjBvkbxE1VncptEtmFaecXe4PF",
                  "2583332634"
               ]
            },
            {
               "method":{
                  "pallet":"system",
                  "method":"ExtrinsicSuccess"
               },
               "data":[
                  {
                     "weight":"201217000",
                     "class":"Normal",
                     "paysFee":"Yes"
                  }
               ]
            }
         ],
         "success":true,
         "paysFee":true
      },
      {
         "method":{
            "pallet":"utility",
            "method":"batch"
         },
         "signature":{
            "signature":"0x8aa2fc3f0cff52533745679523705720cff42d0e7258b9797feed193deb0ca73474726e148af0a0b096d44c07f20e5292819ec92279cffb2897e95cc337e638e",
            "signer":{
               "id":"F4gmSZGiM9pMYPsKW7xnGktDr4zRmN2jqy5Ze678y9YWR7F"
            }
         },
         "nonce":"687",
         "args":{
            "calls":[
               {
                  "method":{
                     "pallet":"staking",
                     "method":"payoutStakers"
                  },
                  "args":{
                     "validator_stash":"Cfish3zJiFnTvR9jscCap7imeA9ep3cH1wZfcZwAp2gdZHo",
                     "era":"2229"
                  }
               },
               {
                  "method":{
                     "pallet":"staking",
                     "method":"payoutStakers"
                  },
                  "args":{
                     "validator_stash":"Cfish3zJiFnTvR9jscCap7imeA9ep3cH1wZfcZwAp2gdZHo",
                     "era":"2230"
                  }
               },
               {
                  "method":{
                     "pallet":"staking",
                     "method":"payoutStakers"
                  },
                  "args":{
                     "validator_stash":"Cfish3zJiFnTvR9jscCap7imeA9ep3cH1wZfcZwAp2gdZHo",
                     "era":"2231"
                  }
               },
               {
                  "method":{
                     "pallet":"staking",
                     "method":"payoutStakers"
                  },
                  "args":{
                     "validator_stash":"DifishR4auphofhzxsy2aupgYo4NaUECH7qgt71CgiB2o6P",
                     "era":"2231"
                  }
               },
               {
                  "method":{
                     "pallet":"staking",
                     "method":"payoutStakers"
                  },
                  "args":{
                     "validator_stash":"J1fishfH94nFZLNScHgC2HorWpFD2xdPxd96wtTCHLvKxfa",
                     "era":"2231"
                  }
               }
            ]
         },
         "tip":"0",
         "hash":"0x69171ec3f4e5e4dfd27f4d1c5b5dbc884932c5d9a078c84495bb7ab875c8785f",
         "info":{
            "weight":"629782467000",
            "class":"Normal",
            "partialFee":"5150837715"
         },
         "events":[
            {
               "method":{
                  "pallet":"staking",
                  "method":"Reward"
               },
               "data":[
                  "Cfish3zJiFnTvR9jscCap7imeA9ep3cH1wZfcZwAp2gdZHo",
                  "40730624074"
               ]
            },
            {
               "method":{
                  "pallet":"staking",
                  "method":"Reward"
               },
               "data":[
                  "FhLcXuFkTwyc3o9K82VBahpain1YHWyGeNMDTTyeDJKfm5b",
                  "4296071738"
               ]
            },
            {
               "method":{
                  "pallet":"staking",
                  "method":"Reward"
               },
               "data":[
                  "F1NyXFUayqmVMdjNK45hcaTCE3JiqdU83sEGhQ3HQXn2Rpq",
                  "1770904403"
               ]
            },

            // ...

            {
               "method":{
                  "pallet":"utility",
                  "method":"BatchCompleted"
               },
               "data":[

               ]
            },
            {
               "method":{
                  "pallet":"balances",
                  "method":"Deposit"
               },
               "data":[
                  "Fvvz6Ej1D5ZR5ZTK1vE1dCjBvkbxE1VncptEtmFaecXe4PF",
                  "5150837715"
               ]
            },
            {
               "method":{
                  "pallet":"system",
                  "method":"ExtrinsicSuccess"
               },
               "data":[
                  {
                     "weight":"629782467000",
                     "class":"Normal",
                     "paysFee":"Yes"
                  }
               ]
            }
         ],
         "success":true,
         "paysFee":true
      }
   ],
   "onFinalize":{
      "events":[

      ]
   },
   "finalized":true
}
The JS number type is a 53 bit precision float

There is no guarantee that the numerical values in the response will have a numerical type. Any numbers larger than 2**53-1 will have a string type.

Submitting a Transaction​

Submit a serialized transaction using the transaction endpoint with an HTTP POST request.

import requests
import json

url = 'http://127.0.0.1:8080/transaction/'
tx_headers = {'Content-type' : 'application/json', 'Accept' : 'text/plain'}
response = requests.post(
    url,
    data='{"tx": "0xed0...000"}', # A serialized tx.
    headers=tx_headers
)
tx_response = json.loads(response.text)

If successful, this endpoint returns a JSON with the transaction hash. In case of error, it will return an error report, e.g.:

{
    "error": "Failed to parse a tx" | "Failed to submit a tx",
    "cause": "Upstream error description"
}
- + \ No newline at end of file diff --git a/docs/build-node-management.html b/docs/build-node-management.html index d069ad2268a3..d3aba7d63a36 100644 --- a/docs/build-node-management.html +++ b/docs/build-node-management.html @@ -18,8 +18,8 @@ - - + + @@ -67,7 +67,7 @@ has a monitor node metrics tutorial which uses this endpoint.

- + \ No newline at end of file diff --git a/docs/build-open-source.html b/docs/build-open-source.html index 2e1af46a555d..53d7f9851ca1 100644 --- a/docs/build-open-source.html +++ b/docs/build-open-source.html @@ -18,8 +18,8 @@ - - + + @@ -34,7 +34,7 @@ the tech stack.

❗ All technologies listed above need to be open-source. Ideally, the links lead directly to the code.

Note: You will need a GitHub account to suggest changes or open issues. If you do not have one, you may sign up for free.

- + \ No newline at end of file diff --git a/docs/build-oracle.html b/docs/build-oracle.html index 1a333615c8eb..172c9898d26e 100644 --- a/docs/build-oracle.html +++ b/docs/build-oracle.html @@ -18,8 +18,8 @@ - - + + @@ -49,7 +49,7 @@ ecosystem develops and oracle parachains begin to appear, this article will be updated with a comparison of the different solutions and the benefits and drawbacks that each provide.

- + \ No newline at end of file diff --git a/docs/build-pdk.html b/docs/build-pdk.html index d47a68a496c8..a285e85e8303 100644 --- a/docs/build-pdk.html +++ b/docs/build-pdk.html @@ -18,8 +18,8 @@ - - + + @@ -191,7 +191,7 @@ transition into a Relay Chain.

For more information on how parathread per-block auctions work, see the more detailed parathread page.

Resources​

- + \ No newline at end of file diff --git a/docs/build-protocol-index.html b/docs/build-protocol-index.html index 07ceb3a3d1bb..923056a0da2d 100644 --- a/docs/build-protocol-index.html +++ b/docs/build-protocol-index.html @@ -18,14 +18,14 @@ - - + +

Protocol & Parachain Development

Learn how to get started with building parachains, solo-chains, and other aspects of protocol development.

- + \ No newline at end of file diff --git a/docs/build-protocol-info.html b/docs/build-protocol-info.html index fe123ef1088b..ac9fcbdeb983 100644 --- a/docs/build-protocol-info.html +++ b/docs/build-protocol-info.html @@ -18,8 +18,8 @@ - - + + @@ -160,7 +160,7 @@ to cancel a runtime upgrade. Using a finalized depth of ten blocks should be safe.

Note that block production and finality are isolated processes in Polkadot, and the chain can have a long unfinalized head.

Do users need to interact with any smart contracts?

No, users interact directly with the chain's logic.

Does Polkadot have state rent?

No, Polkadot uses the existential deposit to prevent dust accounts and other economic mechanisms like locking or reserving tokens for operations that utilize state.

What is an external source to see the current chain height?

- + \ No newline at end of file diff --git a/docs/build-smart-contracts.html b/docs/build-smart-contracts.html index 2d979f227f2e..b9a0cc96ce30 100644 --- a/docs/build-smart-contracts.html +++ b/docs/build-smart-contracts.html @@ -18,8 +18,8 @@ - - + + @@ -146,7 +146,7 @@ Substrate and Polkadot StackExchange to ask their questions. As always, keep up to date with Polkadot and Kusama by following the social channels.

- + \ No newline at end of file diff --git a/docs/build-storage.html b/docs/build-storage.html index 80e486918a48..4c2ee57938c9 100644 --- a/docs/build-storage.html +++ b/docs/build-storage.html @@ -18,8 +18,8 @@ - - + + @@ -59,7 +59,7 @@ directory info will not be visible if you switch to a new browser or clear the browser cache. The storage module allows you to export file directory info from the current browser and import it to the new browser.

manage file dir

note

These above images are taken from this pull request

- + \ No newline at end of file diff --git a/docs/build-tools-index.html b/docs/build-tools-index.html index 6f01ea502538..d8e9bee84502 100644 --- a/docs/build-tools-index.html +++ b/docs/build-tools-index.html @@ -18,8 +18,8 @@ - - + + @@ -111,7 +111,7 @@ Squid Archive Registry
  • Polka-store - A tool which scans a Substrate chain and stores balance-relevant transactions in an SQLite database.
  • Substrate-graph - A compact indexer for Substrate based nodes providing a GraphQL interface.
    • - + \ No newline at end of file diff --git a/docs/build-transaction-construction.html b/docs/build-transaction-construction.html index 1d5fe6465637..9ce1ebcf84ea 100644 --- a/docs/build-transaction-construction.html +++ b/docs/build-transaction-construction.html @@ -18,8 +18,8 @@ - - + + @@ -59,7 +59,7 @@ author_submitAndWatchExtrinsic, the latter of which will subscribe you to events to be notified as a transaction gets validated and included in the chain.

    Notes​

    Some addresses to use in the examples. See Subkey documentation.

    $ subkey --network polkadot generate
    Secret phrase `pulp gaze fuel ... mercy inherit equal` is account:
      Secret seed:      0x57450b3e09ba4598 ... ... ... ... ... ... ... .. 219756eeba80bb16
      Public key (hex): 0x2ca17d26ca376087dc30ed52deb74bf0f64aca96fe78b05ec3e720a72adb1235
      Account ID:       0x2ca17d26ca376087dc30ed52deb74bf0f64aca96fe78b05ec3e720a72adb1235
      SS58 Address:     121X5bEgTZcGQx5NZjwuTjqqKoiG8B2wEAvrUFjuw24ZGZf2

    $ subkey --network polkadot generate
    Secret phrase `exercise auction soft ... obey control easily` is account:
      Secret seed:      0x5f4bbb9fbb69261a ... ... ... ... ... ... ... .. 4691ed7d1130fbbd
      Public key (hex): 0xda04de6cd781c98acf0693dfb97c11011938ad22fcc476ed0089ac5aec3fe243
      Account ID:       0xda04de6cd781c98acf0693dfb97c11011938ad22fcc476ed0089ac5aec3fe243
      SS58 Address:     15vrtLsCQFG3qRYUcaEeeEih4JwepocNJHkpsrqojqnZPc2y
    - + \ No newline at end of file diff --git a/docs/builders-program.html b/docs/builders-program.html index e8c640721012..247d26d26eb8 100644 --- a/docs/builders-program.html +++ b/docs/builders-program.html @@ -18,8 +18,8 @@ - - + + @@ -46,7 +46,7 @@ form of tooling, UI, middleware, bridges, and more.

    Application track​

    This track supports builders who are building on top of Substrate-based chains.

    Check out the official Substrate Builders Program site for more information and steps on how to apply.

    - + \ No newline at end of file diff --git a/docs/community-index.html b/docs/community-index.html index 05a3e906f9fc..83383f956f13 100644 --- a/docs/community-index.html +++ b/docs/community-index.html @@ -18,14 +18,14 @@ - - + +

    Community & Contributors

    Learn about how to participate in the Polkadot community and how to contribute to the Polkadot Wiki.

    - + \ No newline at end of file diff --git a/docs/community.html b/docs/community.html index a7801435a7c7..e5a45bacebb6 100644 --- a/docs/community.html +++ b/docs/community.html @@ -18,8 +18,8 @@ - - + + @@ -65,7 +65,7 @@ Discover thriving communities and participate in engaging campaigns.
  • DotAppStore - Discover featured projects and apps upvoted by the Polkadot community.
  • Awesome Dot - community curated resources, projects, and learning material about the Polkadot and Kusama ecosystems.
    • - + \ No newline at end of file diff --git a/docs/contributing.html b/docs/contributing.html index 49914f32d652..efde8d2f8ae0 100644 --- a/docs/contributing.html +++ b/docs/contributing.html @@ -18,8 +18,8 @@ - - + + @@ -58,7 +58,7 @@ the official crowdin knowledge base as well.




    The following shows an example in Arabic. You can type in your desired translation for each section in the provided area, while using the suggestions generated by the crowdin built-in translator.


    Make sure to save your translation.

    - + \ No newline at end of file diff --git a/docs/contributors.html b/docs/contributors.html index 32fb47add43f..76f0c8d7ebfa 100644 --- a/docs/contributors.html +++ b/docs/contributors.html @@ -18,8 +18,8 @@ - - + + @@ -95,7 +95,7 @@ for the Polkadot protocol. He contributed in creating written content and example applications that demonstrate how to use these new technologies.

    You can now find Logan leading efforts to define the prediction market space at Zeitgeist.

    - + \ No newline at end of file diff --git a/docs/dashboards-index.html b/docs/dashboards-index.html index 27214d07b093..006583641e66 100644 --- a/docs/dashboards-index.html +++ b/docs/dashboards-index.html @@ -18,14 +18,14 @@ - - + +

    Dashboards

    Explore the different dashboards in the Polkadot and Kusama ecosystems.

    - + \ No newline at end of file diff --git a/docs/decentralized-futures.html b/docs/decentralized-futures.html index 1f4c0f676125..22364daca795 100644 --- a/docs/decentralized-futures.html +++ b/docs/decentralized-futures.html @@ -18,8 +18,8 @@ - - + + @@ -49,7 +49,7 @@ utilized, with granularity increasing proportionally with the amount sought. This meticulous approach ensures transparency and accountability in the allocation of resources.
  • A demonstrated willingness to receive a more significant portion of the value in long-term DOT rather than immediate FIAT, aligning with the broader ecosystem's goals.
    • - + \ No newline at end of file diff --git a/docs/decentralized-voices.html b/docs/decentralized-voices.html index 616a617599b7..e79ee5cad17b 100644 --- a/docs/decentralized-voices.html +++ b/docs/decentralized-voices.html @@ -18,8 +18,8 @@ - - + + @@ -56,7 +56,7 @@ dedicated community members to shape the future of the Polkadot ecosystem. For more detailed information, see the original Medium article.

    - + \ No newline at end of file diff --git a/docs/dev-heroes.html b/docs/dev-heroes.html index 400202bf8cf8..effe2c84761a 100644 --- a/docs/dev-heroes.html +++ b/docs/dev-heroes.html @@ -18,8 +18,8 @@ - - + + @@ -40,7 +40,7 @@ open source technology stack list and contribute with a pull request, an issue, or find and fix bugs.

  • Create content: Write a blog post, record a video tutorial, and write a Twitter thread. Share about your latest coding success, something you learned and are excited about.

  • Speak at events: Do a workshop or talk at meetups and conferences.

    • - + \ No newline at end of file diff --git a/docs/explore-index.html b/docs/explore-index.html index df77df7e13c9..d4cefedd9e49 100644 --- a/docs/explore-index.html +++ b/docs/explore-index.html @@ -18,14 +18,14 @@ - - + +

    Explore

    Explore Wallets, Apps and Programmes in Polkadot and Kusama ecosystems.

    - + \ No newline at end of file diff --git a/docs/faq.html b/docs/faq.html index e0a4940be25e..3d2550f2ff94 100644 --- a/docs/faq.html +++ b/docs/faq.html @@ -18,8 +18,8 @@ - - + + @@ -189,7 +189,7 @@ fee calculation page in the Substrate documentation for more detailed information.

    Answered by Gav series​

    The "Answered by Gav" series is a collection of posts uploaded to Reddit of questions that have been asked in the Polkadot Watercooler Riot channel and answered by Polkadot founder Gavin Wood.

    - + \ No newline at end of file diff --git a/docs/general-index.html b/docs/general-index.html index 91a545b61eec..90db7d744494 100644 --- a/docs/general-index.html +++ b/docs/general-index.html @@ -18,14 +18,14 @@ - - + +

    General

    General Information to get started with Polkadot and Web3.

    - + \ No newline at end of file diff --git a/docs/getting-started.html b/docs/getting-started.html index 635c30169987..5bf0bff3a4f0 100644 --- a/docs/getting-started.html +++ b/docs/getting-started.html @@ -18,8 +18,8 @@ - - + + @@ -112,7 +112,7 @@ about Polkadot.
  • Sample Applications - Sample applications that are built on or currently being built for Polkadot.
  • Contributing Guide - Rules for contributing to the wiki.
  • Polkadot Knowledge Base - Troubleshooting resources for specific errors and problems.
    • - + \ No newline at end of file diff --git a/docs/glossary.html b/docs/glossary.html index 5f4442e199eb..165e9809a58c 100644 --- a/docs/glossary.html +++ b/docs/glossary.html @@ -18,8 +18,8 @@ - - + + @@ -298,7 +298,7 @@ not relevant for parachain developers.

    Witness​

    Cryptographic proof statements of data validity.

    Whitelist Pallet​

    Allows one Origin to escalate the privilege level of another Origin for a certain operation. In terms of OpenGov, it allows the Fellowship to authorise a new origin (which we will call Whitelisted-Root) to be executed with Root-level privileges.

    - + \ No newline at end of file diff --git a/docs/governance-apps.html b/docs/governance-apps.html index 84fd8b70a278..adf8d1f81ca4 100644 --- a/docs/governance-apps.html +++ b/docs/governance-apps.html @@ -18,8 +18,8 @@ - - + + @@ -51,7 +51,7 @@ governance events and provides user interfaces to facilitate various governance workflow. It has supported tens of chains including polkadot, kusama, acala, centrifuge, hydradx, interlay, phala, etc. Please check all deployments here.

    - + \ No newline at end of file diff --git a/docs/grants.html b/docs/grants.html index cb8daeaa929b..eb28072b23d0 100644 --- a/docs/grants.html +++ b/docs/grants.html @@ -18,8 +18,8 @@ - - + + @@ -42,7 +42,7 @@ Foundation has considered new ways to distribute KSM for people who need KSM to build.

    If you are interested in obtaining KSM for building or research, you can apply through the Treasury or receive a tip for doing something cool in the community.

    Other Grant Programs​

    Below is a list of other grant programs in the Polkadot/Substrate ecosystem.

    - + \ No newline at end of file diff --git a/docs/how-to-dyor.html b/docs/how-to-dyor.html index b974c437dd42..71722e2c582b 100644 --- a/docs/how-to-dyor.html +++ b/docs/how-to-dyor.html @@ -18,8 +18,8 @@ - - + + @@ -219,7 +219,7 @@ aims to bring to the ecosystem.

    This does not fall under fact-checking and verifying claims, but it is important to mention: fully understanding what something does and its prospective impact is an integral part of making an informed decision, so do not overlook it.

    - + \ No newline at end of file diff --git a/docs/kusama-adversarial-cheatsheet.html b/docs/kusama-adversarial-cheatsheet.html index e5b2d0dfb470..c0aec2a1e3c7 100644 --- a/docs/kusama-adversarial-cheatsheet.html +++ b/docs/kusama-adversarial-cheatsheet.html @@ -18,15 +18,15 @@ - - + +

    Adversarial Cheatsheet

    Expect things to break on Kusama. To help you break some things, take a look at the following threat model.

    Hacker wants to …Security promise that should prevent the hackHacking IncentiveHacking DamageHacking value details
    Double spend tokens via getting the clients to accept a different chainIntegrity (System-wide)HighHighIf attackers are able to double spend tokens, they are able to get services without paying for them. This gives them a high monetary incentive to execute the attack.
    Cause system to mint tokens to his own accountIntegrity (System-wide) MediumLow - MediumIf an attacker is able to craft transactions that mint tokens to their account, then this provides a high monetary incentive to execute this attack.
    Validate malicious blocks to double spend tokensAvailability (System-wide) HighMediumIf an attacker is able to double spend tokens, they are able to get services without paying for them. This gives them a high monetary incentive to execute the attack.
    Undermine consensus mechanism to split chainIntegrity (System-wide)HighHigh"If an attacker is able to double spend tokens, they are able to get services without paying for them. This gives them a high monetary incentive to execute the attack. Betting on decrease in value of the cryptocurrency or competitors want to damage the reputation, so that the value of their blockchain increases.
    Tamper/manipulate blockchain history to invalidate transactions (e.g. a voting result)Integrity (System-wide)MediumMedium - HighAttacker can rollback undesired transactions by intentionally invalidating the block where transaction has happened. Attacker can force a governance decision (or even an on-chain update) that favors them.
    Undermine blockchain or consensus mechanism to damage the ecosystem's reputationAvailability (System-wide)HighHighBetting on decrease in value of the cryptocurrency or competitors want to damage the reputation, so that the value of their blockchain increases
    CensorshipAvailability (System-wide)MediumHighHackers are able to block undesirable types of transactions (e.g. industry competitor transactions or referendum votes). This could be achieved by colluding with other stakeholders or by otherwise obtaining more voting power.
    Deanonymize usersConfidentiality (Node)MediumMediumParties that want to de-anonymize users can use the information to oppress the opposition (e.g. political activists).
    Steal token from nodeIntegrity (Node)HighHighAttackers that are able to steal tokens from nodes can claim assets for themselves, which gives them a high monetary incentive to execute the attack.
    Steal token from node by leaking credentialsConfidentiality (Node)HighHighAttackers that are able to steal tokens from nodes can claim assets for themselves, which gives them a high monetary incentive to execute the attack.
    Prevent node from accessing the Polkadot networkAvailability (Node)LowLow - MediumRun a targeted denial-of-service attack out of revenge, monetary interests (in case of a competing coin exchange, etc.).
    Defraud other participantsIntegrity (Node)MediumLow - MediumAttacker can abuse other participants’ misunderstanding of Polkadot's security guarantees to defraud them. Also, if the reward for calling out bad behavior can be set up so that it is higher than the according punishment, a set of self-handled nodes can be set up to generate a source cycle. Other participants are not needed for this attack.
    Defraud other participantsIntegrity (System-wide)HighHighAn attacker could abuse bugs in Polkadot's economic system to defraud other participants. For example, an attacker could exploit a logic bug to not pay transaction fees.
    - + \ No newline at end of file diff --git a/docs/kusama-bug-bounty.html b/docs/kusama-bug-bounty.html index 554253464dcf..3ee8db029ce0 100644 --- a/docs/kusama-bug-bounty.html +++ b/docs/kusama-bug-bounty.html @@ -18,8 +18,8 @@ - - + + @@ -44,7 +44,7 @@ not to be disruptive or harmful to our users or us. Otherwise, your actions might be interpreted as an attack rather than an effort to be helpful.

    How to report a bug​

    Please follow the instructions at web3.foundation/security-report/.

    - + \ No newline at end of file diff --git a/docs/kusama-claims.html b/docs/kusama-claims.html index 9c69d87f2764..37c2053aa81b 100644 --- a/docs/kusama-claims.html +++ b/docs/kusama-claims.html @@ -18,8 +18,8 @@ - - + + @@ -98,7 +98,7 @@ Polkadot Support page.

    Third Party Claims Processes​

    We do not recommend using a third-party app or process to perform your claim or acquire KSM.

    Claiming using a third-party process can lead to the loss of your allocation; therefore, we cannot recommend using any third-party apps to do so. Manually specifying your transaction data, as specified in our claims process, is the only way to be certain you will receive your allocation.

    - + \ No newline at end of file diff --git a/docs/kusama-coc.html b/docs/kusama-coc.html index 6b4194f0c282..e909e6b79dd2 100644 --- a/docs/kusama-coc.html +++ b/docs/kusama-coc.html @@ -18,8 +18,8 @@ - - + + @@ -42,7 +42,7 @@ on feedback from the Kusama participants and/or the Polkadot community.

    Bugs​

    Please understand that this network is, despite its success, an experiment with potential flaws, so it’s appreciated that community members help report any sort of exploits directly to the team before sharing publicly. Please see the bug bounty program.

    - + \ No newline at end of file diff --git a/docs/kusama-community.html b/docs/kusama-community.html index 4d9f29849d28..fbe0cbf87ab6 100644 --- a/docs/kusama-community.html +++ b/docs/kusama-community.html @@ -18,8 +18,8 @@ - - + + @@ -42,7 +42,7 @@ for technical questions on building with Substrate.
  • Smart Contracts & Parity Ink! - A room to discuss developing Substrate smart contracts using Parity Ink!

    • Social​

    Blogs and tutorials​

    Newsletters​

    - + \ No newline at end of file diff --git a/docs/kusama-getting-started.html b/docs/kusama-getting-started.html index 6d556e2eee2c..9771a991690c 100644 --- a/docs/kusama-getting-started.html +++ b/docs/kusama-getting-started.html @@ -18,8 +18,8 @@ - - + + @@ -55,7 +55,7 @@ here.

    While Kusama does not support smart contracts natively, building apps on it is still possible (e.g. RMRK.app). If you're interested in diving deeper into proper development, however, check out the builders guide.

    Additional Resources:

    - + \ No newline at end of file diff --git a/docs/kusama-index.html b/docs/kusama-index.html index cd54d1775a8d..d36a2da70050 100644 --- a/docs/kusama-index.html +++ b/docs/kusama-index.html @@ -18,8 +18,8 @@ - - + + @@ -27,7 +27,7 @@

    Kusama

    Polkadot's Canary Network​

    Kusama is a canary network for Polkadot; an earlier release of the code that is available first and holds real economic value. For developers, Kusama is a proving ground for runtime upgrades, on-chain governance, and parachains.

    No Promises.

    Kusama has a dedicated Wiki guide. Click on the image below to access it.

    guide
    Kusama Guide
    - + \ No newline at end of file diff --git a/docs/kusama-parameters.html b/docs/kusama-parameters.html index 236b1c8469ee..89fc057881e2 100644 --- a/docs/kusama-parameters.html +++ b/docs/kusama-parameters.html @@ -18,8 +18,8 @@ - - + + @@ -38,7 +38,7 @@ redirected into the Society's treasury to fund growth.

    Precision​

    KSM have 12 decimals of precision. In other words, 1e12 (1_000_000_000_000, or one trillion) Plancks make up a single KSM.

    - + \ No newline at end of file diff --git a/docs/kusama-social-recovery.html b/docs/kusama-social-recovery.html index 45a786c88826..9f217f9a9976 100644 --- a/docs/kusama-social-recovery.html +++ b/docs/kusama-social-recovery.html @@ -18,8 +18,8 @@ - - + + @@ -66,7 +66,7 @@ either go through the council or submit a public proposal. To learn more about governance, see here.

    Further Reading​

    - + \ No newline at end of file diff --git a/docs/kusama-timeline.html b/docs/kusama-timeline.html index 5bcb9c0fc4b9..65a46e63c75e 100644 --- a/docs/kusama-timeline.html +++ b/docs/kusama-timeline.html @@ -18,8 +18,8 @@ - - + + @@ -57,7 +57,7 @@ forkless upgradability provided by Substrate, chaos continues, and in the spirit of chaos, more teams are eager to deploy on Kusama. The path of Kusama deployment has paved the way to Polkadot's parachains as the technology became proven.

    - + \ No newline at end of file diff --git a/docs/learn-DOT.html b/docs/learn-DOT.html index 744bf6fd6239..f573fbbaf033 100644 --- a/docs/learn-DOT.html +++ b/docs/learn-DOT.html @@ -18,8 +18,8 @@ - - + + @@ -84,7 +84,7 @@ through the Treasury. Alternatively, they can be obtained on the open market.

    Polkadot Mainnet DOT​

    Polkadot Mainnet DOT are not freely given away. If you purchased DOT in the original 2017 offering, you may claim them via the Polkadot claims process. Alternatively, they are available on the open market.

    - + \ No newline at end of file diff --git a/docs/learn-account-abstraction.html b/docs/learn-account-abstraction.html index bf1216a5df75..f4921b595207 100644 --- a/docs/learn-account-abstraction.html +++ b/docs/learn-account-abstraction.html @@ -18,8 +18,8 @@ - - + + @@ -89,7 +89,7 @@ Bader Youssef - "Abstracting Away Account Abstraction on Polkadot"
  • Parity Blog Post by Joe Petrowski - "Building a Hot Wallet with Substrate Primitives"
    • - + \ No newline at end of file diff --git a/docs/learn-account-advanced.html b/docs/learn-account-advanced.html index c544e933cc02..78789284f009 100644 --- a/docs/learn-account-advanced.html +++ b/docs/learn-account-advanced.html @@ -18,8 +18,8 @@ - - + + @@ -204,7 +204,7 @@ directly in the browser on the new one.

    This has been tested on Brave and Chrome, but not other browsers.

    1. Go to Polkadot-JS Apps
    2. Go to JavaScript console on the browser (Available in Developer Tools)
    3. Type in the command:
    JSON.stringify(localStorage)
    1. Copy and paste the returned string to a text editor and save the file.
    2. Check that the string you pasted begins and ends with a tick mark ('). If not, add one to the beginning and end.
    3. Save and send that file with the copied string to the new computer.
    4. On the new computer, go to Polkadot-JS Apps
    5. Open the Javascript console on the browser (Available in Developer Tools)
    6. Set a variable raw equal to the string from the text file
    raw = ... copy-pasted json from original computer ...
    1. Run the following code on the console:
    accounts = JSON.parse(raw);
    for (var key in accounts) {
        if (accounts.hasOwnProperty(key)) {
            val = JSON.stringify(accounts[key]).replace(/\\/g,'').slice(1,-1);
            console.log(key + " -> " + val);
            localStorage.setItem(key, val);
        }
    }
    1. Refresh Polkadot-JS App browser and check the Accounts and Addresses pages. All of your accounts and addresses should now be available.
    - + \ No newline at end of file diff --git a/docs/learn-account-multisig.html b/docs/learn-account-multisig.html index f92eca3c384f..199cde5bcc7b 100644 --- a/docs/learn-account-multisig.html +++ b/docs/learn-account-multisig.html @@ -18,8 +18,8 @@ - - + + @@ -44,7 +44,7 @@ the entities designated as the recipients come together in a new multisig under a matching threshold, they will immediately have access to these tokens.

    Polkadot-JS Guides

    If you are an advanced user, see the Polkadot-JS guides about multi-signature accounts.

    - + \ No newline at end of file diff --git a/docs/learn-accounts.html b/docs/learn-accounts.html index ce5c4a86ab45..18dbfb70f798 100644 --- a/docs/learn-accounts.html +++ b/docs/learn-accounts.html @@ -18,8 +18,8 @@ - - + + @@ -118,7 +118,7 @@ The same applies to proxies. The idea is that those actions require some network memory usage that is not given for free. In the example, we created a governance proxy, and the reserved funds for this are 0.0668 KSM.
    Polkadot-JS Guides

    If you are an advanced user, see the Polkadot-JS guides about accounts.

    - + \ No newline at end of file diff --git a/docs/learn-advanced-index.html b/docs/learn-advanced-index.html index da5c71bc5334..8fdbc85144dc 100644 --- a/docs/learn-advanced-index.html +++ b/docs/learn-advanced-index.html @@ -18,14 +18,14 @@ - - + +

    Advanced Concepts

    Advanced concepts to better understand Polkadot.

    - + \ No newline at end of file diff --git a/docs/learn-architecture-index.html b/docs/learn-architecture-index.html index 690a373a09f4..f62d186c2426 100644 --- a/docs/learn-architecture-index.html +++ b/docs/learn-architecture-index.html @@ -18,14 +18,14 @@ - - + +

    Polkadot's Architecture

    Everything about Polkadot's Architecture.

    - + \ No newline at end of file diff --git a/docs/learn-architecture.html b/docs/learn-architecture.html index f47dc12c2edd..419883fc670a 100644 --- a/docs/learn-architecture.html +++ b/docs/learn-architecture.html @@ -18,8 +18,8 @@ - - + + @@ -86,7 +86,7 @@ verify their validity (and later, their availability).

    Whiteboard Series​

    For a video overview of the architecture of Polkadot watch the video below for the whiteboard interview with W3F researcher Alistair Stewart:

    Architecture Overview

    - + \ No newline at end of file diff --git a/docs/learn-archive-index.html b/docs/learn-archive-index.html index 6210e4e877e8..58d05c900f2d 100644 --- a/docs/learn-archive-index.html +++ b/docs/learn-archive-index.html @@ -18,14 +18,14 @@ - - + +

    Archive

    Implementations no longer live on Polkadot.

    - + \ No newline at end of file diff --git a/docs/learn-assets-index.html b/docs/learn-assets-index.html index 6e4f37a98e96..a13acddd3835 100644 --- a/docs/learn-assets-index.html +++ b/docs/learn-assets-index.html @@ -18,14 +18,14 @@ - - + +

    Tokens and Assets

    Everything about tokens and assets on Polkadot.

    - + \ No newline at end of file diff --git a/docs/learn-assets.html b/docs/learn-assets.html index affdb0b65bd2..62187481801f 100644 --- a/docs/learn-assets.html +++ b/docs/learn-assets.html @@ -18,8 +18,8 @@ - - + + @@ -126,7 +126,7 @@ create a 2-of-2 multisig from two pure proxies, and then set members from each group as proxies to those two accounts.

    - + \ No newline at end of file diff --git a/docs/learn-async-backing.html b/docs/learn-async-backing.html index 835087c8f284..301a221af159 100644 --- a/docs/learn-async-backing.html +++ b/docs/learn-async-backing.html @@ -18,8 +18,8 @@ - - + + @@ -152,7 +152,7 @@ Asynchronous Backing (Shallow)
  • Chapter 6.15. from PBA lecture material: Asynchronous Backing (Deep)
  • Polkadot Blog Post - Asynchronous Backing: Elevating Polkadot's Performance and Scale
    • - + \ No newline at end of file diff --git a/docs/learn-auction.html b/docs/learn-auction.html index c00c513a3d58..b50a61476bde 100644 --- a/docs/learn-auction.html +++ b/docs/learn-auction.html @@ -18,8 +18,8 @@ - - + + @@ -141,7 +141,7 @@ W3F research page on parachain allocation that goes more in depth to the mechanism
  • Research Update: The Case for Candle Auctions - W3F breakdown and research update about candle auctions
  • Front-Running, Smart Contracts, and Candle Auctions W3F Research team discusses how to remedy current blockchain auction setbacks with candle auctions
    • - + \ No newline at end of file diff --git a/docs/learn-basics-index.html b/docs/learn-basics-index.html index 58d4de0be96d..4ff6a0ad9c99 100644 --- a/docs/learn-basics-index.html +++ b/docs/learn-basics-index.html @@ -18,14 +18,14 @@ - - + +

    Basic concepts about Polkadot

    Everything about staking, accounts, OpenGov, treasury, transactions, tokens and NFTs.

    - + \ No newline at end of file diff --git a/docs/learn-bridges.html b/docs/learn-bridges.html index 9c813cdb867e..6113d4003c87 100644 --- a/docs/learn-bridges.html +++ b/docs/learn-bridges.html @@ -18,8 +18,8 @@ - - + + @@ -88,7 +88,7 @@ Edgeware chain (a Substrate-based chain) - now defunct and not maintained, but a good example.
  • XCLAIM - XCLAIM is a framework for achieving trustless and efficient cross-chain exchanges using cryptocurrency-backed assets.
  • Celer cBridge - a bridge to transfer assets from Ethereum & Binance Smart Chain to the Astar Polkadot EVM.
    • - + \ No newline at end of file diff --git a/docs/learn-collator.html b/docs/learn-collator.html index abafbfd53893..e8c38c83f88b 100644 --- a/docs/learn-collator.html +++ b/docs/learn-collator.html @@ -18,8 +18,8 @@ - - + + @@ -65,7 +65,7 @@ Cumulus repository. More information can be found under the Cumulus section on the build parachain page.

    Guides and Tools​

    - + \ No newline at end of file diff --git a/docs/learn-comparisons-avalanche.html b/docs/learn-comparisons-avalanche.html index 79908bc7d979..447826abc7cc 100644 --- a/docs/learn-comparisons-avalanche.html +++ b/docs/learn-comparisons-avalanche.html @@ -18,8 +18,8 @@ - - + + @@ -113,7 +113,7 @@ need a recommended minimum of 5 validators, which make the costs of launch predictable. Avalanche has plans to implement shared security, interoperability, composability and on-chain governance features which are already offered by Polkadot.

    References​

    1. The Avalanche Platform Whitepaper
    2. The Avalanche Consensus Whitepaper
    3. The AVAX Token Dynamics Paper
    4. Nakomoto vs Snow consensus
    - + \ No newline at end of file diff --git a/docs/learn-comparisons-cosmos.html b/docs/learn-comparisons-cosmos.html index b070901e882d..59c817ff4ebd 100644 --- a/docs/learn-comparisons-cosmos.html +++ b/docs/learn-comparisons-cosmos.html @@ -18,8 +18,8 @@ - - + + @@ -135,7 +135,7 @@ receiving chain must trust the sending chain. Thus, each blockchain in the Cosmos network has its independent security mechanisms. Chains also have the option to share security with the Cosmos Hub and thereby leverage its economic security.

    - + \ No newline at end of file diff --git a/docs/learn-comparisons-ethereum-2.html b/docs/learn-comparisons-ethereum-2.html index e65910d9baef..4dd078854ef2 100644 --- a/docs/learn-comparisons-ethereum-2.html +++ b/docs/learn-comparisons-ethereum-2.html @@ -18,8 +18,8 @@ - - + + @@ -157,7 +157,7 @@ enacted autonomously via forkless upgrades.
  • Validator selection mechanisms differ as Polkadot can provide strong availability and validity guarantees with fewer validators per shard.
    • - + \ No newline at end of file diff --git a/docs/learn-comparisons-index.html b/docs/learn-comparisons-index.html index 5f032b88c934..a3f8eaaf5bf8 100644 --- a/docs/learn-comparisons-index.html +++ b/docs/learn-comparisons-index.html @@ -18,14 +18,14 @@ - - + +

    Polkadot Comparisons

    Comparison between Polkadot and other Networks.

    - + \ No newline at end of file diff --git a/docs/learn-comparisons-kusama.html b/docs/learn-comparisons-kusama.html index 5e5ba00cfbb7..3cc452ad9c10 100644 --- a/docs/learn-comparisons-kusama.html +++ b/docs/learn-comparisons-kusama.html @@ -18,8 +18,8 @@ - - + + @@ -76,7 +76,7 @@ the future, we’re also likely to see Kusama bridged to Polkadot for cross-network interoperability. Web3 Foundation remains committed to both networks going forward, providing crucial support and guidance to teams building for the ecosystem.

    Explore more​

    - + \ No newline at end of file diff --git a/docs/learn-comparisons-rollups.html b/docs/learn-comparisons-rollups.html index 5c4f05ae135d..e7b608a72fc6 100644 --- a/docs/learn-comparisons-rollups.html +++ b/docs/learn-comparisons-rollups.html @@ -18,8 +18,8 @@ - - + + @@ -94,7 +94,7 @@ transition data.

    Despite these drawbacks, Polkadot remains upgradable through forkless upgrades, which allows the protocol to be easily upgradable to stay in line with future technological advances.

    - + \ No newline at end of file diff --git a/docs/learn-comparisons.html b/docs/learn-comparisons.html index a759de72a4b0..e68b6879ecab 100644 --- a/docs/learn-comparisons.html +++ b/docs/learn-comparisons.html @@ -18,8 +18,8 @@ - - + + @@ -61,7 +61,7 @@ Chain, and as the number of validators in the active set on Polkadot are increased, more parachains can be supported.

    - + \ No newline at end of file diff --git a/docs/learn-components-index.html b/docs/learn-components-index.html index 44c7d2590c2a..b9a69fce9464 100644 --- a/docs/learn-components-index.html +++ b/docs/learn-components-index.html @@ -18,14 +18,14 @@ - - + +

    Components

    Key components of the Polkadot ecosystem.

    - + \ No newline at end of file diff --git a/docs/learn-consensus.html b/docs/learn-consensus.html index fcea957acdfb..1e19afc12d0a 100644 --- a/docs/learn-consensus.html +++ b/docs/learn-consensus.html @@ -18,8 +18,8 @@ - - + + @@ -154,7 +154,7 @@ with Bill Laboon.
  • Block Production and Finalization in Polkadot: Understanding the BABE and GRANDPA Protocols - An academic talk by Bill Laboon, given at MIT Cryptoeconomic Systems 2020, describing Polkadot's hybrid consensus model in-depth.
    • - + \ No newline at end of file diff --git a/docs/learn-controller.html b/docs/learn-controller.html index 70b6f0ce8012..de628fa8efee 100644 --- a/docs/learn-controller.html +++ b/docs/learn-controller.html @@ -18,8 +18,8 @@ - - + + @@ -41,7 +41,7 @@ used less often and usually signed by the stash.

    stash-not-as-controller

    From a practical perspective, there were two accounts, and we needed to remember two passwords. From a security perspective, the party who wanted to control our staking actions was required to control two accounts.

    - + \ No newline at end of file diff --git a/docs/learn-crowdloans.html b/docs/learn-crowdloans.html index 009ac459b33a..ed762ef051e7 100644 --- a/docs/learn-crowdloans.html +++ b/docs/learn-crowdloans.html @@ -18,8 +18,8 @@ - - + + @@ -94,7 +94,7 @@ Apps page.

    Here is an example of the crowdloans in play during the very first Kusama auction.

    crowdloan dashboard

    Furthermore, check out this video on How to Participate in Crowdloans for steps on how to access available crowdloans on PolkadotJS apps.

    - + \ No newline at end of file diff --git a/docs/learn-cryptography.html b/docs/learn-cryptography.html index eadd9bc24185..10fe1f982d2f 100644 --- a/docs/learn-cryptography.html +++ b/docs/learn-cryptography.html @@ -18,8 +18,8 @@ - - + + @@ -175,7 +175,7 @@ make passive attacks much harder if such a backdoor exists.

    However an alternative exists in the form of Curve25519. This algorithm has been proposed in 2006 by DJB [Curve25519]. Its main strengths are its speed, its constant-time run time (and resistance against side-channel attacks), and its lack of nebulous hard-coded constants.

    - + \ No newline at end of file diff --git a/docs/learn-future-implementations-index.html b/docs/learn-future-implementations-index.html index 5f6be926914f..0ca288286720 100644 --- a/docs/learn-future-implementations-index.html +++ b/docs/learn-future-implementations-index.html @@ -18,14 +18,14 @@ - - + +

    Future Implementations

    Implementations that will be deployed on Polkadot.

    - + \ No newline at end of file diff --git a/docs/learn-governance.html b/docs/learn-governance.html index 9d3bebc54790..4ce64e3eb708 100644 --- a/docs/learn-governance.html +++ b/docs/learn-governance.html @@ -18,8 +18,8 @@ - - + + @@ -234,7 +234,7 @@ case for why the change should be made.

    Resources​

    - + \ No newline at end of file diff --git a/docs/learn-guides-accounts-multisig.html b/docs/learn-guides-accounts-multisig.html index 162b88f516b7..bd60121a0d14 100644 --- a/docs/learn-guides-accounts-multisig.html +++ b/docs/learn-guides-accounts-multisig.html @@ -18,8 +18,8 @@ - - + + @@ -90,7 +90,7 @@ Check the "How to use a multisig account" in the support docs on how to decode the multisig call data.

    - + \ No newline at end of file diff --git a/docs/learn-guides-accounts-proxy-pure.html b/docs/learn-guides-accounts-proxy-pure.html index 1f959bad54d8..c0b37f68c0dc 100644 --- a/docs/learn-guides-accounts-proxy-pure.html +++ b/docs/learn-guides-accounts-proxy-pure.html @@ -18,8 +18,8 @@ - - + + @@ -81,7 +81,7 @@ address but does not impact the pure proxy address. In Scenario Two, if signatories behind the pure proxies change, the address of the multisig stays the same. However, changing the number of signatories and threshold would not be possible.

    - + \ No newline at end of file diff --git a/docs/learn-guides-accounts-proxy.html b/docs/learn-guides-accounts-proxy.html index 30ad582179dc..bae12616870a 100644 --- a/docs/learn-guides-accounts-proxy.html +++ b/docs/learn-guides-accounts-proxy.html @@ -18,8 +18,8 @@ - - + + @@ -76,7 +76,7 @@ automatically ask for Charly's signature. Thus one proxy call will trigger the second one because Charly's is the only any proxy of P-C, and P-C cannot sign anything. While if we want to use Bob's account we will need to submit all three proxy calls.

    - + \ No newline at end of file diff --git a/docs/learn-guides-accounts.html b/docs/learn-guides-accounts.html index 7715daf43e56..61e3d0c8b6e3 100644 --- a/docs/learn-guides-accounts.html +++ b/docs/learn-guides-accounts.html @@ -18,8 +18,8 @@ - - + + @@ -124,7 +124,7 @@ encrypting/decrypting your wallet. If you cannot load a JSON file, please use the latest version of the wallet software. If you cannot load it, ensure that the wallet software uses the newest version of the Polkadot API.

    - + \ No newline at end of file diff --git a/docs/learn-guides-assets-create.html b/docs/learn-guides-assets-create.html index 5e933d698a46..dc4f01acdbf9 100644 --- a/docs/learn-guides-assets-create.html +++ b/docs/learn-guides-assets-create.html @@ -18,8 +18,8 @@ - - + + @@ -61,7 +61,7 @@ an ID that has already been taken. After all the details are entered, click on the next button.

    Add Asset Metadata

    • Choose the admin, issuer and the freezer accounts for your asset and click on the create button.

    Asset managing accounts

    • Sign and submit the transaction (If you like to verify the transaction details before signing, you can click on the dropdown button pointed by the arrow in the snapshot below).

    Sign asset creating transaction

    If the transaction is successful, you should see the asset and its details displayed in the Network > Assets page on the Asset Hub.

    - + \ No newline at end of file diff --git a/docs/learn-guides-assets-index.html b/docs/learn-guides-assets-index.html index af2f4c849a1d..36d9bface916 100644 --- a/docs/learn-guides-assets-index.html +++ b/docs/learn-guides-assets-index.html @@ -18,14 +18,14 @@ - - + +

    Advanced Guides for Asset Hub

    Polkadot-JS guides about the Asset Hub.

    - + \ No newline at end of file diff --git a/docs/learn-guides-assets-ledger.html b/docs/learn-guides-assets-ledger.html index dd54e78aaa3b..dd456bd1faff 100644 --- a/docs/learn-guides-assets-ledger.html +++ b/docs/learn-guides-assets-ledger.html @@ -18,8 +18,8 @@ - - + + @@ -95,7 +95,7 @@ here.
  • Transfer the desired amount as described above. If you want to send exactly the amount you want to teleport, don't forget take into account the fees for teleporting that will be deducted in the next step.
  • Teleport your tokens following the instructions you will find here.

    • Teleporting to a Ledger account from a non-Ledger account doesn't require these extra steps.

    Support​

    If you need support, please visit the Polkadot Support page.

    - + \ No newline at end of file diff --git a/docs/learn-guides-bounties.html b/docs/learn-guides-bounties.html index f5349b7a351f..49376a3f29af 100644 --- a/docs/learn-guides-bounties.html +++ b/docs/learn-guides-bounties.html @@ -18,8 +18,8 @@ - - + + @@ -76,7 +76,7 @@ delay elapsed, follow the guidelines in the video tutorial below to learn how to claim a child bounty reward. Note that the extrinsic to claim the child bounty reward is permissionless, and anyone can initiate the claim on behalf of the beneficiary.

    Claim Child Bounty Reward

    - + \ No newline at end of file diff --git a/docs/learn-guides-identity.html b/docs/learn-guides-identity.html index 993f822af02d..be9025ef828e 100644 --- a/docs/learn-guides-identity.html +++ b/docs/learn-guides-identity.html @@ -18,8 +18,8 @@ - - + + @@ -92,7 +92,7 @@ minimumDeposit.

    Submitting a proposal

    At this point, DOT holders can endorse the motion. With enough endorsements, the motion will become a referendum, which is then voted on. If it passes, users will be able to request judgement from this registrar.

    - + \ No newline at end of file diff --git a/docs/learn-guides-ledger.html b/docs/learn-guides-ledger.html index 0937407b8b2f..cbfe63cc1d03 100644 --- a/docs/learn-guides-ledger.html +++ b/docs/learn-guides-ledger.html @@ -18,8 +18,8 @@ - - + + @@ -80,7 +80,7 @@ extrinsics are available in the light version. The following repository by Zondax lists the currently supported Democracy extrinsics on the full ledger.

    - + \ No newline at end of file diff --git a/docs/learn-guides-polkadot-opengov.html b/docs/learn-guides-polkadot-opengov.html index f2f8071b0899..39d983b4cf8f 100644 --- a/docs/learn-guides-polkadot-opengov.html +++ b/docs/learn-guides-polkadot-opengov.html @@ -18,8 +18,8 @@ - - + + @@ -141,7 +141,7 @@ have been met. Failing to submit the decision deposit within a -day period will lead to a referendum timeout.

    - + \ No newline at end of file diff --git a/docs/learn-guides-staking-index.html b/docs/learn-guides-staking-index.html index 77be6bbd9233..28327fedf13b 100644 --- a/docs/learn-guides-staking-index.html +++ b/docs/learn-guides-staking-index.html @@ -18,14 +18,14 @@ - - + +

    Polkadot-JS Guides about Staking

    Polkadot-JS Guides about Staking.

    - + \ No newline at end of file diff --git a/docs/learn-guides-staking-pools.html b/docs/learn-guides-staking-pools.html index 082985ceedce..5f992018e6d9 100644 --- a/docs/learn-guides-staking-pools.html +++ b/docs/learn-guides-staking-pools.html @@ -18,8 +18,8 @@ - - + + @@ -63,7 +63,7 @@ Polkadot-JS UI Extrinsic Tab and issue the following extrisics:

    • nominationPools.claimPayoutOthers extrinsic specifying ALICE's account. This will claim the rewards as a free balance on ALICE's account.

    pools-payoutOthers

    • nominationPools.bondExtraOthers extrinsic specifying ALICE's account and the option to bond:
      • the free balance currently available in ALICE's account (FreeBalance) or
      • the pool rewards (Rewards) unclaimed by ALICE.

    pools-bondExtraOthers

    - + \ No newline at end of file diff --git a/docs/learn-guides-staking.html b/docs/learn-guides-staking.html index 28c46cbbb927..46c149fb4c2f 100644 --- a/docs/learn-guides-staking.html +++ b/docs/learn-guides-staking.html @@ -18,8 +18,8 @@ - - + + @@ -39,7 +39,7 @@ which will list all the pending payouts for your stashes.

    pending-payouts

    To then claim your reward, select the "Payout all" button. This will prompt you to select your stash accounts for payout.

    select-payouts

    Once you are done with payout, another screen will appear asking for you to sign and submit the transaction.

    transaction-payouts

    - + \ No newline at end of file diff --git a/docs/learn-guides-transfers.html b/docs/learn-guides-transfers.html index c5dd789f3e99..30818ccebe09 100644 --- a/docs/learn-guides-transfers.html +++ b/docs/learn-guides-transfers.html @@ -18,8 +18,8 @@ - - + + @@ -123,7 +123,7 @@ probably not the reason for your tokens having existing references.

    Existing Non-Native Assets​

    Currently, Polkadot does not use the Assets Pallet, so this is probably not the reason for your tokens having existing references.

    - + \ No newline at end of file diff --git a/docs/learn-guides-treasury.html b/docs/learn-guides-treasury.html index 86e45dea86e2..81579321054f 100644 --- a/docs/learn-guides-treasury.html +++ b/docs/learn-guides-treasury.html @@ -18,8 +18,8 @@ - - + + @@ -72,7 +72,7 @@ -day timeout
  • Once the referendum ends you can claim the preimage and decision deposits back
    • - + \ No newline at end of file diff --git a/docs/learn-guides-vault.html b/docs/learn-guides-vault.html index 854beee3ea4a..e9dbe2589b17 100644 --- a/docs/learn-guides-vault.html +++ b/docs/learn-guides-vault.html @@ -18,8 +18,8 @@ - - + + @@ -83,7 +83,7 @@ chain and version is the version of the metadata.

    Add the renamed files to the /public/qr folder within the Metadata Portal repository.

    Run Portal​

    Open the terminal within the Metadata Portal repository and run make updater. Then run make collector; this will create the _latest.apng files for each of the chains (removed by the command make cleaner). Finally, run yarn start to load the metadata portal on your localhost.

    - + \ No newline at end of file diff --git a/docs/learn-hyperbridge.html b/docs/learn-hyperbridge.html index 80388cee8bb5..15809f897c69 100644 --- a/docs/learn-hyperbridge.html +++ b/docs/learn-hyperbridge.html @@ -18,8 +18,8 @@ - - + + @@ -89,7 +89,7 @@ repository of hyperbridge.
  • Interoperable State Machine Protocol (ISMP) Book - Guidebook of the ISMP
  • The Puzzle of Blockchain Interoperability
  • RFC-1: Agile Coretime - Agile periodic-sale-based model for assigning Coretime on the Polkadot Ubiquitous Computer.
  • ISMP, The Endgame for Parachain Interoperability | Sub0 2023
  • Research Summary: PlonK: Permutations over Lagrange-bases for Oecumenical Noninteractive arguments of Knowledge
    • - + \ No newline at end of file diff --git a/docs/learn-identity.html b/docs/learn-identity.html index f131781815c4..b8fd22eedcd3 100644 --- a/docs/learn-identity.html +++ b/docs/learn-identity.html @@ -18,8 +18,8 @@ - - + + @@ -70,7 +70,7 @@ is required for every sub-account.

    Polkadot-JS Guides

    If you are an advanced user, see the Polkadot-JS guides about account identity.

    - + \ No newline at end of file diff --git a/docs/learn-implementations.html b/docs/learn-implementations.html index 31982192a19d..46611e46dcd1 100644 --- a/docs/learn-implementations.html +++ b/docs/learn-implementations.html @@ -18,8 +18,8 @@ - - + + @@ -57,7 +57,7 @@ collection of tools, interfaces, and libraries for Polkadot and Substrate.

    Other implementations that have received grants​

    While the ecosystem continues to grow rapidly, the continued development of alternative implementations will only make Polkadot stronger. Consider becoming a contributor to the ecosystem, and learn about the how you can receieve a grant for your development.

    - + \ No newline at end of file diff --git a/docs/learn-index.html b/docs/learn-index.html index 0c3c2e772d54..d834da837164 100644 --- a/docs/learn-index.html +++ b/docs/learn-index.html @@ -18,14 +18,14 @@ - - + +

    Learn about Polkadot

    Learn about the technology behind the Polkadot ecosystem, and the tools you can use to become a participant of Web3.

    - + \ No newline at end of file diff --git a/docs/learn-inflation.html b/docs/learn-inflation.html index c2db37d7b36c..e5ac5f62a246 100644 --- a/docs/learn-inflation.html +++ b/docs/learn-inflation.html @@ -18,8 +18,8 @@ - - + + @@ -77,7 +77,7 @@ incentivizing them to stake more tokens on the network. On the contrary, staking rewards drop if staked tokens exceed the ideal staking rate. This results from the change in the percentage of staking rewards that go to the Treasury.

    - + \ No newline at end of file diff --git a/docs/learn-launch.html b/docs/learn-launch.html index ce0dcdb71014..d06353652b5e 100644 --- a/docs/learn-launch.html +++ b/docs/learn-launch.html @@ -18,8 +18,8 @@ - - + + @@ -47,7 +47,7 @@ block number 1_205_128 on August 18, 2020, at 16:39 UTC.

    Core Functionality​

    After five years of research and development and a multi-stage launch that began in May 2020, Polkadot launch was completed on December 18, 2021, with all auction-winning parachains producing blocks on the network.

    Check out these resources for further information:

    - + \ No newline at end of file diff --git a/docs/learn-nft-pallets.html b/docs/learn-nft-pallets.html index 8fed8aa1a28e..124f25138898 100644 --- a/docs/learn-nft-pallets.html +++ b/docs/learn-nft-pallets.html @@ -18,8 +18,8 @@ - - + + @@ -112,7 +112,7 @@ balance-keeping chain for both fungible and non-fungibles.

    These NFTs can be viewed and interacted with on RMRK's Singular platform, by switching the top right menu from Kusama to the Asset Hub.

    nft-hub

    They can also be interacted with directly through the extrinsics tab of the Asset Hub:

    uniques.png

    - + \ No newline at end of file diff --git a/docs/learn-nft-projects.html b/docs/learn-nft-projects.html index ee605147f290..889f224f22a6 100644 --- a/docs/learn-nft-projects.html +++ b/docs/learn-nft-projects.html @@ -18,8 +18,8 @@ - - + + @@ -101,7 +101,7 @@ on, rather than entering the NFT space themselves as an end-product.

    Unique Network aims to make their marketplace technology open-source and whitelabel-friendly. In theory, it should be trivial to set up a new marketplace for your project using Unique's technology. Unique network aims to be a parachain on Polkadot, and Quartz is their Kusama counterpart.

    - + \ No newline at end of file diff --git a/docs/learn-nft.html b/docs/learn-nft.html index 2bfc72234035..fa5a9927f241 100644 --- a/docs/learn-nft.html +++ b/docs/learn-nft.html @@ -18,8 +18,8 @@ - - + + @@ -64,7 +64,7 @@ RMRK hackathon for porting RMRK NFTs into simplified IOUs on EVM chains

    References​

    - + \ No newline at end of file diff --git a/docs/learn-nomination-pools.html b/docs/learn-nomination-pools.html index 2e41d2886e8e..ded6cebf83f8 100644 --- a/docs/learn-nomination-pools.html +++ b/docs/learn-nomination-pools.html @@ -18,8 +18,8 @@ - - + + @@ -201,7 +201,7 @@ in the nomination pools and earn staking rewards. For additional information, see this blog post. Check the wiki doc on nomination pools for more information.

    NominatingJoining a Pool
    Minimum 250 DOT to nominate.Minimum 1 DOT to be a member.
    Rewards can be compounded automatically or sent to any account.Rewards can be manually claimed to the pool member's account and be bonded in the pool again to compound them.
    If the active validator gets slashed, all active nominators are subjected to slashing, also those that do not receive rewards due to the oversubscription issue.If the active validator gets slashed, all pool members are subjected to slashing.
    Can bond and stake DOT indefinitely.Can bond and stake DOT until the pool exists.
    Unbonding period of 28 days. Can switch validators without unbonding.Unbonding period of 28 days. Need to unbond before switching to a different pool.
    Maximum uncapped.Maximum uncapped.
    Should bond more than the minimum active nomination in an era to be eligible to earn staking rewards, although it can depend on multiple other factors outlined in the linked document.A nomination pool earns rewards in an era if it satisfies all the conditions mentioned for the nominator (as the nomination pool is just a nominator from the NPoS system perspective).
    Staked tokens can be used for participation in Governance.Staked tokens cannot be used for participation in Governance.
    Rewards payout can be triggered permissionlessly by anyone (typically done by the validator).A pool member can self claim the rewards or can grant permission to any other account to claim and compound rewards on your behalf. See Claim Permissions.
    Bonded funds remain in your account.Bonded funds are transferred to a pool account which is administered by the network protocol and is not accessible to anyone else. See System Accounts for more information.
    Nominator manages the list of staked validators (up to 16).Nominations managed by the pool operator.
    - + \ No newline at end of file diff --git a/docs/learn-nominator.html b/docs/learn-nominator.html index d0fb9aad6234..c4ef21e04199 100644 --- a/docs/learn-nominator.html +++ b/docs/learn-nominator.html @@ -18,8 +18,8 @@ - - + + @@ -266,7 +266,7 @@ Polkadot JS Apps > Network > Staking > Targets page.

    Minimum Active Nomination

    Guides​

    - + \ No newline at end of file diff --git a/docs/learn-parachains-faq.html b/docs/learn-parachains-faq.html index 690ffd27922a..e1cc90b6317b 100644 --- a/docs/learn-parachains-faq.html +++ b/docs/learn-parachains-faq.html @@ -18,8 +18,8 @@ - - + + @@ -111,7 +111,7 @@ initiate an auction, however, Root origin (via referendum) is needed to cancel an auction. Here is a proposal that gives a glimpse of what goes into planning auctions schedule - Proposed Polkadot Auction Schedule 2022.

    - + \ No newline at end of file diff --git a/docs/learn-parachains-index.html b/docs/learn-parachains-index.html index fb8f51d5eb2b..9ffbb94c94b3 100644 --- a/docs/learn-parachains-index.html +++ b/docs/learn-parachains-index.html @@ -18,14 +18,14 @@ - - + +

    Polkadot's Parachains

    Everything about Polkadot's Parachains.

    - + \ No newline at end of file diff --git a/docs/learn-parachains-protocol.html b/docs/learn-parachains-protocol.html index ad0cc184a3ce..f13c8ab0d0c7 100644 --- a/docs/learn-parachains-protocol.html +++ b/docs/learn-parachains-protocol.html @@ -18,8 +18,8 @@ - - + + @@ -272,7 +272,7 @@ Parity analyst Joe Petrowski expounds on the validity checks that a parachain block must pass in order to progress the parachain.
  • Availability and Validity - Paper by the W3F Research Team that specifies the availability and validity protocol in detail.
    • - + \ No newline at end of file diff --git a/docs/learn-parachains.html b/docs/learn-parachains.html index 77b177bf5adc..bf1b33fc3b3d 100644 --- a/docs/learn-parachains.html +++ b/docs/learn-parachains.html @@ -18,8 +18,8 @@ - - + + @@ -189,7 +189,7 @@ its own. The Relay Chain provides security to attached parachains, but also provides a guarantee of secure message-passing between them."
  • The Path of a Parachain Block - A technical walk-through of how parachains interact with the Relay Chain.
    • - + \ No newline at end of file diff --git a/docs/learn-parathreads.html b/docs/learn-parathreads.html index eb677fc8eec6..b216c291fb20 100644 --- a/docs/learn-parathreads.html +++ b/docs/learn-parathreads.html @@ -18,8 +18,8 @@ - - + + @@ -90,7 +90,7 @@ produce new blocks when they need to.

    Parathreads help ease the sharp stop of the parachain slot term by allowing parachains that are still doing something useful to produce blocks, even if it is no longer economically viable to rent a parachain slot.

    Resources​

    - + \ No newline at end of file diff --git a/docs/learn-participants-index.html b/docs/learn-participants-index.html index fc4d8e4c8cae..fe75abc962c8 100644 --- a/docs/learn-participants-index.html +++ b/docs/learn-participants-index.html @@ -18,14 +18,14 @@ - - + +

    Participants in the Polkadot Ecosystem

    Learn about collators, nominators and validators.

    - + \ No newline at end of file diff --git a/docs/learn-phragmen.html b/docs/learn-phragmen.html index 39d19d3bccab..efb3465eb84c 100644 --- a/docs/learn-phragmen.html +++ b/docs/learn-phragmen.html @@ -18,8 +18,8 @@ - - + + @@ -270,7 +270,7 @@ This paper by Brill et al. is the source for the simple Phragmén method, along with proofs about its properties.
  • Offline Phragmén - Script to generate the Phragmén validator election outcome before the start of an era.
    • - + \ No newline at end of file diff --git a/docs/learn-polkadot-host.html b/docs/learn-polkadot-host.html index 01eb93f73d17..949e1a5f086d 100644 --- a/docs/learn-polkadot-host.html +++ b/docs/learn-polkadot-host.html @@ -18,8 +18,8 @@ - - + + @@ -45,7 +45,7 @@ Host is referred to as the Executor. For additional technical implementation details, check out this section of the Polkadot Spec.

    Resources​

    - + \ No newline at end of file diff --git a/docs/learn-polkadot-js-guides.html b/docs/learn-polkadot-js-guides.html index b08fa30ab690..fd7867971c8e 100644 --- a/docs/learn-polkadot-js-guides.html +++ b/docs/learn-polkadot-js-guides.html @@ -18,8 +18,8 @@ - - + + @@ -29,7 +29,7 @@ Ledger and Polkadot Vault for signing transactions. We do not provide support for third party applications.

    - + \ No newline at end of file diff --git a/docs/learn-polkadot-opengov-index.html b/docs/learn-polkadot-opengov-index.html index 570a08efb1f0..89d1ea41e97d 100644 --- a/docs/learn-polkadot-opengov-index.html +++ b/docs/learn-polkadot-opengov-index.html @@ -18,14 +18,14 @@ - - + +

    Polkadot OpenGov

    Everything about Polkadot OpenGov.

    - + \ No newline at end of file diff --git a/docs/learn-polkadot-opengov-origins.html b/docs/learn-polkadot-opengov-origins.html index 14c4873f0628..31aaf04a8759 100644 --- a/docs/learn-polkadot-opengov-origins.html +++ b/docs/learn-polkadot-opengov-origins.html @@ -18,8 +18,8 @@ - - + + @@ -85,7 +85,7 @@

    Big Spender​

    Origin able to spend up to 1000000 DOT from the treasury at once.

    - + \ No newline at end of file diff --git a/docs/learn-polkadot-opengov-treasury.html b/docs/learn-polkadot-opengov-treasury.html index 9ba39e4d1a84..b7e476a937cd 100644 --- a/docs/learn-polkadot-opengov-treasury.html +++ b/docs/learn-polkadot-opengov-treasury.html @@ -18,8 +18,8 @@ - - + + @@ -86,7 +86,7 @@ allocation of funds and as part of a nested iteration of the bounty mechanism.

    Child Bounties​

    Child bounties are spawned from parent bounties. Child bounties are used to access funds directly from the parent bounty without going through an OpenGov referendum.

    Polkadot-JS Guides

    If you are an advanced user, see the Polkadot-JS guides about bounties and treasury.

    - + \ No newline at end of file diff --git a/docs/learn-polkadot-opengov.html b/docs/learn-polkadot-opengov.html index 2509f3a3cd7e..89dda47ec566 100644 --- a/docs/learn-polkadot-opengov.html +++ b/docs/learn-polkadot-opengov.html @@ -18,8 +18,8 @@ - - + + @@ -288,7 +288,7 @@ Delegating Voting Power section on the Polkadot OpenGov Guides.

    Resources​

    Polkadot-JS Guides

    If you are an advanced user, see the Polkadot-JS guides about OpenGov.

    - + \ No newline at end of file diff --git a/docs/learn-polkadot-technical-fellowship.html b/docs/learn-polkadot-technical-fellowship.html index cc978e3f58b6..0ded95598d20 100644 --- a/docs/learn-polkadot-technical-fellowship.html +++ b/docs/learn-polkadot-technical-fellowship.html @@ -18,8 +18,8 @@ - - + + @@ -79,7 +79,7 @@ Promotion of the Polkadot Fellowship members from rank 5 needs to be done through an OpenGov referendum. For more information, check the rank updates section on the fellowship dasboard.

    - + \ No newline at end of file diff --git a/docs/learn-polkadotjs-index.html b/docs/learn-polkadotjs-index.html index a6289ec6b5b8..36dfecb4a303 100644 --- a/docs/learn-polkadotjs-index.html +++ b/docs/learn-polkadotjs-index.html @@ -18,14 +18,14 @@ - - + +

    Polkadot-JS

    Overview of Polkadot-JS.

    - + \ No newline at end of file diff --git a/docs/learn-proxies-pure.html b/docs/learn-proxies-pure.html index a4b3f534b3f1..71c44d2a0ba1 100644 --- a/docs/learn-proxies-pure.html +++ b/docs/learn-proxies-pure.html @@ -18,8 +18,8 @@ - - + + @@ -65,7 +65,7 @@ corporate-level management where the chance of replacing someone within a multisig can be high. Pure proxies allow keeping the same multisig when the signatories change.
    Polkadot-JS Guides

    If you are an advanced user, see the Polkadot-JS guides about pure proxy accounts.

    - + \ No newline at end of file diff --git a/docs/learn-proxies.html b/docs/learn-proxies.html index 10d28e4e80a5..5e97c9346d56 100644 --- a/docs/learn-proxies.html +++ b/docs/learn-proxies.html @@ -18,8 +18,8 @@ - - + + @@ -100,7 +100,7 @@

    Polkadot-JS Guides

    If you are an advanced user, see the Polkadot-JS guides about proxy accounts. You can find information about creating and removing proxies, and more.

    - + \ No newline at end of file diff --git a/docs/learn-redenomination.html b/docs/learn-redenomination.html index 8e9bb1c38d26..cb227c5c36bc 100644 --- a/docs/learn-redenomination.html +++ b/docs/learn-redenomination.html @@ -18,8 +18,8 @@ - - + + @@ -84,7 +84,7 @@ Ecosystem Redenomination Guide for recommendations.

    Please reach out to support@polkadot.network if you need any assistance in making sure your software is compatible with the redenomination.

    - + \ No newline at end of file diff --git a/docs/learn-runtime-upgrades.html b/docs/learn-runtime-upgrades.html index 77b18a287c47..7174d56b27a0 100644 --- a/docs/learn-runtime-upgrades.html +++ b/docs/learn-runtime-upgrades.html @@ -18,8 +18,8 @@ - - + + @@ -84,7 +84,7 @@ may be up to the last block before execution, but it will not work if this is missing.
  • democracy(Executed) events for actual execution. In the case of a runtime upgrade, there will also be a system(CodeUpdated) event.

    • You can also monitor Polkassembly for discussions on on-chain proposals and referenda.

    * E.g. via pallets/democracy/storage/ReferendumInfoOf?key1=index&at=blockNumber on Sidecar.

    - + \ No newline at end of file diff --git a/docs/learn-sassafras.html b/docs/learn-sassafras.html index 84925d5576ef..86f6298206bb 100644 --- a/docs/learn-sassafras.html +++ b/docs/learn-sassafras.html @@ -18,8 +18,8 @@ - - + + @@ -31,7 +31,7 @@ with time-constant intervals. The protocol utilizes zk-SNARKs to construct a ring-VRF and is a work in progress.

    This page will be updated as progress ensues.

    Resources​

    - + \ No newline at end of file diff --git a/docs/learn-scams.html b/docs/learn-scams.html index dbf033c56074..7e30294c5c25 100644 --- a/docs/learn-scams.html +++ b/docs/learn-scams.html @@ -18,8 +18,8 @@ - - + + @@ -88,7 +88,7 @@ for steps you should take to prevent further loss and contact Polkadot Support from the same page. Finally, make sure to read the present article carefully to learn how to avoid falling victim in the future.

    - + \ No newline at end of file diff --git a/docs/learn-spree.html b/docs/learn-spree.html index ce65f9fcf190..220a0298a4d4 100644 --- a/docs/learn-spree.html +++ b/docs/learn-spree.html @@ -18,8 +18,8 @@ - - + + @@ -78,7 +78,7 @@ instances, and the next state root of the instance. They do this validation by checking it against the validate function as provided by the SPREE module API. Collators are expected to be able to provide this information to progress their parachains.

    - + \ No newline at end of file diff --git a/docs/learn-staking-advanced.html b/docs/learn-staking-advanced.html index 065877bc3071..fdc220c96c4d 100644 --- a/docs/learn-staking-advanced.html +++ b/docs/learn-staking-advanced.html @@ -18,8 +18,8 @@ - - + + @@ -313,7 +313,7 @@ which is a fixed amount.

    Further Resources​

    If you want to run a staking miner on your validator, refer to the repository provided in the resources section below.

    - + \ No newline at end of file diff --git a/docs/learn-staking-index.html b/docs/learn-staking-index.html index c3320ec283ce..34e63bd390d2 100644 --- a/docs/learn-staking-index.html +++ b/docs/learn-staking-index.html @@ -18,14 +18,14 @@ - - + +

    Polkadot-JS Guides about Staking

    Polkadot-JS Guides about Staking.

    - + \ No newline at end of file diff --git a/docs/learn-staking.html b/docs/learn-staking.html index 821c75d6c93f..c3acc18c0e8c 100644 --- a/docs/learn-staking.html +++ b/docs/learn-staking.html @@ -18,8 +18,8 @@ - - + + @@ -371,7 +371,7 @@ Blog post by Web3 Foundation researcher Alfonso Cevallos covering NPoS in Polkadot.
  • Validator setup
  • Polkadot validator selector tool - A tool that helps nominators find reliable validators that meet quality-control criteria, including commission rates, verified identity, etc.
    • Polkadot-JS Guides

    If you are an advanced user, see the Polkadot-JS guides about staking.

    - + \ No newline at end of file diff --git a/docs/learn-system-chains.html b/docs/learn-system-chains.html index a23da98c4f18..d7b90466a575 100644 --- a/docs/learn-system-chains.html +++ b/docs/learn-system-chains.html @@ -18,8 +18,8 @@ - - + + @@ -87,7 +87,7 @@ isolation provided by parachains.

    See the Bridges page for information on the latest bridge projects. Currently, a Bridge Hub parachain is in development that will be a portal for trust-minimized bridges to other networks.

    - + \ No newline at end of file diff --git a/docs/learn-teleport.html b/docs/learn-teleport.html index 31349d8c376b..ba1b0be55f23 100644 --- a/docs/learn-teleport.html +++ b/docs/learn-teleport.html @@ -18,8 +18,8 @@ - - + + @@ -48,7 +48,7 @@ teleportation should result in the same circulating supply of the asset, and failing to uphold this condition will result in a change in the asset's total issuance (in the case of fungible tokens) or a complete loss/duplication of an NFT.

    - + \ No newline at end of file diff --git a/docs/learn-transaction-fees.html b/docs/learn-transaction-fees.html index 23fb778d36fe..abc85a10f24d 100644 --- a/docs/learn-transaction-fees.html +++ b/docs/learn-transaction-fees.html @@ -18,8 +18,8 @@ - - + + @@ -99,7 +99,7 @@ to free storage (e.g. clear their IDE).
  • Burns: A transaction may burn funds internally based on its logic. For example, a transaction may burn funds from the sender if it creates new storage entries, thus increasing the state size.
  • Limits: Some limits are part of the protocol. For example, nominators can only nominate 16 validators. This limits the complexity of Phragmén.

    • Learn More​

    - + \ No newline at end of file diff --git a/docs/learn-transactions.html b/docs/learn-transactions.html index 80d68ba0711c..83b33e86665e 100644 --- a/docs/learn-transactions.html +++ b/docs/learn-transactions.html @@ -18,8 +18,8 @@ - - + + @@ -99,7 +99,7 @@ the fee will go to the block producer, producers will include the transactions with the highest fees to maximize their reward.

    Polkadot-JS Guides

    If you are an advanced user, see the Polkadot-JS guides about transfers.

    - + \ No newline at end of file diff --git a/docs/learn-treasury.html b/docs/learn-treasury.html index 60d5fbd8e521..339294e09048 100644 --- a/docs/learn-treasury.html +++ b/docs/learn-treasury.html @@ -18,8 +18,8 @@ - - + + @@ -164,7 +164,7 @@ taking place. The time delay then allows chain participants time to respond. The response may take the form of governance measures or - in the most extreme cases a liquidation of their holdings and a migration to a minority fork. However, the possibility of this scenario is quite low.

    Further Reading​

    - + \ No newline at end of file diff --git a/docs/learn-validator.html b/docs/learn-validator.html index 738c9863146b..b140ac610a4d 100644 --- a/docs/learn-validator.html +++ b/docs/learn-validator.html @@ -18,8 +18,8 @@ - - + + @@ -95,7 +95,7 @@ statistics.
  • YieldScan - Staking yield maximization platform, designed to minimize effort.
  • Subscan Validators Page - Displays information on the current validators - not as tailored for validators as the other sites.
    • - + \ No newline at end of file diff --git a/docs/learn-video-tutorials.html b/docs/learn-video-tutorials.html index b3086658bad2..5bed33c56e20 100644 --- a/docs/learn-video-tutorials.html +++ b/docs/learn-video-tutorials.html @@ -18,8 +18,8 @@ - - + + @@ -27,7 +27,7 @@

    Videos about Polkadot

    Visit the Polkadot YouTube Channel

    For more videos see all playlists on the Polkadot YouTube channel.

    Ongoing Series​

    Learn about Polkadot and Substrate at a deeper level with these ongoing deep dives, technical seminars, and initiatives within the ecosystem.

    Technical Explainers

    Substrate Seminars

    Polkadot Deep Dives

    Polkadot Community Calls

    Polkadot Decoded 2023

    Polkadot Blockchain Academy

    Past Events​

    Polkadot for Beginners

    ETH Denver 2023

    Encode Polkadot Club

    Sub0 2022

    Polkadot Decoded 2022

    Polkadot in Davos 2022

    Polkadot Webminars

    Hackathon North America

    Hackathon Global Series

    - + \ No newline at end of file diff --git a/docs/learn-wasm.html b/docs/learn-wasm.html index 61c68a699d08..dbc588407580 100644 --- a/docs/learn-wasm.html +++ b/docs/learn-wasm.html @@ -18,8 +18,8 @@ - - + + @@ -35,7 +35,7 @@ spec.
  • Wasmi - WebAssembly interpreter written in Rust.
  • Parity Wasm - WebAssembly serialization/deserialization in Rust.
  • Wasm utils - Collection of Wasm utilities used in Parity and Wasm contract development.
    • - + \ No newline at end of file diff --git a/docs/learn-xcm-index.html b/docs/learn-xcm-index.html index a2e14657a934..92773896c1f6 100644 --- a/docs/learn-xcm-index.html +++ b/docs/learn-xcm-index.html @@ -18,14 +18,14 @@ - - + +

    Polkadot's XCM

    Polkadot's Cross-Consensus Messaging Format (XCM).

    - + \ No newline at end of file diff --git a/docs/learn-xcm-instructions.html b/docs/learn-xcm-instructions.html index 25748f4cdee4..ddeb25943697 100644 --- a/docs/learn-xcm-instructions.html +++ b/docs/learn-xcm-instructions.html @@ -18,8 +18,8 @@ - - + + @@ -37,7 +37,7 @@ system and may not be transferred. It may only be unlocked with the receipt of the UnlockAsset instruction from this chain.

  • RequestUnlock(MultiAsset, MultiLocation) - Send an UnlockAsset instruction to the locker for the given asset.

    • - + \ No newline at end of file diff --git a/docs/learn-xcm-pallet.html b/docs/learn-xcm-pallet.html index 67d04865a5ed..a3d60c30d6e8 100644 --- a/docs/learn-xcm-pallet.html +++ b/docs/learn-xcm-pallet.html @@ -18,8 +18,8 @@ - - + + @@ -87,7 +87,7 @@ calculates the total fee based on the number of instructions.

    The Trader used to calculate the weight (time for computation in consensus) to include in the message. Fee calculation in XCM is highly configurable and, for this reason, subjective to whichever configuration is in place.

    - + \ No newline at end of file diff --git a/docs/learn-xcm-transport.html b/docs/learn-xcm-transport.html index 8d76036235ab..919812735b86 100644 --- a/docs/learn-xcm-transport.html +++ b/docs/learn-xcm-transport.html @@ -18,8 +18,8 @@ - - + + @@ -69,7 +69,7 @@ asset transfer as intended.

    The collator now hands this block to the validator, which itself will verify that this message was processed. If the message was processed and all other aspects of the block are valid, the validator will include this block for parachain B into the Relay Chain.

    - + \ No newline at end of file diff --git a/docs/learn-xcm-usecases.html b/docs/learn-xcm-usecases.html index 172b5d283bd3..9a26ba8fc5a4 100644 --- a/docs/learn-xcm-usecases.html +++ b/docs/learn-xcm-usecases.html @@ -18,8 +18,8 @@ - - + + @@ -46,7 +46,7 @@ destination's sovereign account, and sends this instruction onwards to the destination. The destination receives the instruction and processes it, minting the derivative assets as a result of the process.

    1. DepositAsset

    The destination deposits the derivative assets minted to the receiving account.

    - + \ No newline at end of file diff --git a/docs/learn-xcm.html b/docs/learn-xcm.html index 8b28587b058d..b3501e8059de 100644 --- a/docs/learn-xcm.html +++ b/docs/learn-xcm.html @@ -18,8 +18,8 @@ - - + + @@ -92,7 +92,7 @@ Technical audit report by Quarkslab prepared for Parity.

  • XCM pallet code - The pallet that contains XCM logic from the Polkadot code repository

  • XCM Config & Pallet-XCM | Polkadot Deep Dives - A technical deep dive into pallet-xcm and the XCM configuration.

    • - + \ No newline at end of file diff --git a/docs/learn-xcvm.html b/docs/learn-xcvm.html index e35624419522..c6c8bb84f391 100644 --- a/docs/learn-xcvm.html +++ b/docs/learn-xcvm.html @@ -18,8 +18,8 @@ - - + + @@ -110,7 +110,7 @@ a MultiLocation.

    Simulating XCVM using the xcm-simulator​

    Within the Polkadot repository exists the xcm-simulator, which allows developers to experiment with building, executing, and simulating various XCM use scenarios.

    - + \ No newline at end of file diff --git a/docs/learn/xcm.html b/docs/learn/xcm.html index cc8fcb092481..addcb39ca887 100644 --- a/docs/learn/xcm.html +++ b/docs/learn/xcm.html @@ -18,14 +18,14 @@ - - + +

    XCM Documentation

    In-depth documentation about the Polkadot's Cross-Chain Messaging (XCM).

    - + \ No newline at end of file diff --git a/docs/learn/xcm/config-deep-dive.html b/docs/learn/xcm/config-deep-dive.html index e2ff6a27ebae..889ef1b01fd1 100644 --- a/docs/learn/xcm/config-deep-dive.html +++ b/docs/learn/xcm/config-deep-dive.html @@ -18,8 +18,8 @@ - - + + @@ -132,7 +132,7 @@ Statemine, or Trappist for examples of how to implement the xcm-executor config.

    - + \ No newline at end of file diff --git a/docs/learn/xcm/fundamentals-fees.html b/docs/learn/xcm/fundamentals-fees.html index 5a0a5d51e1a2..74d4bce26314 100644 --- a/docs/learn/xcm/fundamentals-fees.html +++ b/docs/learn/xcm/fundamentals-fees.html @@ -18,8 +18,8 @@ - - + + @@ -56,7 +56,7 @@ and charging execution fees.

    XCM pallet​

    FRAME pallets, like the XCM pallet, specify weights for each extrinsic they expose. That means that when interacting with pallets that deal with XCM, there will be an additional fee at the beginning for calling the extrinsic locally.

    - + \ No newline at end of file diff --git a/docs/learn/xcm/fundamentals-multiasset.html b/docs/learn/xcm/fundamentals-multiasset.html index 0d07191ab1c7..51fb6bb839cf 100644 --- a/docs/learn/xcm/fundamentals-multiasset.html +++ b/docs/learn/xcm/fundamentals-multiasset.html @@ -18,8 +18,8 @@ - - + + @@ -56,7 +56,7 @@ MultiAssets and WildMultiAsset allowing either a wildcard or a list of definite (i.e. not wildcard) assets to be specified.

    pub enum MultiAssetFilter {
        /// Specify the filter as being everything contained by the given `MultiAssets` inner.
        Definite(MultiAssets),
        /// Specify the filter as the given `WildMultiAsset` wildcard.
        Wild(WildMultiAsset),
    }

    Examples​

    MultiAsset​

    For more information about the MultiLocations used to define concrete assets, see MultiLocation and Junction.

    // Location Relay Chain
    // 100 Native Asset (three ways)
    MultiAsset {id: Concrete(MultiLocation {parents: 0, interior: Here}), fun: Fungible(100u128)};
    MultiAsset {id: Here.into(), fun: 100.into()};
    let _: MultiAsset = (Here, 100u128).into();

    // 100 Parachain's Native Asset
    let _: MultiAsset = (X1(Parachain(1000)), 100u128).into();
    // 100 Fungible assets in Parachain 1000 with id 1234
    let _: MultiAsset = (X2(Parachain(1000), GeneralIndex(1234)), 100u128).into();
    // Non Fungible asset with asset class 1234 containing only one nft instance in Parachain 1000
    let _: MultiAsset = (X2(Parachain(1000), GeneralIndex(1234)), Undefined).into();
    // Non Fungible asset with asset class 1234 and AssetInstance 1 in Parachain 1000
    let _: MultiAsset = (X2(Parachain(1000), GeneralIndex(1234)), Index(1)).into();

    MultiAssetFilter​

    let a1: MultiAssets = MultiAssets::from(vec![MultiAsset {id: Here.into(), fun: 100u128.into()}]);
    let b1: MultiAssets = (Here, 100u128).into();
    assert_eq!(a1, b1);

    let a2: MultiAssetFilter = a1.into();
    let b2 = MultiAssetFilter::Definite((Here, 100u128).into());
    assert_eq!(a2, b2);

    let a3 = MultiAssetFilter::Wild(WildMultiAsset::All);
    let b3: MultiAssetFilter = All.into();
    assert_eq!(a3, b3);
    - + \ No newline at end of file diff --git a/docs/learn/xcm/fundamentals-summary.html b/docs/learn/xcm/fundamentals-summary.html index ad688b574e71..387c3dca810a 100644 --- a/docs/learn/xcm/fundamentals-summary.html +++ b/docs/learn/xcm/fundamentals-summary.html @@ -18,15 +18,15 @@ - - + +

    Fundamentals

    In this chapter we explore all the fundamentals that you should understand before diving deeper into XCM.

    - + \ No newline at end of file diff --git a/docs/learn/xcm/fundamentals-xcvm.html b/docs/learn/xcm/fundamentals-xcvm.html index 918aa6428f37..56adab8d58b6 100644 --- a/docs/learn/xcm/fundamentals-xcvm.html +++ b/docs/learn/xcm/fundamentals-xcvm.html @@ -18,14 +18,14 @@ - - + +

    XCVM

    We've already seen an overview of the XCVM. In this section, we'll dive deeper into how it works.

    Coming soon​

    This chapter is still being worked on.

    - + \ No newline at end of file diff --git a/docs/learn/xcm/fundamentals.html b/docs/learn/xcm/fundamentals.html index c534a8103a54..c0d4567ad1f3 100644 --- a/docs/learn/xcm/fundamentals.html +++ b/docs/learn/xcm/fundamentals.html @@ -18,14 +18,14 @@ - - + +

    Fundamentals

    Fundamental Concepts about XCM.

    - + \ No newline at end of file diff --git a/docs/learn/xcm/fundamentals/multilocation-example.html b/docs/learn/xcm/fundamentals/multilocation-example.html index 5dd96b9b6074..ae05d028d026 100644 --- a/docs/learn/xcm/fundamentals/multilocation-example.html +++ b/docs/learn/xcm/fundamentals/multilocation-example.html @@ -18,15 +18,15 @@ - - + +

    Example

    In this example we show different MultiLocations for the system hierarchy in the image below. -Example

    From the perspective of RelayA

    // ParaA
    let _: MultiLocation = Parachain(1000).into();
    // AccountId32 in Parachain A
    let _: MultiLocation = (Parachain(1000), AccountId32 { network: RELAY_A_NETWORK, id: [0u8; 32]}).into();
    // Asset in Parachain A
    let _: MultiLocation = (Parachain(1000), PalletInstance(1), GeneralIndex(1)).into();
    // Ethereum based account on Parachain B
    let _: MultiLocation = (Parachain(2000), AccountKey20 { network: RELAY_A_NETWORK, key: [0u8; 20] }).into();
    // Smart Contract
    let _: MultiLocation = (Parachain(2000), PalletInstance(1), AccountKey20 { network: RELAY_A_NETWORK, key: [0u8; 20] }).into();
    // RelayB
    let _: MultiLocation = (Parent, GlobalConsensus(RELAY_B_NETWORK)).into();
    // NFT on Parachain C
    let _: MultiLocation = (Parent, GlobalConsensus(RELAY_B_NETWORK), Parachain(1000), GeneralIndex(1)).into();

    From the perspective of Parachain C

    // Relay A
    let _: MultiLocation = Parent.into();
    // Plurality Example. Many more BodyId/BodyPart combos imaginable
    let _: MultiLocation = (Parent, Plurality { id: BodyId::Index(0), part: BodyPart::Members { count: 10 } }).into();
    // Account in Relay
    let _: MultiLocation = (Parent, AccountId32 { network: None, id: [0u8; 32] }).into();

    From the perspective of the Smart Contract

    // Asset in Parachain A
    let _: MultiLocation = (Parent, Parent, Parachain(1000), PalletInstance(1), GeneralIndex(1)).into();

    - +Example

    From the perspective of RelayA

    // ParaA
    let _: MultiLocation = Parachain(1000).into();
    // AccountId32 in Parachain A
    let _: MultiLocation = (Parachain(1000), AccountId32 { network: RELAY_A_NETWORK, id: [0u8; 32]}).into();
    // Asset in Parachain A
    let _: MultiLocation = (Parachain(1000), PalletInstance(1), GeneralIndex(1)).into();
    // Ethereum based account on Parachain B
    let _: MultiLocation = (Parachain(2000), AccountKey20 { network: RELAY_A_NETWORK, key: [0u8; 20] }).into();
    // Smart Contract
    let _: MultiLocation = (Parachain(2000), PalletInstance(1), AccountKey20 { network: RELAY_A_NETWORK, key: [0u8; 20] }).into();
    // RelayB
    let _: MultiLocation = (Parent, GlobalConsensus(RELAY_B_NETWORK)).into();
    // NFT on Parachain C
    let _: MultiLocation = (Parent, GlobalConsensus(RELAY_B_NETWORK), Parachain(1000), GeneralIndex(1)).into();

    From the perspective of Parachain C

    // Relay B
    let _: MultiLocation = Parent.into();
    // Plurality Example. Many more BodyId/BodyPart combos imaginable
    let _: MultiLocation = (Parent, Plurality { id: BodyId::Index(0), part: BodyPart::Members { count: 10 } }).into();
    // Account in Relay
    let _: MultiLocation = (Parent, AccountId32 { network: None, id: [0u8; 32] }).into();

    From the perspective of the Smart Contract

    // Asset in Parachain A
    let _: MultiLocation = (Parent, Parent, Parachain(1000), PalletInstance(1), GeneralIndex(1)).into();

    + \ No newline at end of file diff --git a/docs/learn/xcm/fundamentals/multilocation-junctions.html b/docs/learn/xcm/fundamentals/multilocation-junctions.html index bc02b18693f2..ef41fb57d56c 100644 --- a/docs/learn/xcm/fundamentals/multilocation-junctions.html +++ b/docs/learn/xcm/fundamentals/multilocation-junctions.html @@ -18,8 +18,8 @@ - - + + @@ -59,7 +59,7 @@ relay chain from the perspective of the Polkadot relay chain as {parents: 1, interior: GlobalConsensus(Kusama)}. An example use case could be routing XCMs between global consensus networks using bridges.

    Multiple ways to create a MultiLocation​

    // Current Location
    MultiLocation {parents: 0, interior: Here};
    MultiLocation::new(0, Here);
    MultiLocation::here();
    MultiLocation::default();
    let _: MultiLocation = Here.into();

    // Parent Location
    MultiLocation {parents: 1, interior: Here};
    MultiLocation::parent();
    let _: MultiLocation = Parent.into();

    // Conversion
    MultiLocation { parents: 2, interior: X2(Parachain(1), GeneralIndex(1))};
    let _: MultiLocation = (Parent, Parent, Parachain(1), GeneralIndex(1)).into();
    - + \ No newline at end of file diff --git a/docs/learn/xcm/fundamentals/multilocation-summary.html b/docs/learn/xcm/fundamentals/multilocation-summary.html index f9133148e4cf..6266a40c94ed 100644 --- a/docs/learn/xcm/fundamentals/multilocation-summary.html +++ b/docs/learn/xcm/fundamentals/multilocation-summary.html @@ -18,8 +18,8 @@ - - + + @@ -54,7 +54,7 @@ .. are followed by some number of Junctions, all separated by /. The X1 and X2 variants are expressing the number of Junctions that we step down in the hierarchical structure (see Junctions for an explanation).

    // From: RelayA
    // To: ParaB
    // Location: Parachain(2000)
    MultiLocation {parents: 0, interior: X1(Parachain(2000))};
    // To: Account in ParaA
    // Location: Parachain(1000)/AccountId32(0x00..)
    MultiLocation {
        parents: 0,
        interior: X2(
            Parachain(1000),
            AccountId32{network: None, id: [0u8; 32]}
        )
    };

    // From: ParaB
    // To: RelayA
    // Location: ../Here
    MultiLocation {parents: 1, interior: Here};
    // To: Account in ParaA
    // Location: ../Parachain(1000)/AccountId32(0x00..)
    MultiLocation {
        parents: 1,
        interior: X2(
            Parachain(1000),
            AccountId32{network: None, id: [0u8; 32]}
        )
    };

    What's next:​

    • More information about junctions
    • More MultiLocation examples
    • Expressing assets using Multilocations: [MultiAsset][../multiasset.md]
    - + \ No newline at end of file diff --git a/docs/learn/xcm/fundamentals/multilocation.html b/docs/learn/xcm/fundamentals/multilocation.html index 954e0dbcfd03..7118e50cb3d8 100644 --- a/docs/learn/xcm/fundamentals/multilocation.html +++ b/docs/learn/xcm/fundamentals/multilocation.html @@ -18,14 +18,14 @@ - - + +

    MultiLocation

    The MultiLocation Type.

    - + \ No newline at end of file diff --git a/docs/learn/xcm/introduction.html b/docs/learn/xcm/introduction.html index 3564db7b2999..7095fb916036 100644 --- a/docs/learn/xcm/introduction.html +++ b/docs/learn/xcm/introduction.html @@ -18,8 +18,8 @@ - - + + @@ -35,7 +35,7 @@ open an issue. If you want to contribute to the format, check out the RFC process.

    - + \ No newline at end of file diff --git a/docs/learn/xcm/journey-assets.html b/docs/learn/xcm/journey-assets.html index 64e47128fe05..624a85864ce4 100644 --- a/docs/learn/xcm/journey-assets.html +++ b/docs/learn/xcm/journey-assets.html @@ -18,8 +18,8 @@ - - + + @@ -42,7 +42,7 @@ relay chain. The assets are trapped because an error is thrown and the execution is halted. Parachain A claims the trapped assets and receives a report of the holding register.

    Parachain A sends the following message to the relay chain. The message errors because of the Trap instruction, so all assets in the Holding Register are trapped.

    let message = Xcm(vec![
        WithdrawAsset((Here, 10 * CENTS).into()),
        BuyExecution { fees: (Here, CENTS).into(), weight_limit: WeightLimit::Unlimited },
        Trap(0), // <-- Errors
        DepositAsset { // <-- Not executed because of error.
            assets: All.into(),
            beneficiary: AccountId32 {
                network: Some(parachain::RelayNetwork::get()),
                id: ALICE.into()
            }.into()
        }
    ]);

    Parachain A claims the assets, reports them to itself and deposits them in the Account of Alice.

    let claim_message = Xcm(vec![
        ClaimAsset { assets: (Here, 10 * CENTS).into(), ticket: Here.into() },
        ReportHolding {
            response_info: QueryResponseInfo {
                destination: Parachain(1).into(),
                query_id: QUERY_ID,
                max_weight: Weight::from_parts(1_000_000_000, 64*64) },
            assets: All.into()
        },
        DepositAsset {
            assets: All.into(),
            beneficiary: AccountId32 {
                network: Some(parachain::RelayNetwork::get()),
                id: ALICE.into()
            }.into()
        },
    ]);
    - + \ No newline at end of file diff --git a/docs/learn/xcm/journey-channels.html b/docs/learn/xcm/journey-channels.html index 8fdafb730f41..b95256d2d082 100644 --- a/docs/learn/xcm/journey-channels.html +++ b/docs/learn/xcm/journey-channels.html @@ -18,8 +18,8 @@ - - + + @@ -51,7 +51,7 @@ network), you would call with network: NetworkId::Kusama and destination: X1(Parachain(1000)). Alternatively, to export a message for execution on Polkadot, you would call with network: NetworkId:: Polkadot and destination: Here.

    - + \ No newline at end of file diff --git a/docs/learn/xcm/journey-expectations.html b/docs/learn/xcm/journey-expectations.html index 4b4f5e947bf0..0e7898e26d41 100644 --- a/docs/learn/xcm/journey-expectations.html +++ b/docs/learn/xcm/journey-expectations.html @@ -18,8 +18,8 @@ - - + + @@ -44,7 +44,7 @@ the error handler, when a specific error is thrown.

        ExpectError(Option<(u32, Error)>)

    Example​

    For the full example, check here.

    SetErrorHandler(Xcm(vec![
        ExpectError(Some((1, XcmError::VersionIncompatible))),
        ReportError(QueryResponseInfo {
            destination: Parachain(1).into(),
            query_id: QUERY_ID,
            max_weight: Weight::from_all(0),
        }),
    ])),
    // Pallet index is wrong, so throws `PalletNotFound` error.
    ExpectPallet {
        index: 100,
        name: "Balances".into(),
        module_name: "pallet_balances".into(),
        crate_major: 4,
        min_crate_minor: 0,
    },

    ExpectTransactStatus​

    The ExpectTransactStatus instruction throws an ExpectationFalse error if the transact status register does not equal the expected transact status.

    Example​

    For the full example, check here. The transact status is reported to Parachain(1) if the call in the Transact errors.

    SetErrorHandler(Xcm(vec![ReportTransactStatus(QueryResponseInfo {
        destination: Parachain(1).into(),
        query_id: QUERY_ID,
        max_weight: Weight::from_all(0),
    })])),
    Transact {
        origin_kind: OriginKind::SovereignAccount,
        require_weight_at_most: Weight::from_parts(INITIAL_BALANCE as u64, 1024 * 1024),
        call: call.encode().into(),
    },
    ExpectTransactStatus(MaybeErrorCode::Success),
    - + \ No newline at end of file diff --git a/docs/learn/xcm/journey-fees.html b/docs/learn/xcm/journey-fees.html index 6d614c19b29f..3a3d64523817 100644 --- a/docs/learn/xcm/journey-fees.html +++ b/docs/learn/xcm/journey-fees.html @@ -18,8 +18,8 @@ - - + + @@ -62,7 +62,7 @@ throws an error, the error handler will be called and the weight for all the instructions that weren't executed is refunded. For the full example, check our repo.

    - + \ No newline at end of file diff --git a/docs/learn/xcm/journey-holding.html b/docs/learn/xcm/journey-holding.html index 6fa54e907eff..266f5c7913d8 100644 --- a/docs/learn/xcm/journey-holding.html +++ b/docs/learn/xcm/journey-holding.html @@ -18,8 +18,8 @@ - - + + @@ -47,7 +47,7 @@ results could differ.

    The Assets in the exchange in Parachain(1). This is a custom exchange implementation just for testing purposes.

    let assets_in_exchange = vec![(Parent, 10 * CENTS).into()];
    parachain::set_exchange_assets(assets_in_exchange);

    The message that is send:

    let message = Xcm(vec![
        WithdrawAsset((Here, 10 * CENTS).into()),
        BuyExecution { fees: (Here, CENTS).into(), weight_limit: WeightLimit::Unlimited },
        // Maximal field set to true.
        ExchangeAsset {
            give: Definite((Here, 5 * CENTS).into()),
            want: (Parent, 5 * CENTS).into(),
            maximal: true,
        },
        DepositAsset {
            assets: AllCounted(2).into(),
            beneficiary: AccountId32 {
                network: Some(parachain::RelayNetwork::get()),
                id: ALICE.into(),
            }
            .into(),
        },
    ]);

    Alice receives 5 CENTS worth of native assets (Here) and 5 CENTS worth of relay chain derivative assets (Parent).

    - + \ No newline at end of file diff --git a/docs/learn/xcm/journey-locks.html b/docs/learn/xcm/journey-locks.html index 03f1a2756a18..d355c7ab98ea 100644 --- a/docs/learn/xcm/journey-locks.html +++ b/docs/learn/xcm/journey-locks.html @@ -18,8 +18,8 @@ - - + + @@ -55,7 +55,7 @@ pallet-balances: 10.
    ParaA::execute_with(|| {
        let message = Xcm(vec![
            LockAsset { asset: (Here, 10 * CENTS).into(), unlocker: (Parachain(2)).into() },
            LockAsset { asset: (Here, 5 * CENTS).into(), unlocker: (Parachain(3)).into() },
        ]);
        assert_ok!(ParachainPalletXcm::send_xcm(Here, Parent, message.clone()));
    });

    Relay::execute_with(|| {
        assert_eq!(
            relay_chain::Balances::locks(&parachain_sovereign_account_id(1)),
            vec![BalanceLock { id: *b"py/xcmlk", amount: 10 * CENTS, reasons: Reasons::All }]
        );
    });
    1. Parachain B and C receive the NoteUnlockable instruction.
    ParaB::execute_with(|| {
        assert_eq!(
            parachain::MsgQueue::received_dmp(),
            vec![Xcm(vec![NoteUnlockable {
                owner: (Parent, Parachain(1)).into(),
                asset: (Parent, 10 * CENTS).into()
            }])]
        );
    });

    ParaC::execute_with(|| {
        assert_eq!(
            parachain::MsgQueue::received_dmp(),
            vec![Xcm(vec![NoteUnlockable {
                owner: (Parent, Parachain(1)).into(),
                asset: (Parent, 5 * CENTS).into()
            }])]
        );
    });
    1. Parachain A sends a RequestUnlock instruction to Parachain B for 8 CENTS.
    ParaA::execute_with(|| {
        let message = Xcm(vec![RequestUnlock {
            asset: (Parent, 8 * CENTS).into(),
            locker: Parent.into(),
        }]);

        assert_ok!(ParachainPalletXcm::send_xcm(Here, (Parent, Parachain(2)), message.clone()));
    });
    1. Parachain B Unlocks a part of the funds by sending an UnlockAsset to the relay chain. we check the lock in the balances-pallet. Unlockers: B, C; Funds registered in pallet-xcm: 2, 5. Lock set in pallet-balances: 5.
    Relay::execute_with(|| {
        assert_eq!(
            relay_chain::Balances::locks(&parachain_sovereign_account_id(1)),
            vec![BalanceLock { id: *b"py/xcmlk", amount: 5 * CENTS, reasons: Reasons::All }]
        );
    });
    - + \ No newline at end of file diff --git a/docs/learn/xcm/journey-origin.html b/docs/learn/xcm/journey-origin.html index 9757207cd3cb..440c206bb5c7 100644 --- a/docs/learn/xcm/journey-origin.html +++ b/docs/learn/xcm/journey-origin.html @@ -18,8 +18,8 @@ - - + + @@ -47,7 +47,7 @@ for certain values of X (thereby allowing sibling chains to use the same account IDs) or Parachain(X)/ (allowing a Relay-chain to use the account IDs native to its child parachains) or just Parent/ (allowing parachains to use AccountIds of the Relay-chain).

    - + \ No newline at end of file diff --git a/docs/learn/xcm/journey-queries.html b/docs/learn/xcm/journey-queries.html index d7baec32ce7e..a410c1f97658 100644 --- a/docs/learn/xcm/journey-queries.html +++ b/docs/learn/xcm/journey-queries.html @@ -18,8 +18,8 @@ - - + + @@ -51,7 +51,7 @@ specified destination.

    ReportTransactStatus(QueryResponseInfo)

    Example​

    For the full example, check here. Dispatches a call on the consensus system receiving this Xcm and reports back the status of the Transact Status Register.

    Xcm(vec![
        Transact {
            origin_kind: OriginKind::SovereignAccount,
            require_weight_at_most: Weight::from_parts(INITIAL_BALANCE as u64, 1024 * 1024),
            call: remark.encode().into(),
        },
        ReportTransactStatus(QueryResponseInfo {
            destination: Parachain(1).into(),
            query_id: QUERY_ID,
            max_weight: Weight::from_all(0),
        }),
    ]);
    - + \ No newline at end of file diff --git a/docs/learn/xcm/journey-register.html b/docs/learn/xcm/journey-register.html index 0fb6809ff7b8..a13dc62cb640 100644 --- a/docs/learn/xcm/journey-register.html +++ b/docs/learn/xcm/journey-register.html @@ -18,8 +18,8 @@ - - + + @@ -33,7 +33,7 @@ and error handler instruction are executed. These instructions are executed regardless of whether an error occurred.

    ClearError​

    ClearError

    The ClearError instruction clears the Error Register by setting it to None.

    ClearTransactStatus​

    ClearTransactStatus

    The ClearTransactStatus instruction sets the Transact Status Register to its default, cleared, value.

    SetTopic​

    SetTopic([u8; 32])

    The SetTopic instruction sets the Topic Register.

    ClearTopic​

    ClearTopic

    The ClearTopic instruction clears the Topic Register.

    - + \ No newline at end of file diff --git a/docs/learn/xcm/journey-summary.html b/docs/learn/xcm/journey-summary.html index 8c7d34b646de..32e3e91b20d0 100644 --- a/docs/learn/xcm/journey-summary.html +++ b/docs/learn/xcm/journey-summary.html @@ -18,8 +18,8 @@ - - + + @@ -27,7 +27,7 @@

    A Journey through XCM

    This section will be a step-by-step, practical introduction to all the features XCM has. We'll create XCMs for a variety of use cases, learning about all the instructions available to us along the way. Let's step right in.

    - + \ No newline at end of file diff --git a/docs/learn/xcm/journey-transact.html b/docs/learn/xcm/journey-transact.html index ca46f2aee732..819bda70e782 100644 --- a/docs/learn/xcm/journey-transact.html +++ b/docs/learn/xcm/journey-transact.html @@ -18,8 +18,8 @@ - - + + @@ -50,7 +50,7 @@ Parachain(1). This function requires the origin to be root. We enable the root origin for the relay chain by setting ParentAsSuperuser for the OriginConverter config type.

    let call = parachain::RuntimeCall::Balances(
        pallet_balances::Call::<parachain::Runtime>::set_balance {
            who: ALICE,
            new_free: 5 * AMOUNT,
            new_reserved: 0,
        },
    );

    let message = Xcm(vec![
        WithdrawAsset((Here, AMOUNT).into()),
        BuyExecution { fees: (Here, AMOUNT).into(), weight_limit: WeightLimit::Unlimited },
        Transact {
            origin_kind: OriginKind::Superuser,
            require_weight_at_most: Weight::from_parts(INITIAL_BALANCE as u64, 1024 * 1024),
            call: call.encode().into(),
        },
    ]);

    Example 2​

    For the full example, check the repo.

    In this example, as Parachain(1), we create an NFT collection on the relay chain and we then mint an NFT with ID 1. The admin for the nft collection is parachain(1). The call looks as follows:

    let create_collection = relay_chain::RuntimeCall::Uniques(
        pallet_uniques::Call::<relay_chain::Runtime>::create {
            collection: 1u32,
            admin: parachain_sovereign_account_id(1),
        }
    );

    The owner of the NFT is Alice. The nft mint call looks as follows:

    let mint = relay_chain::RuntimeCall::Uniques(
        pallet_uniques::Call::<relay_chain::Runtime>::mint {
            collection: 1u32,
            item: 1u32,
            owner: ALICE,
        }
    );

    The xcm message contains the following instructions:

    1. Withdraw native assets from the Parachain(1)'s sovereign account.
    2. Buy weight with these assets.
    3. Create a collection with as admin and owner the sovereign account of Parachain(1).
    4. Mints an NFT in the collection with item ID 1 and as owner Alice.
    let message = Xcm(vec![
        WithdrawAsset((Here, AMOUNT).into()),
        BuyExecution { fees: (Here, AMOUNT).into(), weight_limit: WeightLimit::Unlimited },
        Transact {
            origin_kind: OriginKind::SovereignAccount,
            require_weight_at_most: Weight::from_parts(INITIAL_BALANCE as u64, 1024 * 1024),
            call: create_collection.encode().into(),
        },
        Transact {
            origin_kind: OriginKind::SovereignAccount,
            require_weight_at_most: Weight::from_parts(INITIAL_BALANCE as u64, 1024 * 1024),
            call: mint.encode().into(),
        },
    ]);

    Next:​

    Check out the following instructions that interact with the Transact Status Register:

    - + \ No newline at end of file diff --git a/docs/learn/xcm/journey-version.html b/docs/learn/xcm/journey-version.html index c3ca50816d9a..8ed0b95dfc4e 100644 --- a/docs/learn/xcm/journey-version.html +++ b/docs/learn/xcm/journey-version.html @@ -18,8 +18,8 @@ - - + + @@ -35,7 +35,7 @@ send back its currently AdvertisedVersion and will keep the subscribed location up to date when the version changes. The subscribed location can unsubscribe to version changes by sending the UnsubscribeVersion instruction.

    SubscribeVersion {
        #[codec(compact)]
        query_id: QueryId,
        max_response_weight: Weight,
    }

    UnsubscribeVersion

    Check out the example.

    - + \ No newline at end of file diff --git a/docs/learn/xcm/journey.html b/docs/learn/xcm/journey.html index 6b06ee7073ac..f17967ec2080 100644 --- a/docs/learn/xcm/journey.html +++ b/docs/learn/xcm/journey.html @@ -18,14 +18,14 @@ - - + +

    A Journey through XCM

    A Practical Introduction to the XCM Features.

    - + \ No newline at end of file diff --git a/docs/learn/xcm/journey/transfers-reserve.html b/docs/learn/xcm/journey/transfers-reserve.html index 839950be9b7d..2b7c7dbf0227 100644 --- a/docs/learn/xcm/journey/transfers-reserve.html +++ b/docs/learn/xcm/journey/transfers-reserve.html @@ -18,8 +18,8 @@ - - + + @@ -73,7 +73,7 @@ It's the sender the one who doesn't need to trust the destination, since it'll ever only be minting derivatives anyway, the sender/reserve controls the real assets and issuance.

    Next steps​

    Next, we'll talk about a very important topic we mentioned before but skipped in this chapter, paying fees for the effects our XCMs have.

    - + \ No newline at end of file diff --git a/docs/learn/xcm/journey/transfers-summary.html b/docs/learn/xcm/journey/transfers-summary.html index 2fe60a94166a..beebaa7f85f4 100644 --- a/docs/learn/xcm/journey/transfers-summary.html +++ b/docs/learn/xcm/journey/transfers-summary.html @@ -18,8 +18,8 @@ - - + + @@ -42,7 +42,7 @@ paying for execution and depositing the rest to another account on the same system. The full example can be seen in the repo.

    Transferring between systems​

    But what if you want to make a transfer from one system to another? There are two ways of doing this:

    • Asset teleportation
    • Reserve-backed transfers

    We'll be discussing both in the following chapters.

    - + \ No newline at end of file diff --git a/docs/learn/xcm/journey/transfers-teleport.html b/docs/learn/xcm/journey/transfers-teleport.html index 4330634bf238..cb23233afc97 100644 --- a/docs/learn/xcm/journey/transfers-teleport.html +++ b/docs/learn/xcm/journey/transfers-teleport.html @@ -18,8 +18,8 @@ - - + + @@ -61,7 +61,7 @@ another system. We could do so with the following program:

    let message = Xcm(vec![
      WithdrawAsset((GeneralIndex(1), 42u32).into()),
      InitiateTeleport {
        assets: All.into(),
        dest: Parachain(1).into(),
        xcm: Xcm(vec![DepositAsset {
          assets: All.into(),
          beneficiary: Junction::AccountId32 {
            id: ALICE.into(),
            network: None,
          }.into()
        }]),
      },
    ]);

    Very little changes, in fact, only the MultiAsset we're referencing changes, like we would expect. All the teleportation logic stays the same. The example assumes an NFT with index 42 inside a collection with index 1.

    Next steps​

    We'll look at reserve-backed transfers next.

    - + \ No newline at end of file diff --git a/docs/learn/xcm/journey/transfers.html b/docs/learn/xcm/journey/transfers.html index 6a13fcfdea7c..2850fbb7fb45 100644 --- a/docs/learn/xcm/journey/transfers.html +++ b/docs/learn/xcm/journey/transfers.html @@ -18,14 +18,14 @@ - - + +

    Transfers

    Transferring Assets between Consensus Systems with XCM.

    - + \ No newline at end of file diff --git a/docs/learn/xcm/overview-architecture.html b/docs/learn/xcm/overview-architecture.html index 5ea9e93b5828..4b6b502de42f 100644 --- a/docs/learn/xcm/overview-architecture.html +++ b/docs/learn/xcm/overview-architecture.html @@ -18,8 +18,8 @@ - - + + @@ -48,7 +48,7 @@ about later. It's the glue between XCM and FRAME, which is highly used in the Polkadot ecosystem.

    Simulator​

    The simulator allows for testing XCMs fast, without needing to boot up several different nodes in a network, or test in production. It's a very useful tool which we'll use throughout this document to build and test different XCMs.

    - + \ No newline at end of file diff --git a/docs/learn/xcm/overview-format.html b/docs/learn/xcm/overview-format.html index ff8718aaaa60..a7e4319ce942 100644 --- a/docs/learn/xcm/overview-format.html +++ b/docs/learn/xcm/overview-format.html @@ -18,8 +18,8 @@ - - + + @@ -38,7 +38,7 @@ changes. XCM communicates intentions; the actual interpretation and behaviour of each instruction in an XCM is defined by target's XCVM implementation.

    Both simple and more complex scenarios can be expressed, and developers are encouraged to design and implement diverse cross-consensus communication solutions.

    - + \ No newline at end of file diff --git a/docs/learn/xcm/overview-intro.html b/docs/learn/xcm/overview-intro.html index fa81cc3c9f52..900797343d87 100644 --- a/docs/learn/xcm/overview-intro.html +++ b/docs/learn/xcm/overview-intro.html @@ -18,8 +18,8 @@ - - + + @@ -41,7 +41,7 @@ propose changes, which end up in newer versions, the current one being v3. To keep up with the development of the format, or to propose changes, go to the XCM format repository.

    - + \ No newline at end of file diff --git a/docs/learn/xcm/overview-summary.html b/docs/learn/xcm/overview-summary.html index a5e0639f7d54..39dcbe01cfb2 100644 --- a/docs/learn/xcm/overview-summary.html +++ b/docs/learn/xcm/overview-summary.html @@ -18,8 +18,8 @@ - - + + @@ -32,7 +32,7 @@ interactions between them. XCM is meant to be used by developers to package these interactions into their runtime logic before exposing that functionality to end users.

    This chapter will cover what XCM is, what it isn't, and why it matters before exploring the different components that make up the XCM ecosystem.

    - + \ No newline at end of file diff --git a/docs/learn/xcm/overview-xcvm.html b/docs/learn/xcm/overview-xcvm.html index f2081d001b68..7396c33ddfe4 100644 --- a/docs/learn/xcm/overview-xcvm.html +++ b/docs/learn/xcm/overview-xcvm.html @@ -18,8 +18,8 @@ - - + + @@ -41,7 +41,7 @@ putting them in and taking them from this register. This register is used by several of the instructions we will look at later, including DepositAsset and WithdrawAsset.

    For more information on other registers, see the All XCVM Registers section.

    - + \ No newline at end of file diff --git a/docs/learn/xcm/overview.html b/docs/learn/xcm/overview.html index 67eeeef53a1b..0222a0d2bab5 100644 --- a/docs/learn/xcm/overview.html +++ b/docs/learn/xcm/overview.html @@ -18,14 +18,14 @@ - - + +

    Overview

    Overview of the XCM Documentation.

    - + \ No newline at end of file diff --git a/docs/learn/xcm/quickstart-first-look.html b/docs/learn/xcm/quickstart-first-look.html index 4fda6db6f266..007bcf7dd20f 100644 --- a/docs/learn/xcm/quickstart-first-look.html +++ b/docs/learn/xcm/quickstart-first-look.html @@ -18,8 +18,8 @@ - - + + @@ -51,7 +51,7 @@ examples for every instruction in the journey through XCM chapter. First, it's important to learn the fundamentals, MultiLocation, MultiAsset, and other concepts in XCM. We'll talk about those next.

    - + \ No newline at end of file diff --git a/docs/learn/xcm/quickstart-simulator.html b/docs/learn/xcm/quickstart-simulator.html index d2aca956ccd5..a1b5453b67e5 100644 --- a/docs/learn/xcm/quickstart-simulator.html +++ b/docs/learn/xcm/quickstart-simulator.html @@ -18,8 +18,8 @@ - - + + @@ -31,7 +31,7 @@ actually test your XCM-powered solution. We'll get into tools and best practices for testing in the testing chapter.

    We'll use the simulator throughout the documentation to show different XCMs in action. In the next section we will take a first look at an XCM.

    - + \ No newline at end of file diff --git a/docs/learn/xcm/quickstart-summary.html b/docs/learn/xcm/quickstart-summary.html index c40328913a86..273f1fd025c5 100644 --- a/docs/learn/xcm/quickstart-summary.html +++ b/docs/learn/xcm/quickstart-summary.html @@ -18,8 +18,8 @@ - - + + @@ -29,7 +29,7 @@ installation guide.

    Running the Examples​

    All examples in the documentation are located in the repository. Follow these steps to run the first-look example. First clone the repository:

    git clone git@github.com:paritytech/xcm-docs.git
    cd xcm-docs/examples

    To run the first-look example, run the following line:

    cargo test -p xcm-examples para_a_simple_transfer -- --nocapture

    It should show you the following output:

    running 1 test
    test first_look::tests::para_a_simple_transfer ... ok

    test result: ok. 1 passed; 0 failed; 0 ignored; 0 measured; 1 filtered out; finished in 0.01s
    - + \ No newline at end of file diff --git a/docs/learn/xcm/quickstart.html b/docs/learn/xcm/quickstart.html index 49120c932909..cc38a2bfd26e 100644 --- a/docs/learn/xcm/quickstart.html +++ b/docs/learn/xcm/quickstart.html @@ -18,14 +18,14 @@ - - + +

    Quickstart

    Start Diving into XCM.

    - + \ No newline at end of file diff --git a/docs/learn/xcm/reference-glossary.html b/docs/learn/xcm/reference-glossary.html index b34f89c16646..71fceefec82e 100644 --- a/docs/learn/xcm/reference-glossary.html +++ b/docs/learn/xcm/reference-glossary.html @@ -18,8 +18,8 @@ - - + + @@ -44,7 +44,7 @@ through the relay chain.

    HRMP (Horizontal Message Passing)​

    Transport-layer protocol that allows a parachain to send messages to a sibling parachain going through the relay chain. It's a precursor to XCMP, also known as XCMP-lite. It uses a mixture of UMP and VMP.

    - + \ No newline at end of file diff --git a/docs/learn/xcm/reference-xcvm-registers.html b/docs/learn/xcm/reference-xcvm-registers.html index 460e532ed3bd..cbd5e20a50a1 100644 --- a/docs/learn/xcm/reference-xcvm-registers.html +++ b/docs/learn/xcm/reference-xcvm-registers.html @@ -18,8 +18,8 @@ - - + + @@ -27,7 +27,7 @@
    - + \ No newline at end of file diff --git a/docs/learn/xcm/references.html b/docs/learn/xcm/references.html index eda467163822..d52c2dd18bc3 100644 --- a/docs/learn/xcm/references.html +++ b/docs/learn/xcm/references.html @@ -18,14 +18,14 @@ - - + +

    References

    References.

    - + \ No newline at end of file diff --git a/docs/learn/xcm/testing.html b/docs/learn/xcm/testing.html index 08c428d3e758..4edff918036c 100644 --- a/docs/learn/xcm/testing.html +++ b/docs/learn/xcm/testing.html @@ -18,8 +18,8 @@ - - + + @@ -39,7 +39,7 @@ messaging infrastructure as live networks, as the transport mechanism is being mocked out. Also, consensus related events are not tested, like disputes, staking and iamonline events. To test for these events, parachains can use E2E tests.

    End-to-End testing​

    There are two frameworks being used in the ecosystem to do e2e testing:

    - + \ No newline at end of file diff --git a/docs/ledger.html b/docs/ledger.html index 503086738510..a8fc8d4a8074 100644 --- a/docs/ledger.html +++ b/docs/ledger.html @@ -18,8 +18,8 @@ - - + + @@ -81,7 +81,7 @@ automatically detect the developer release and give the option to install the previous stable release.
    Polkadot-JS Guides

    If you are an advanced user, see the Polkadot-JS guides about Ledger.

    - + \ No newline at end of file diff --git a/docs/maintain-bootnode.html b/docs/maintain-bootnode.html index 2801ae3bfd30..a0f1ef56cbe7 100644 --- a/docs/maintain-bootnode.html +++ b/docs/maintain-bootnode.html @@ -18,8 +18,8 @@ - - + + @@ -41,7 +41,7 @@ port 30311:

    /etc/nginx/sites-enabled/dot-bootnode

    server {
           listen       30312 ssl http2 default_server;
           server_name  dot-bootnode.stakeworld.io;
           root         /var/www/html;

           ssl_certificate "<your_cert";
           ssl_certificate_key "<your_key>";

           location / {
             proxy_buffers 16 4k;
             proxy_buffer_size 2k;
             proxy_pass http://localhost:30311;
             proxy_http_version 1.1;
             proxy_set_header Upgrade $http_upgrade;
             proxy_set_header Connection "Upgrade";
             proxy_set_header Host $host;
       }

    }

    Testing Bootnode Connection​

    If we have the above node running with DNS name dot-bootnode.stakeworld.io, proxied with a valid certificate and node-id 12D3KooWAb5MyC1UJiEQJk4Hg4B2Vi3AJdqSUhTGYUqSnEqCFMFg then the following commands should give you a: "syncing 1 peers".

    tip

    You can add -lsub-libp2p=trace on the end to get libp2p trace logging for debugging purposes.

    p2p:

    polkadot --chain polkadot --base-path /tmp/node --name "Bootnode testnode" --reserved-only --reserved-nodes "/dns/dot-bootnode.stakeworld.io/tcp/30310/p2p/12D3KooWAb5MyC1UJiEQJk4Hg4B2Vi3AJdqSUhTGYUqSnEqCFMFg" --no-hardware-benchmarks

    p2p/ws:

    polkadot --chain polkadot --base-path /tmp/node --name "Bootnode testnode" --reserved-only --reserved-nodes "/dns/dot-bootnode.stakeworld.io/tcp/30311/ws/p2p/12D3KooWAb5MyC1UJiEQJk4Hg4B2Vi3AJdqSUhTGYUqSnEqCFMFg" --no-hardware-benchmarks

    p2p/wss:

    polkadot --chain polkadot --base-path /tmp/node --name "Bootnode testnode" --reserved-only --reserved-nodes "/dns/dot-bootnode.stakeworld.io/tcp/30312/wss/p2p/12D3KooWAb5MyC1UJiEQJk4Hg4B2Vi3AJdqSUhTGYUqSnEqCFMFg" --no-hardware-benchmarks
    - + \ No newline at end of file diff --git a/docs/maintain-endpoints.html b/docs/maintain-endpoints.html index 59ec48a2685a..4ab864835b29 100644 --- a/docs/maintain-endpoints.html +++ b/docs/maintain-endpoints.html @@ -18,8 +18,8 @@ - - + + @@ -40,7 +40,7 @@ provide additional services such as higher rate limits, potentially more reliable and scalable service, and additional metrics.

    note

    The list of third party RPC endpoints above for Polkadot and Kusama is directly fetched from Polkdot-JS UI

    - + \ No newline at end of file diff --git a/docs/maintain-errors.html b/docs/maintain-errors.html index f9d315503797..4dfb08faf00b 100644 --- a/docs/maintain-errors.html +++ b/docs/maintain-errors.html @@ -18,8 +18,8 @@ - - + + @@ -50,7 +50,7 @@ will wait to be executed at the correct place in the nonce sequence OR it will get discarded due to some other error (ex. the validity period expires).*

    Error Table​

    The below table is a reference to the errors that exists in Polkadot. It is generated from the runtime's metadata.

    PalletErrorDocumentation
    System (0)
    InvalidSpecName (0)The name of specification does not match between the current runtime and the new runtime.
    SpecVersionNeedsToIncrease (1)The specification version is not allowed to decrease between the current runtime and the new runtime.
    FailedToExtractRuntimeVersion (2)Failed to extract the runtime version from the new runtime. Either calling Core_version or decoding RuntimeVersion failed.
    NonDefaultComposite (3)Suicide called when the account has non-default composite data.
    NonZeroRefCount (4)There is a non-zero reference count preventing the account from being purged.
    Scheduler (1)
    FailedToSchedule (0)Failed to schedule a call
    NotFound (1)Cannot find the scheduled call.
    TargetBlockNumberInPast (2)Given target block number is in the past.
    RescheduleNoChange (3)Reschedule failed because it does not change scheduled time.
    Balances (5)
    VestingBalance (0)Vesting balance too high to send value
    LiquidityRestrictions (1)Account liquidity restrictions prevent withdrawal
    Overflow (2)Got an overflow after adding
    InsufficientBalance (3)Balance too low to send value
    ExistentialDeposit (4)Value too low to create account due to existential deposit
    KeepAlive (5)Transfer/payment would kill account
    ExistingVestingSchedule (6)A vesting schedule already exists for this account
    DeadAccount (7)Beneficiary account must pre-exist
    Authorship (6)
    InvalidUncleParent (0)The uncle parent not in the chain.
    UnclesAlreadySet (1)Uncles already set in the block.
    TooManyUncles (2)Too many uncles.
    GenesisUncle (3)The uncle is genesis.
    TooHighUncle (4)The uncle is too high in chain.
    UncleAlreadyIncluded (5)The uncle is already included.
    OldUncle (6)The uncle isn't recent enough to be included.
    Staking (7)
    NotController (0)Not a controller account.
    NotStash (1)Not a stash account.
    AlreadyBonded (2)Stash is already bonded.
    AlreadyPaired (3)Controller is already paired.
    EmptyTargets (4)Targets cannot be empty.
    DuplicateIndex (5)Duplicate index.
    InvalidSlashIndex (6)Slash record index out of bounds.
    InsufficientValue (7)Can not bond with value less than minimum balance.
    NoMoreChunks (8)Can not schedule more unlock chunks.
    NoUnlockChunk (9)Can not rebond without unlocking chunks.
    FundedTarget (10)Attempting to target a stash that still has funds.
    InvalidEraToReward (11)Invalid era to reward.
    InvalidNumberOfNominations (12)Invalid number of nominations.
    NotSortedAndUnique (13)Items are not sorted and unique.
    AlreadyClaimed (14)Rewards for this era have already been claimed for this validator.
    OffchainElectionEarlySubmission (15)The submitted result is received out of the open window.
    OffchainElectionWeakSubmission (16)The submitted result is not as good as the one stored on chain.
    SnapshotUnavailable (17)The snapshot data of the current window is missing.
    OffchainElectionBogusWinnerCount (18)Incorrect number of winners were presented.
    OffchainElectionBogusWinner (19)One of the submitted winners is not an active candidate on chain (index is out of range in snapshot).
    OffchainElectionBogusCompact (20)Error while building the assignment type from the compact. This can happen if an index is invalid, or if the weights overflow.
    OffchainElectionBogusNominator (21)One of the submitted nominators is not an active nominator on chain.
    OffchainElectionBogusNomination (22)One of the submitted nominators has an edge to which they have not voted on chain.
    OffchainElectionSlashedNomination (23)One of the submitted nominators has an edge which is submitted before the last non-zero slash of the target.
    OffchainElectionBogusSelfVote (24)A self vote must only be originated from a validator to ONLY themselves.
    OffchainElectionBogusEdge (25)The submitted result has unknown edges that are not among the presented winners.
    OffchainElectionBogusScore (26)The claimed score does not match with the one computed from the data.
    OffchainElectionBogusElectionSize (27)The election size is invalid.
    CallNotAllowed (28)The call is not allowed at the given time due to restrictions of election period.
    IncorrectHistoryDepth (29)Incorrect previous history depth input provided.
    IncorrectSlashingSpans (30)Incorrect number of slashing spans provided.
    Session (9)
    InvalidProof (0)Invalid ownership proof.
    NoAssociatedValidatorId (1)No associated validator ID for account.
    DuplicatedKey (2)Registered duplicate key.
    NoKeys (3)No keys are associated with this account.
    Grandpa (11)
    PauseFailed (0)Attempt to signal GRANDPA pause when the authority set isn't live (either paused or already pending pause).
    ResumeFailed (1)Attempt to signal GRANDPA resume when the authority set isn't paused (either live or already pending resume).
    ChangePending (2)Attempt to signal GRANDPA change with one already pending.
    TooSoon (3)Cannot signal forced change so soon after last.
    InvalidKeyOwnershipProof (4)A key ownership proof provided as part of an equivocation report is invalid.
    InvalidEquivocationProof (5)An equivocation proof provided as part of an equivocation report is invalid.
    DuplicateOffenceReport (6)A given equivocation report is valid but already previously reported.
    ImOnline (12)
    InvalidKey (0)Non existent public key.
    DuplicatedHeartbeat (1)Duplicated heartbeat.
    Democracy (14)
    ValueLow (0)Value too low
    ProposalMissing (1)Proposal does not exist
    BadIndex (2)Unknown index
    AlreadyCanceled (3)Cannot cancel the same proposal twice
    DuplicateProposal (4)Proposal already made
    ProposalBlacklisted (5)Proposal still blacklisted
    NotSimpleMajority (6)Next external proposal not simple majority
    InvalidHash (7)Invalid hash
    NoProposal (8)No external proposal
    AlreadyVetoed (9)Identity may not veto a proposal twice
    NotDelegated (10)Not delegated
    DuplicatePreimage (11)Preimage already noted
    NotImminent (12)Not imminent
    TooEarly (13)Too early
    Imminent (14)Imminent
    PreimageMissing (15)Preimage not found
    ReferendumInvalid (16)Vote given for invalid referendum
    PreimageInvalid (17)Invalid preimage
    NoneWaiting (18)No proposals waiting
    NotLocked (19)The target account does not have a lock.
    NotExpired (20)The lock on the account to be unlocked has not yet expired.
    NotVoter (21)The given account did not vote on the referendum.
    NoPermission (22)The actor has no permission to conduct the action.
    AlreadyDelegating (23)The account is already delegating.
    Overflow (24)An unexpected integer overflow occurred.
    Underflow (25)An unexpected integer underflow occurred.
    InsufficientFunds (26)Too high a balance was provided that the account cannot afford.
    NotDelegating (27)The account is not currently delegating.
    VotesExist (28)The account currently has votes attached to it and the operation cannot succeed until these are removed, either through unvote or reap_vote.
    InstantNotAllowed (29)The instant referendum origin is currently disallowed.
    Nonsense (30)Delegation to oneself makes no sense.
    WrongUpperBound (31)Invalid upper bound.
    MaxVotesReached (32)Maximum number of votes reached.
    InvalidWitness (33)The provided witness data is wrong.
    TooManyProposals (34)Maximum number of proposals reached.
    Council (15)
    NotMember (0)Account is not a member
    DuplicateProposal (1)Duplicate proposals not allowed
    ProposalMissing (2)Proposal must exist
    WrongIndex (3)Mismatched index
    DuplicateVote (4)Duplicate vote ignored
    AlreadyInitialized (5)Members are already initialized!
    TooEarly (6)The close call was made too early, before the end of the voting.
    TooManyProposals (7)There can only be a maximum of MaxProposals active proposals.
    WrongProposalWeight (8)The given weight bound for the proposal was too low.
    WrongProposalLength (9)The given length bound for the proposal was too low.
    TechnicalCommittee (16)
    NotMember (0)Account is not a member
    DuplicateProposal (1)Duplicate proposals not allowed
    ProposalMissing (2)Proposal must exist
    WrongIndex (3)Mismatched index
    DuplicateVote (4)Duplicate vote ignored
    AlreadyInitialized (5)Members are already initialized!
    TooEarly (6)The close call was made too early, before the end of the voting.
    TooManyProposals (7)There can only be a maximum of MaxProposals active proposals.
    WrongProposalWeight (8)The given weight bound for the proposal was too low.
    WrongProposalLength (9)The given length bound for the proposal was too low.
    ElectionsPhragmen (17)
    UnableToVote (0)Cannot vote when no candidates or members exist.
    NoVotes (1)Must vote for at least one candidate.
    TooManyVotes (2)Cannot vote more than candidates.
    MaximumVotesExceeded (3)Cannot vote more than maximum allowed.
    LowBalance (4)Cannot vote with stake less than minimum balance.
    UnableToPayBond (5)Voter can not pay voting bond.
    MustBeVoter (6)Must be a voter.
    ReportSelf (7)Cannot report self.
    DuplicatedCandidate (8)Duplicated candidate submission.
    MemberSubmit (9)Member cannot re-submit candidacy.
    RunnerSubmit (10)Runner cannot re-submit candidacy.
    InsufficientCandidateFunds (11)Candidate does not have enough funds.
    NotMember (12)Not a member.
    InvalidCandidateCount (13)The provided count of number of candidates is incorrect.
    InvalidVoteCount (14)The provided count of number of votes is incorrect.
    InvalidRenouncing (15)The renouncing origin presented a wrong Renouncing parameter.
    InvalidReplacement (16)Prediction regarding replacement after member removal is wrong.
    Treasury (19)
    InsufficientProposersBalance (0)Proposer's balance is too low.
    InvalidIndex (1)No proposal or bounty at that index.
    ReasonTooBig (2)The reason given is just too big.
    AlreadyKnown (3)The tip was already found/started.
    UnknownTip (4)The tip hash is unknown.
    NotFinder (5)The account attempting to retract the tip is not the finder of the tip.
    StillOpen (6)The tip cannot be claimed/closed because there are not enough tippers yet.
    Premature (7)The tip cannot be claimed/closed because it's still in the countdown period.
    UnexpectedStatus (8)The bounty status is unexpected.
    RequireCurator (9)Require bounty curator.
    InvalidValue (10)Invalid bounty value.
    InvalidFee (11)Invalid bounty fee.
    PendingPayout (12)A bounty payout is pending. To cancel the bounty, you must unassign and slash the curator.
    Claims (24)
    InvalidEthereumSignature (0)Invalid Ethereum signature.
    SignerHasNoClaim (1)Ethereum address has no claim.
    SenderHasNoClaim (2)Account ID sending tx has no claim.
    PotUnderflow (3)There's not enough in the pot to pay out some unvested amount. Generally implies a logic error.
    InvalidStatement (4)A needed statement was not included.
    VestedBalanceExists (5)The account already has a vested balance.
    Vesting (25)
    NotVesting (0)The account given is not vesting.
    ExistingVestingSchedule (1)An existing vesting schedule already exists for this account that cannot be clobbered.
    AmountLow (2)Amount being transferred is too low to create a vesting schedule.
    Identity (28)
    TooManySubAccounts (0)Too many subs-accounts.
    NotFound (1)Account isn't found.
    NotNamed (2)Account isn't named.
    EmptyIndex (3)Empty index.
    FeeChanged (4)Fee is changed.
    NoIdentity (5)No identity found.
    StickyJudgement (6)Sticky judgement.
    JudgementGiven (7)Judgement given.
    InvalidJudgement (8)Invalid judgement.
    InvalidIndex (9)The index is invalid.
    InvalidTarget (10)The target is invalid.
    TooManyFields (11)Too many additional fields.
    TooManyRegistrars (12)Maximum amount of registrars reached. Cannot add any more.
    AlreadyClaimed (13)Account ID is already named.
    NotSub (14)Sender is not a sub-account.
    NotOwned (15)Sub-account isn't owned by sender.
    Proxy (29)
    TooMany (0)There are too many proxies registered or too many announcements pending.
    NotFound (1)Proxy registration not found.
    NotProxy (2)Sender is not a proxy of the account to be proxied.
    Unproxyable (3)A call which is incompatible with the proxy type's filter was attempted.
    Duplicate (4)Account is already a proxy.
    NoPermission (5)Call may not be made by proxy because it may escalate its privileges.
    Unannounced (6)Announcement, if made at all, was made too recently.
    Multisig (30)
    MinimumThreshold (0)Threshold must be 2 or greater.
    AlreadyApproved (1)Call is already approved by this signatory.
    NoApprovalsNeeded (2)Call doesn't need any (more) approvals.
    TooFewSignatories (3)There are too few signatories in the list.
    TooManySignatories (4)There are too many signatories in the list.
    SignatoriesOutOfOrder (5)The signatories were provided out of order; they should be ordered.
    SenderInSignatories (6)The sender was contained in the other signatories; it shouldn't be.
    NotFound (7)Multisig operation not found when attempting to cancel.
    NotOwner (8)Only the account that originally created the multisig is able to cancel it.
    NoTimepoint (9)No timepoint was given, yet the multisig operation is already underway.
    WrongTimepoint (10)A different timepoint was given to the multisig operation that is underway.
    UnexpectedTimepoint (11)A timepoint was given, yet no multisig operation is underway.
    WeightTooLow (12)The maximum weight information provided was too low.
    AlreadyStored (13)The data to be stored is already stored.
    - + \ No newline at end of file diff --git a/docs/maintain-guides-async-backing.html b/docs/maintain-guides-async-backing.html index e9c2ca3ec727..470f791912d2 100644 --- a/docs/maintain-guides-async-backing.html +++ b/docs/maintain-guides-async-backing.html @@ -18,8 +18,8 @@ - - + + @@ -65,35 +65,34 @@ AuraUnincludedSegmentApi. If that runtime API is not supported, this assumes a maximum backlog size of 1.

    Prerequisite​

    The relay chain needs to have async backing enabled so double-check that the relay-chain configuration contains the following three parameters (especially when testing locally e.g. with -zombienet):

    "async_backing_params": {
        "max_candidate_depth": 3,
        "allowed_ancestry_len": 2
    },
    "scheduling_lookahead": 2

    ⚠️ scheduling_lookahead must be set to 2, otherwise parachain block times will degrade to worse -than with sync backing! ⚠️

    Phase 1 - Update Parachain Runtime​

    This phase involves configuring your parachain’s runtime to make use of async backing system.

    1. Establish constants for capacity and velocity and set both of them to 1 in +zombienet):

      "async_backing_params": {
          "max_candidate_depth": 3,
          "allowed_ancestry_len": 2
      },
      "scheduling_lookahead": 2
      warning

      scheduling_lookahead must be set to 2, otherwise parachain block times will +degrade to worse than with sync backing!

      Phase 1 - Update Parachain Runtime​

      This phase involves configuring your parachain’s runtime to make use of async backing system.

      1. Establish constants for capacity and velocity and set both of them to 1 in /runtime/src/lib.rs.

      2. Establish a constant relay chain slot duration measured in milliseconds equal to 6000 in -/runtime/src/lib.rs.

      capacity-velocity

      1. Establish constants MILLISECS_PER_BLOCK and SLOT_DURATION if not already present in -/runtime/src/lib.rs.

      capacity-velocity

      1. Configure cumulus_pallet_parachain_system in runtime/src/lib.rs

        • Define a FixedVelocityConsensusHook using our capacity, velocity, and relay slot duration -constants. Use this to set the parachain system ConsensusHook property.

        consensus-hook

        • Set the parachain system property CheckAssociatedRelayNumber to -RelayNumberMonotonicallyIncreases

        Associated-Relay-number

      2. Configure pallet_aura in runtime/src/lib.rs

        • Set AllowMultipleBlocksPerSlot to false (don't worry, we will set it to true when we -activate async backing in step 3).
        • Define pallet_aura::SlotDuration using our constant SLOT_DURATION

        Aura-config

      3. Update aura_api::SlotDuration() to match the constant SLOT_DURATION

        Aura-spi

      4. Implement the AuraUnincludedSegmentApi, which allows the collator client to query its runtime -to determine whether it should author a block.

        • Add the dependency cumulus-primitives-aura to the runtime/Cargo.toml file for your runtime

          cargo-toml

        • In the same file, add "cumulus-primitives-aura/std", to the std feature.

        • Inside the impl_runtime_apis! block for your runtime, implement the -AuraUnincludedSegmentApi as shown below.

          unincluded-segment

          Important note: With a capacity of 1 we have an effective velocity of ½ even when velocity is -configured to some larger value. This is because capacity will be filled after a single block -is produced and will only be freed up after that block is included on the relay chain, which -takes 2 relay blocks to accomplish. Thus with capacity 1 and velocity 1 we get the customary 12 -second parachain block time.

      5. If your runtime/src/lib.rs provides a CheckInherents type to register_validate_block, +/runtime/src/lib.rs.

        /// Maximum number of blocks simultaneously accepted by the Runtime, not yet included into the
        /// relay chain.
        pub const UNINCLUDED_SEGMENT_CAPACITY: u32 = 1;
        /// How many parachain blocks are processed by the relay chain per parent. Limits the number of
        /// blocks authored per slot.
        pub const BLOCK_PROCESSING_VELOCITY: u32 = 1;
        /// Relay chain slot duration, in milliseconds.
        pub const RELAY_CHAIN_SLOT_DURATION_MILLIS: u32 = 6000;

      6. Establish constants MILLISECS_PER_BLOCK and SLOT_DURATION if not already present in +/runtime/src/lib.rs.


        /// BLOCKSkkhasd will be produced at a minimum duration defined by `SLOT_DURATION`.
        /// `SLOT_DURATION` is picked up by `pallet_timestamp` which is in turn picked
        /// up by `pallet_aura` to implement `fn slot_duration()`.
        ///
        /// Change this to adjust the block time.
        pub const MILLISECS_PER_BLOCK: u64 = 12000;
        pub const SLOT_DURATION: u64 = MILLISECS_PER_BLOCK;

      7. Configure cumulus_pallet_parachain_system in runtime/src/lib.rs

        • Define a FixedVelocityConsensusHook using our capacity, velocity, and relay slot duration +constants. Use this to set the parachain system ConsensusHook property.
        impl cumulus_pallet_parachain_system::Config for Runtime {
            type RuntimeEvent = RuntimeEvent;
            type OnSystemEvent = ();
            type SelfParaId = parachain_info::Pallet<Runtime>;
            type OutboundXcmpMessageSource = XcmpQueue;
            type DmpQueue = frame_support::traits::EnqueueWithOrigin<MessageQueue, RelayOrigin>;
            type ReservedDmpWeight = ReservedDmpWeight;
            type XcmpMessageHandler = XcmpQueue;
            type ReservedXcmpWeight = ReservedXcmpWeight;
            type CheckAssociatedRelayNumber = RelayNumberMonotonicallyIncreases;
            type ConsensusHook = ConsensusHook;
            type WeightInfo = weights::cumulus_pallet_parachain_system::WeightInfo<Runtime>;
        }
        type ConsensusHook = cumulus_pallet_aura_ext::FixedVelocityConsensusHook<
            Runtime,
            RELAY_CHAIN_SLOT_DURATION_MILLIS,
            BLOCK_PROCESSING_VELOCITY,
            UNINCLUDED_SEGMENT_CAPACITY,
        >;
        • Set the parachain system property CheckAssociatedRelayNumber to +RelayNumberMonotonicallyIncreases
        impl cumulus_pallet_parachain_system::Config for Runtime {
            type RuntimeEvent = RuntimeEvent;
            type OnSystemEvent = ();
            type SelfParaId = parachain_info::Pallet<Runtime>;
            type OutboundXcmpMessageSource = XcmpQueue;
            type DmpQueue = frame_support::traits::EnqueueWithOrigin<MessageQueue, RelayOrigin>;
            type ReservedDmpWeight = ReservedDmpWeight;
            type XcmpMessageHandler = XcmpQueue;
            type ReservedXcmpWeight = ReservedXcmpWeight;
            type CheckAssociatedRelayNumber = RelayNumberMonotonicallyIncreases;
            type ConsensusHook = ConsensusHook;
            type WeightInfo = weights::cumulus_pallet_parachain_system::WeightInfo<Runtime>;
        }
        type ConsensusHook = cumulus_pallet_aura_ext::FixedVelocityConsensusHook<
            Runtime,
            RELAY_CHAIN_SLOT_DURATION_MILLIS,
            BLOCK_PROCESSING_VELOCITY,
            UNINCLUDED_SEGMENT_CAPACITY,
        >;

      8. Configure pallet_aura in runtime/src/lib.rs

        • Set AllowMultipleBlocksPerSlot to false (don't worry, we will set it to true when we +activate async backing in phase 3).
        • Define pallet_aura::SlotDuration using our constant SLOT_DURATION
        impl pallet_aura::Config for Runtime {
            type AuthorityId = AuraId;
            type DisabledValidators = ();
            type MaxAuthorities = ConstU32<100_000>;
            type AllowMultipleBlocksPerSlot = ConstBool<false>;
            #[cfg(feature = "experimental")]
            type SlotDuration = ConstU64<SLOT_DURATION>;
        }

      9. Update aura_api::SlotDuration() to match the constant SLOT_DURATION

        impl_runtime_apis! {
            impl sp_consensus_aura::AuraApi<Block, AuraId> for Runtime {
                fn slot_duration() -> sp_consensus_aura::SlotDuration {
                    sp_consensus_aura::SlotDuration::from_millis(SLOT_DURATION)
                }

                fn authorities() -> Vec<AuraId> {
                    Aura::authorities().into_inner()
                }
            }
        ...

      10. Implement the AuraUnincludedSegmentApi, which allows the collator client to query its runtime +to determine whether it should author a block.

        • Add the dependency cumulus-primitives-aura to the runtime/Cargo.toml file for your runtime
      cumulus-pallet-aura-ext = { path = "../../../../pallets/aura-ext", default-features = false }
      cumulus-pallet-parachain-system = { path = "../../../../pallets/parachain-system", default-features = false, features = ["parameterized-consensus-hook"] }
      cumulus-pallet-session-benchmarking = { path = "../../../../pallets/session-benchmarking", default-features = false }
      cumulus-pallet-xcm = { path = "../../../../pallets/xcm", default-features = false }
      cumulus-pallet-xcmp-queue = { path = "../../../../pallets/xcmp-queue", default-features = false, features = ["bridging"] }
      cumulus-primitives-aura = { path = "../../../../primitives/aura", default-features = false }

      • In the same file, add "cumulus-primitives-aura/std", to the std feature.

      • Inside the impl_runtime_apis! block for your runtime, implement the AuraUnincludedSegmentApi +as shown below.

      impl cumulus_primitives_aura::AuraUnincludedSegmentApi<Block> for Runtime {
          fn can_build_upon(
              included_hash: <Block as BlockT>::Hash,
              slot: cumulus_primitives_aura::Slot,
          ) -> bool {
              ConsensusHook::can_build_upon(included_hash, slot)
          }
      }

      Note: With a capacity of 1 we have an effective velocity of ½ even when velocity is configured +to some larger value. This is because capacity will be filled after a single block is produced and +will only be freed up after that block is included on the relay chain, which takes 2 relay blocks to +accomplish. Thus with capacity 1 and velocity 1 we get the customary 12 second parachain block time.

      1. If your runtime/src/lib.rs provides a CheckInherents type to register_validate_block, remove it. FixedVelocityConsensusHook makes it unnecessary. The following example shows how -register_validate_block should look after removing CheckInherents.

        register-validate-block

      Phase 2 - Update Parachain Nodes​

      This phase consists of plugging in the new lookahead collator node.

      1. Import cumulus_primitives_core::ValidationCode to node/src/service.rs

      import-validation-code

      1. In node/src/service.rs, modify sc_service::spawn_tasks to use a clone of Backend rather -than the original

      spawn-tasks

      1. Add backend as a parameter to start_consensus() in node/src/service.rs

      start-consensus-1

      start-consensus-2

      1. In start_consensus() import the lookahead collator rather than the basic collator

      lookahead-collator

      1. In start_consensus() replace the BasicAuraParams struct with AuraParams
        • Change the struct type from BasicAuraParams to AuraParams
        • In the para_client field, pass in a cloned para client rather than the original
        • Add a para_backend parameter after para_client, passing in our para backend
        • Provide a code_hash_provider closure like that shown below
        • Increase authoring_duration from 500 milliseconds to 1500

      Note: Set authoring_duration to whatever you want, taking your own hardware into account. But if -the backer who should be slower than you due to reading from disk, times out at two seconds your -candidates will be rejected.

      Aura-params

      1. In start_consensus() replace basic_aura::run with aura::run

      Aura-run

      Phase 3 - Activate Async Backing​

      This phase consists of changes to your parachain’s runtime that activate async backing feature.

      1. Configure pallet_aura, setting AllowMultipleBlocksPerSlot to true in runtime/src/lib.rs.

      Aura-allow-multiple-blocks

      1. Increase the maximum UNINCLUDED_SEGMENT_CAPACITY in runtime/src/lib.rs.

      Unincluded-segment-capacity

      1. Decrease MILLISECS_PER_BLOCK to 6000.
      • Note: For a parachain which measures time in terms of its own block number rather than by relay +register_validate_block should look after removing CheckInherents.
    cumulus_pallet_parachain_system::register_validate_block! {
        Runtime = Runtime,
        BlockExecutor = cumulus_pallet_aura_ext::BlockExecutor::<Runtime, Executive>,
    }

    Phase 2 - Update Parachain Nodes​

    This phase consists of plugging in the new lookahead collator node.

    1. Import cumulus_primitives_core::ValidationCode to node/src/service.rs
    use cumulus_primitives_core::{
        relay_chain::{CollatorPair, ValidationCode},
        ParaId,
    };
    1. In node/src/service.rs, modify sc_service::spawn_tasks to use a clone of Backend rather +than the original
    sc_service::spawn_tasks(sc_service::SpawnTasksParams {
        rpc_builder,
        client: client.clone(),
        transaction_pool: transaction_pool.clone(),
        task_manager: &mut task_manager,
        config: parachain_config,
        keystore: params.keystore_container.keystore(),
        backend: backend.clone(),
        network: network.clone(),
        sync_service: sync_service.clone(),
        system_rpc_tx,
        tx_handler_controller,
        telemetry: telemetry.as_mut(),
    })?;
    1. Add backend as a parameter to start_consensus() in node/src/service.rs
    fn start_consensus(
        client: Arc<ParachainClient>,
        backend: Arc<ParachainBackend>,
        block_import: ParachainBlockImport,
        prometheus_registry: Option<&Registry>,
        telemetry: Option<TelemetryHandle>,
        task_manager: &TaskManager,
    if validator {
        start_consensus(
        client.clone(),
        backend.clone(),
        block_import,
        prometheus_registry.as_ref(),
    1. In node/src/service.rs import the lookahead collator rather than the basic collator
    use cumulus_client_consensus_aura::collators::lookahead::{self as aura, Params as AuraParams};
    1. In start_consensus() replace the BasicAuraParams struct with AuraParams
      • Change the struct type from BasicAuraParams to AuraParams
      • In the para_client field, pass in a cloned para client rather than the original
      • Add a para_backend parameter after para_client, passing in our para backend
      • Provide a code_hash_provider closure like that shown below
      • Increase authoring_duration from 500 milliseconds to 1500
    let params = AuraParams {
        create_inherent_data_providers: move |_, ()| async move { Ok(()) },
        block_import,
        para_client: client.clone(),
        para_backend: backend.clone(),
        relay_client: relay_chain_interface,
        code_hash_provider: move |block_hash| {
            client.code_at(block_hash).ok().map(|c| ValidationCode::from(c).hash())
        },
        sync_oracle,
        keystore,
        collator_key,
        para_id,
        overseer_handle,
        relay_chain_slot_duration,
        proposer,
        collator_service,
        authoring_duration: Duration::from_millis(1500),
        reinitialize: false,
    };

    Note: Set authoring_duration to whatever you want, taking your own hardware into account. But +if the backer who should be slower than you due to reading from disk, times out at two seconds your +candidates will be rejected.

    1. In start_consensus() replace basic_aura::run with aura::run
    let fut = aura::run::<
        Block,
        sp_consensus_aura::sr25519::AuthorityPair,
        _,
        _,
        _,
        _,
        _,
        _,
        _,
        _,
        _,
        >(params);
    task_manager.spawn_essential_handle().spawn("aura", None, fut);

    Phase 3 - Activate Async Backing​

    This phase consists of changes to your parachain’s runtime that activate async backing feature.

    1. Configure pallet_aura, setting AllowMultipleBlocksPerSlot to true in runtime/src/lib.rs.
    impl pallet_aura::Config for Runtime {
        type AuthorityId = AuraId;
        type DisabledValidators = ();
        type MaxAuthorities = ConstU32<100_000>;
        type AllowMultipleBlocksPerSlot = ConstBool<true>;
        #[cfg(feature = "experimental")]
        type SlotDuration = ConstU64<SLOT_DURATION>;
    }
    1. Increase the maximum UNINCLUDED_SEGMENT_CAPACITY in runtime/src/lib.rs.
    /// Maximum number of blocks simultaneously accepted by the Runtime, not yet included into the
    /// relay chain.
    pub const UNINCLUDED_SEGMENT_CAPACITY: u32 = 3;
    /// How many parachain blocks are processed by the relay chain per parent. Limits the number of
    /// blocks authored per slot.
    pub const BLOCK_PROCESSING_VELOCITY: u32 = 1;
    1. Decrease MILLISECS_PER_BLOCK to 6000.

    • Note: For a parachain which measures time in terms of its own block number rather than by relay block number it may be preferable to increase velocity. Changing block time may cause -complications, requiring additional changes. See the section “Timing by Block Number”.

    block-time

    1. Update MAXIMUM_BLOCK_WEIGHT to reflect the increased time available for block production.

    block-weight

    1. Add a feature flagged alternative for MinimumPeriod in pallet_timestamp. The type should be -ConstU64<0> with the feature flag experimental, and ConstU64<{SLOT_DURATION / 2}> without.

    minimum-period

    Timing by Block Number​

    With asynchronous backing it will be possible for parachains to opt for a block time of 6 seconds +complications, requiring additional changes. See the section “Timing by Block Number”.

    /// This determines the average expected block time that we are targeting.
    /// Blocks will be produced at a minimum duration defined by `SLOT_DURATION`.
    /// `SLOT_DURATION` is picked up by `pallet_timestamp` which is in turn picked
    /// up by `pallet_aura` to implement `fn slot_duration()`.
    ///
    /// Change this to adjust the block time.
    pub const MILLISECS_PER_BLOCK: u64 = 6000;
    1. Update MAXIMUM_BLOCK_WEIGHT to reflect the increased time available for block production.
    /// We allow for 2 seconds of compute with a 6 second average block.
    pub const MAXIMUM_BLOCK_WEIGHT: Weight = Weight::from_parts(
        WEIGHT_REF_TIME_PER_SECOND.saturating_mul(2),
        cumulus_primitives_core::relay_chain::MAX_POV_SIZE as u64,
    );
    1. Add a feature flagged alternative for MinimumPeriod in pallet_timestamp. The type should be +ConstU64<0> with the feature flag experimental, and ConstU64<{SLOT_DURATION / 2}> without.
    impl pallet_timestamp::Config for Runtime {
        type Moment = u64;
        type OnTimestampSet = Aura;
        #[cfg(feature = "experimental")]
        type MinimumPeriod = ConstU64<0>;
        #[cfg(not(feature = "experimental"))]
        type MinimumPeriod = ConstU64<{ SLOT_DURATION / 2 }>;
        type WeightInfo = weights::pallet_timestamp::WeightInfo<Runtime>;
    }

    Timing by Block Number​

    With asynchronous backing it will be possible for parachains to opt for a block time of 6 seconds rather than 12 seconds. But modifying block duration isn’t so simple for a parachain which was measuring time in terms of its own block number. It could result in expected and actual time not matching up, stalling the parachain.

    One strategy to deal with this issue is to instead rely on relay chain block numbers for timing. Relay block number is kept track of by each parachain in pallet-parachain-system with the storage value LastRelayChainBlockNumber. This value can be obtained and used wherever timing based on -block number is needed.

    - +block number is needed.

    + \ No newline at end of file diff --git a/docs/maintain-guides-avoid-slashing.html b/docs/maintain-guides-avoid-slashing.html index b75a4b7d6242..ccadf7c5bbc6 100644 --- a/docs/maintain-guides-avoid-slashing.html +++ b/docs/maintain-guides-avoid-slashing.html @@ -18,8 +18,8 @@ - - + + @@ -68,7 +68,7 @@ obtain pristine binaries or source code and to ensure the security of their node:

    1. Always download either source files or binaries from the official Parity repository
    2. Verify the hash of downloaded files.
    3. Use the W3F secure validator setup or adhere to its principles
    4. Ensure essential security items are checked, use a firewall, manage user access, use SSH certificates
    5. Avoid using your server as a general-purpose system. Hosting a validator on your workstation or one that hosts other services increases the risk of maleficence.

    Examples​

    NetworkEraEvent TypeDetailsAction Taken
    Polkadot774Small EquivocationThe validator migrated servers and cloned the keystore folder. The on-chain event can be viewed here.The validator did not submit a request for the slash to be canceled.
    Kusama3329Small EquivocationThe validator operated a test machine with cloned keys; the test machine was online at the same time as the primary, which resulted in a slash. Details can be found here.The validator requested a cancellation of the slash, but the council declined.
    Kusama3995Small EquivocationThe validator noticed several errors, after which the client crashed, and a slash was applied. The validator recorded all events and opened GitHub issues to allow for technical opinions to be shared. Details can be found here.The validator requested to cancel the slash. The council approved the request as they believed the error was not operator related.
    Kusama4543Medium UnresponsivenessA large amount of disputes flooded the network resulting in an application fault. The fault caused the client software to hang and as a result ~197 unique validators become unresponsive. Further details can be found here.The pending slash was cancelled and with runtime 9350 all lost nominations were restored. The application bug was addressed with client version 0.9.36
    - + \ No newline at end of file diff --git a/docs/maintain-guides-democracy.html b/docs/maintain-guides-democracy.html index 0389147d63ec..d280145d115f 100644 --- a/docs/maintain-guides-democracy.html +++ b/docs/maintain-guides-democracy.html @@ -18,8 +18,8 @@ - - + + @@ -162,7 +162,7 @@ a decimal integer. The bitfield stores both the conviction and aye/nay boolean, where the boolean is represented using the MSB of the byte. This would mean that the grouping of the 7 remaining bits is used to store the conviction.

    - + \ No newline at end of file diff --git a/docs/maintain-guides-how-to-chill.html b/docs/maintain-guides-how-to-chill.html index f50cbaa80ec1..61f3d670f6d9 100644 --- a/docs/maintain-guides-how-to-chill.html +++ b/docs/maintain-guides-how-to-chill.html @@ -18,8 +18,8 @@ - - + + @@ -79,7 +79,7 @@ Polkadot is set to None eliminating the upper bound on the number of nominators on the network. Due to this, the chillOther extrinsic on Polkadot network has no effect as the chill threshold will never be met.

    - + \ No newline at end of file diff --git a/docs/maintain-guides-how-to-join-council.html b/docs/maintain-guides-how-to-join-council.html index de724c30b9d6..c78b8dea9d41 100644 --- a/docs/maintain-guides-how-to-join-council.html +++ b/docs/maintain-guides-how-to-join-council.html @@ -18,8 +18,8 @@ - - + + @@ -43,7 +43,7 @@ the row "Members".

    council members list

    Now you are able to participate on the council by making motions or voting proposals. To join in on the active discussions, join the Polkadot Direction channel.

    - + \ No newline at end of file diff --git a/docs/maintain-guides-how-to-monitor-your-node.html b/docs/maintain-guides-how-to-monitor-your-node.html index 7aba8af9c6a3..40849da497bc 100644 --- a/docs/maintain-guides-how-to-monitor-your-node.html +++ b/docs/maintain-guides-how-to-monitor-your-node.html @@ -18,8 +18,8 @@ - - + + @@ -83,7 +83,7 @@ here. There are other interesting alerts you may find useful here.

    groups:
      - name: alert_rules
        rules:
          - alert: InstanceDown
            expr: up == 0
            for: 5m
            labels:
              severity: critical
            annotations:
              summary: "Instance [{{ $labels.instance }}] down"
              description: "[{{ $labels.instance }}] of job [{{ $labels.job }}] has been down for more than 1 minute."

    Change the ownership of this file to prometheus instead of root by running:

    sudo chown prometheus:prometheus rules.yml

    To check the rules defined in the "rules.yml" is syntactically correct, run the following command:

    sudo -u prometheus promtool check rules rules.yml

    Finally, restart everything by running:

    sudo systemctl restart prometheus && sudo systemctl restart alertmanager

    Now if one of your target instances down, you will receive an alert on the AlertManager and Gmail like below.

    grafana-am-6

    - + \ No newline at end of file diff --git a/docs/maintain-guides-how-to-nominate-kusama.html b/docs/maintain-guides-how-to-nominate-kusama.html index 24461e253c11..31297d462440 100644 --- a/docs/maintain-guides-how-to-nominate-kusama.html +++ b/docs/maintain-guides-how-to-nominate-kusama.html @@ -18,8 +18,8 @@ - - + + @@ -94,7 +94,7 @@ Polkascan. Also, you can verify the bonding state under the Staking page on the Polkadot-JS Apps Dashboard.

    Step 3. Nominate a validator​

    To nominate a validator, you can execute the following command:

    polkadot-js-api --seed "MNEMONIC_PHRASE" tx.staking.nominate '["VALIDATOR_ADDRESS"]' --ws WS_ENDPOINT
    polkadot-js-api --seed "xxxx xxxxx xxxx xxxxx" tx.staking.nominate '["CmD9vaMYoiKe7HiFnfkftwvhKbxN9bhyjcDrfFRGbifJEG8","E457XaKbj2yTB2URy8N4UuzmyuFRkcdxYs67UvSgVr7HyFb"]' --ws wss://kusama-rpc.polkadot.io/

    After a few seconds, you should see the hash of the transaction and if you would like to verify the nomination status, you can check that on the Polkadot-JS UI as well.

    - + \ No newline at end of file diff --git a/docs/maintain-guides-how-to-nominate-polkadot.html b/docs/maintain-guides-how-to-nominate-polkadot.html index aa8a0c323ea1..5b5cfd8eece8 100644 --- a/docs/maintain-guides-how-to-nominate-polkadot.html +++ b/docs/maintain-guides-how-to-nominate-polkadot.html @@ -18,8 +18,8 @@ - - + + @@ -67,7 +67,7 @@ Polkascan. Also, you can verify the bonding state under the Staking page on the Polkadot-JS Apps Dashboard.

    Step 3. Nominate a validator​

    To nominate a validator, you can execute the following command:

    polkadot-js-api --seed "MNEMONIC_PHRASE" tx.staking.nominate '["VALIDATOR_ADDRESS"]' --ws WS_ENDPOINT
    polkadot-js-api --seed "xxxx xxxxx xxxx xxxxx" tx.staking.nominate '["CmD9vaMYoiKe7HiFnfkftwvhKbxN9bhyjcDrfFRGbifJEG8","E457XaKbj2yTB2URy8N4UuzmyuFRkcdxYs67UvSgVr7HyFb"]' --ws wss://rpc.polkadot.io

    After a few seconds, you should see the hash of the transaction, and if you would like to verify the nomination status, you can check that on the Polkadot-JS UI as well.

    - + \ No newline at end of file diff --git a/docs/maintain-guides-how-to-stop-validating.html b/docs/maintain-guides-how-to-stop-validating.html index be2c916de5d5..095b09459b1e 100644 --- a/docs/maintain-guides-how-to-stop-validating.html +++ b/docs/maintain-guides-how-to-stop-validating.html @@ -18,8 +18,8 @@ - - + + @@ -40,7 +40,7 @@ transfer your tokens.

    See Unbonding and Rebonding for more details.

    Unbond your tokens​

    Unbonding your tokens can be done through the Network > Staking > Account actions page in PolkadotJS Apps by clicking the corresponding stash account dropdown and selecting "Unbond funds". This can also be done through the staking.unbond() extrinsic with the staking proxy account.

    - + \ No newline at end of file diff --git a/docs/maintain-guides-how-to-systemd.html b/docs/maintain-guides-how-to-systemd.html index 91bad31451ee..c25cecb70a94 100644 --- a/docs/maintain-guides-how-to-systemd.html +++ b/docs/maintain-guides-how-to-systemd.html @@ -18,8 +18,8 @@ - - + + @@ -32,7 +32,7 @@ not recognize votes that didn't make it to disk, and will then cast conflicting votes. Delaying the restart will allow the network to progress past potentially conflicting votes, at which point other nodes will not accept them.

    To enable this to autostart on bootup run:

    systemctl enable polkadot-validator.service

    Start it manually with:

    systemctl start polkadot-validator.service

    You can check that it's working with:

    systemctl status polkadot-validator.service

    You can tail the logs with journalctl like so:

    journalctl -f -u polkadot-validator
    - + \ No newline at end of file diff --git a/docs/maintain-guides-how-to-upgrade.html b/docs/maintain-guides-how-to-upgrade.html index 51a780f7ada6..447c877540b4 100644 --- a/docs/maintain-guides-how-to-upgrade.html +++ b/docs/maintain-guides-how-to-upgrade.html @@ -18,8 +18,8 @@ - - + + @@ -50,7 +50,7 @@ Validator A.
  • Take note of the Session that this extrinsic was executed in.

    • Again, it is imperative that Validator B is kept running until the current session finishes and two further full sessions have elapsed.

    Once this time has elapsed, Validator A will take over. You can safely stop Validator B.

    NOTE: To verify that the Session has changed, make sure that a block in the new Session is finalized. You should see log messages like the ones below to confirm the change:

    2019-10-28 21:44:13 Applying authority set change scheduled at block #450092
    2019-10-28 21:44:13 Applying GRANDPA set change to new set with 20 authorities
    - + \ No newline at end of file diff --git a/docs/maintain-guides-how-to-validate-kusama.html b/docs/maintain-guides-how-to-validate-kusama.html index 6bfd22594019..1c8e8899ca97 100644 --- a/docs/maintain-guides-how-to-validate-kusama.html +++ b/docs/maintain-guides-how-to-validate-kusama.html @@ -18,8 +18,8 @@ - - + + @@ -68,7 +68,7 @@ validator payout document.

    Run a Kusama Validator​

    Running a validator on the Kusama network is identical to running a Polkadot validator. Check out the Polkadot guide on how to setup a validator.

    Make sure to adjust the Polkadot guide to run a Kusama network validator (the instructions will also be available in the Polkadot Validator guide):

    • When starting the node pass --chain=kusama CLI flag
    - + \ No newline at end of file diff --git a/docs/maintain-guides-how-to-validate-polkadot.html b/docs/maintain-guides-how-to-validate-polkadot.html index 5714d714f07a..d8230ab08ce9 100644 --- a/docs/maintain-guides-how-to-validate-polkadot.html +++ b/docs/maintain-guides-how-to-validate-polkadot.html @@ -18,8 +18,8 @@ - - + + @@ -270,7 +270,7 @@ instance, Digital Ocean lists "Mining of Cryptocurrencies" under the Network Abuse section of their Acceptable Use Policy and requires explicit permission to do so. This may extend to other cryptocurrency activity.

    - + \ No newline at end of file diff --git a/docs/maintain-guides-how-to-vote-councillor.html b/docs/maintain-guides-how-to-vote-councillor.html index 6230d76dc8ae..c4eb271a7520 100644 --- a/docs/maintain-guides-how-to-vote-councillor.html +++ b/docs/maintain-guides-how-to-vote-councillor.html @@ -18,8 +18,8 @@ - - + + @@ -47,7 +47,7 @@ Polkadot-JS Apps Dashboard.

    Under the "Council overview" tab, click on "Vote".

    polkadotjs_removeVoter

    Issue the "Unvote all" option.

    When the transaction is included in a block you should have your reserved tokens made liquid again and your vote will no longer be counting for any councillors in the elections starting in the next term.

    - + \ No newline at end of file diff --git a/docs/maintain-guides-secure-validator.html b/docs/maintain-guides-secure-validator.html index 8ac8c84a78a0..9b16e30b49e3 100644 --- a/docs/maintain-guides-secure-validator.html +++ b/docs/maintain-guides-secure-validator.html @@ -18,8 +18,8 @@ - - + + @@ -69,7 +69,7 @@ hardware. The provisioning of the validator machine should be automated and defined in code. This code should be kept in private version control, reviewed, audited, and tested.

  • Session keys should be generated and provided in a secure way.

  • Polkadot should be started at boot and restarted if stopped for any reason (supervisor process).

  • Polkadot should run as a non-root user.

    • Monitoring​

    • There should be an on-call rotation for managing the alerts.

    • There should be a clear protocol with actions to perform for each level of each alert and an escalation policy.

    Resources​

    - + \ No newline at end of file diff --git a/docs/maintain-guides-society-kusama.html b/docs/maintain-guides-society-kusama.html index 61cc83ac71c8..5b3ab0939284 100644 --- a/docs/maintain-guides-society-kusama.html +++ b/docs/maintain-guides-society-kusama.html @@ -18,8 +18,8 @@ - - + + @@ -93,7 +93,7 @@ extrinsic's parameters go to Element 1 ("proposal") -> "value" -> "params" -> Element 2 ("rules") and copy the value corresponding to the key "value". You can use a hex-to-UTF8 converter to then display the text. Note that the text is formatted with Markdown.

    - + \ No newline at end of file diff --git a/docs/maintain-guides-validator-community.html b/docs/maintain-guides-validator-community.html index d5ac9adf56ce..299bb2bbe2bc 100644 --- a/docs/maintain-guides-validator-community.html +++ b/docs/maintain-guides-validator-community.html @@ -18,8 +18,8 @@ - - + + @@ -163,7 +163,7 @@ monitoring, observability services, staking dashboards, wallets, command-line utilities, or porting implementations to other languages. Additionally, this may also be eligible to be funded via a Web3 Foundation Grant.

    - + \ No newline at end of file diff --git a/docs/maintain-guides-validator-payout.html b/docs/maintain-guides-validator-payout.html index 24c4ca2a2c42..9c39c5d08f30 100644 --- a/docs/maintain-guides-validator-payout.html +++ b/docs/maintain-guides-validator-payout.html @@ -18,8 +18,8 @@ - - + + @@ -109,7 +109,7 @@ brackets ([]) next to each validator. Note that since the validator payment is public knowledge, having a low or non-existent validator payment may attract more stake from nominators, since they know they will receive a larger reward.

    Validator Set Size (v): 4
    Validator 1 Stake (v1) [20% commission]: 18 DOT (9 validator, 9 nominator)
    Validator 2 Stake (v2) [40% commission]:  9 DOT (3 validator, 6 nominator)
    Validator 3 Stake (v3) [10% commission]:  8 DOT (4 validator, 4 nominator)
    Validator 4 Stake (v4) [ 0% commission]:  6 DOT (1 validator, 5 nominator)
    Payout (p): 8 DOT

    Payout for each validator (v1 - v4):
    p / v = 8 / 4 = 2 DOT

    v1:
    (0.2 * 2) = 0.4 DOT -> validator payment
    (2 - 0.4) = 1.6 -> shared between all stake
    (9 / 18) * 1.6 = 0.8 -> validator stake share
    (9 / 18) * 1.6 = 0.8 -> nominator stake share
    v1 validator total reward: 0.4 + 0.8 = 1.2 DOT
    v1 nominator reward: 0.8 DOT

    v2:
    (0.4 * 2) = 0.8 DOT -> validator payment
    (2 - 0.8) = 1.2 -> shared between all stake
    (3 / 9) * 1.2 = 0.4 -> validator stake share
    (6 / 9) * 1.2 = 0.8 -> nominator stake share
    v2 validator total reward: 0.8 + 0.4 = 1.2 DOT
    v2 nominator reward: 0.8 DOT

    v3:
    (0.1 * 2) = 0.2 DOT -> validator payment
    (2 - 0.2) = 1.8 -> shared between all stake
    (4 / 8) * 1.8 = 0.9 -> validator stake share
    (4 / 8) * 1.8 = 0.9 -> nominator stake share
    v3 validator total reward: 0.2 + 0.9 DOT = 1.1 DOT
    v3 nominator reward: 0.9 DOT

    v4:
    (0 * 2) = 0 DOT -> validator payment
    (2 - 0) = 2.0 -> shared between all stake
    (1 / 6) * 2 = 0.33 -> validator stake share
    (5 / 6) * 2 = 1.67 -> nominator stake share
    v4 validator total reward: 0 + 0.33 DOT = 0.33 DOT
    v4 nominator reward: 1.67 DOT
    - + \ No newline at end of file diff --git a/docs/maintain-index.html b/docs/maintain-index.html index 9541ba48fe42..046f5f303666 100644 --- a/docs/maintain-index.html +++ b/docs/maintain-index.html @@ -18,8 +18,8 @@ - - + + @@ -45,7 +45,7 @@ participate in governance.
  • How to join the Council - Step by step guide for running for the Council.
  • How to vote for a Councillor - Step by step guide for voting for your favorite councillors.
    • - + \ No newline at end of file diff --git a/docs/maintain-networks.html b/docs/maintain-networks.html index 5dfd23ccb95b..d9b63e5175ba 100644 --- a/docs/maintain-networks.html +++ b/docs/maintain-networks.html @@ -18,8 +18,8 @@ - - + + @@ -54,7 +54,7 @@ the public Telemetry service.

    You can verify that your node is connected by navigating to the correct network on the dashboard and finding the name of your node.

    There is a built-in search function on the nodes page. Simply start typing keystrokes in the main window to make it available.

    - + \ No newline at end of file diff --git a/docs/maintain-polkadot-parameters.html b/docs/maintain-polkadot-parameters.html index 68246cd1cd4b..3f0f923b65c5 100644 --- a/docs/maintain-polkadot-parameters.html +++ b/docs/maintain-polkadot-parameters.html @@ -18,8 +18,8 @@ - - + + @@ -38,7 +38,7 @@ 16.

    PolkadotTimeSlotsDescription
    Term duration1 Day14_400The time for which a validator is in the set after being elected. Note, this duration can be shortened in the case that a validator misbehaves.
    Nomination period1 Day14_400How often a new validator set is elected according to Phragmén's method.
    Bonding duration28 days403_200How long until your funds will be transferrable after unbonding. Note that the bonding duration is defined in eras, not directly by slots.
    Slash defer duration28 days403_200Prevents overslashing and validators "escaping" and getting their nominators slashed with no repercussions to themselves. Note that the bonding duration is defined in eras, not directly by slots.

    Parachains​

    Crowdloans and AuctionsTimeSlotsDescription
    Auction duration7 days100_800The total duration of the slot auction, subject to the candle auction mechanism.
    Opening period2 days28_800The opening period of the slot auction.
    Ending period5 days72_000The ending period of the slot auction.
    Parachain SlotTimeSlotsDescription
    Lease period12 weeks1_209_600The length of one lease period in a parachain slot.
    Total slot duration2 years10_512_000The maximum duration a parachain can lease by winning a slot auction (8 lease periods).

    Treasury​

    TreasuryTimeSlotsDescription
    Periods between spends24 days345_600When the treasury can spend again after spending previously.

    Burn percentage is currently 1.00%.

    Precision​

    DOT have 10 decimals of precision. In other words, 10 ** 10 (10_000_000_000 or ten billion) Plancks make up a DOT.

    The denomination of DOT was changed from 12 decimals of precision at block #1,248,328 in an event known as Denomination Day. See Redenomination for details.

    - + \ No newline at end of file diff --git a/docs/maintain-rpc.html b/docs/maintain-rpc.html index 252168792000..a2299b1aca38 100644 --- a/docs/maintain-rpc.html +++ b/docs/maintain-rpc.html @@ -18,8 +18,8 @@ - - + + @@ -54,7 +54,7 @@ node. Activate the "Development" toggle and input your node's address - either the domain or the IP address. Remember to prefix with wss://, and if you're using the 443 port, append :443 like so: wss://example.com:443.

    A sync-in-progress chain connected to Polkadot-JS UI

    Now you have a secure remote connect setup for your Substrate node.

    - + \ No newline at end of file diff --git a/docs/maintain-sync.html b/docs/maintain-sync.html index 5590145394b5..fc4d5d26412d 100644 --- a/docs/maintain-sync.html +++ b/docs/maintain-sync.html @@ -18,8 +18,8 @@ - - + + @@ -90,7 +90,7 @@ on localhost by default. If you would like to connect to your node's services (rpc, and prometheus) you need to ensure that you run you node with the --rpc-external, and --prometheus-external commands.

    docker run -p 9944:9944 -p 9615:9615 parity/polkadot:v0.9.13 --name "calling_home_from_a_docker_container" --rpc-external --prometheus-external
    - + \ No newline at end of file diff --git a/docs/maintain-wss.html b/docs/maintain-wss.html index e06842ad72a2..27608dac5454 100644 --- a/docs/maintain-wss.html +++ b/docs/maintain-wss.html @@ -18,8 +18,8 @@ - - + + @@ -43,7 +43,7 @@ node. Activate the "Development" toggle and input your node's address - either the domain or the IP address. Remember to prefix with wss:// and if you're using the 443 port, append :443, like so: wss://example.com:443.

    A sync-in-progress chain connected to Polkadot-JS UI

    Now you have a secure remote connect setup for your Substrate node.

    - + \ No newline at end of file diff --git a/docs/metadata.html b/docs/metadata.html index 7b03d5fbd98e..f5ae9cdf087f 100644 --- a/docs/metadata.html +++ b/docs/metadata.html @@ -18,8 +18,8 @@ - - + + @@ -29,7 +29,7 @@ The dropdown below allows you to update the chain selection to visualize. You can search all sub-categories using the provided search field. The information is categorized by the chains Pallets, RPC and Runtime information.

    - + \ No newline at end of file diff --git a/docs/multisig-apps.html b/docs/multisig-apps.html index ab12883bf72a..3b2fbdded7e9 100644 --- a/docs/multisig-apps.html +++ b/docs/multisig-apps.html @@ -18,8 +18,8 @@ - - + + @@ -47,7 +47,7 @@ adding and removing signatories or adjusting the threshold is now possible without creating new multisigs and Multix provides an intuitive interface to work with pure proxies.

    The pure proxy setup used by MultiX can be seen on the pure proxy page.

    - + \ No newline at end of file diff --git a/docs/parachains-apps.html b/docs/parachains-apps.html index 789abac800db..0451c1fc40d4 100644 --- a/docs/parachains-apps.html +++ b/docs/parachains-apps.html @@ -18,8 +18,8 @@ - - + + @@ -98,7 +98,7 @@ tokens (LST) “vTokens”, as well as remote exchange, and swapping of vTokens from any chain. The DApp aims to simplify the cross-chain experience by providing a seamless interface for users to interact with vTokens across different chains natively.

    - + \ No newline at end of file diff --git a/docs/polkadot-direction.html b/docs/polkadot-direction.html index f70b2adbbd46..123392306a62 100644 --- a/docs/polkadot-direction.html +++ b/docs/polkadot-direction.html @@ -18,8 +18,8 @@ - - + + @@ -140,7 +140,7 @@ decentralizing the network is ensuring experts on which the maintenance of the system relies upon are incentivized and recruited over time by the Polkadot network and not by organizations within the Polkadot ecosystem.
    - + \ No newline at end of file diff --git a/docs/polkadot-v1.html b/docs/polkadot-v1.html index 4cc70610a397..d57f7ee76764 100644 --- a/docs/polkadot-v1.html +++ b/docs/polkadot-v1.html @@ -18,8 +18,8 @@ - - + + @@ -109,7 +109,7 @@ could become.

    Polkadot is perfecting its implementation through RFCs to continue being a decentralized, secure, ubiquitous computing engine to power the next generation of Web3 applications.

    - + \ No newline at end of file diff --git a/docs/polkadot-vault.html b/docs/polkadot-vault.html index 0cb93bb1fec3..7f8d92b11fd6 100644 --- a/docs/polkadot-vault.html +++ b/docs/polkadot-vault.html @@ -18,8 +18,8 @@ - - + + @@ -85,7 +85,7 @@ this article for detailed instructions. If you choose this approach, you should trust the provider you choose.

    Polkadot-JS Guides

    If you are an advanced user, see the Polkadot-JS guides about Polkadot Vault.

    - + \ No newline at end of file diff --git a/docs/polkadot-vision-index.html b/docs/polkadot-vision-index.html index a9999c1e7e69..7271c65898f4 100644 --- a/docs/polkadot-vision-index.html +++ b/docs/polkadot-vision-index.html @@ -18,14 +18,14 @@ - - + +

    Polkadot Vision

    Polkadot's Vision revealed by Gavin Wood at Decoded 2023.

    - + \ No newline at end of file diff --git a/docs/polkadotjs-ui.html b/docs/polkadotjs-ui.html index faf6f9417084..3268d2da3d9a 100644 --- a/docs/polkadotjs-ui.html +++ b/docs/polkadotjs-ui.html @@ -18,8 +18,8 @@ - - + + @@ -73,7 +73,7 @@ nomination pool settings (nomination and roles) and use non-transfer proxies, destroy assets, and much more.

    Beginner's Guide to Polkadot-JS​

    - + \ No newline at end of file diff --git a/docs/polkadotjs.html b/docs/polkadotjs.html index 92c559c83c4b..3fdfa2ef99a3 100644 --- a/docs/polkadotjs.html +++ b/docs/polkadotjs.html @@ -18,8 +18,8 @@ - - + + @@ -94,7 +94,7 @@ of spam prevention, whereas signed transactions are issued by the originator account of a transaction which contains a signature of that account, which will be subject to a fee to include it on the chain.

    - + \ No newline at end of file diff --git a/docs/programmes-index.html b/docs/programmes-index.html index e65ef3ec7db4..ddca69e15d56 100644 --- a/docs/programmes-index.html +++ b/docs/programmes-index.html @@ -18,14 +18,14 @@ - - + +

    Programmes

    Learn about different programmes and initiatives within the Polkadot and Kusama ecosystems.

    - + \ No newline at end of file diff --git a/docs/research.html b/docs/research.html index 94a4495600ae..40c7f3883eae 100644 --- a/docs/research.html +++ b/docs/research.html @@ -18,8 +18,8 @@ - - + + @@ -54,7 +54,7 @@ – Gives an outline of Nominated Proof of Stake in Polkadot. Author: Alfonzo Cevallos
  • Messaging Protocol Workshop Outcomes – An initiative to design and implement a privacy-preserving communication system for decentralized applications.
    • - + \ No newline at end of file diff --git a/docs/staking-apps.html b/docs/staking-apps.html index ac5ee1851750..3fa0c613196e 100644 --- a/docs/staking-apps.html +++ b/docs/staking-apps.html @@ -18,8 +18,8 @@ - - + + @@ -50,7 +50,7 @@ and stake on multiple networks in the Polkadot, Kusama and Polkadot SDK (Substrate) ecosystems.

    The Web Dashboard features an Earning tab which allows users to stake DOT easily via native nomination pools, as well as in liquid staking and lending protocols, without having to manage multiple applications with different interfaces and experiences.

    - + \ No newline at end of file diff --git a/docs/staking-dashboard.html b/docs/staking-dashboard.html index 4c7cc7a7bc18..78a0f060ab0b 100644 --- a/docs/staking-dashboard.html +++ b/docs/staking-dashboard.html @@ -18,8 +18,8 @@ - - + + @@ -156,7 +156,7 @@ feature request. We take your feedback seriously, do not hesitate to contact us.

    Network​

    Under Network, you can connect to either Polkadot, Kusama, or Westend through public RPC nodes or light clients for a true Web3 experience. For more information about light clients, see this page.

    - + \ No newline at end of file diff --git a/docs/start-building.html b/docs/start-building.html index 4c535de21d31..961965ae2e7e 100644 --- a/docs/start-building.html +++ b/docs/start-building.html @@ -18,8 +18,8 @@ - - + + @@ -52,7 +52,7 @@ this Medium article and the original Polkadot Forum post.

    - + \ No newline at end of file diff --git a/docs/stay-safe-index.html b/docs/stay-safe-index.html index 7ba4f44a0357..45ec0be3deed 100644 --- a/docs/stay-safe-index.html +++ b/docs/stay-safe-index.html @@ -18,14 +18,14 @@ - - + +

    Stay Safe

    Learn about good-practices to stay safe while surfing in Web3.

    - + \ No newline at end of file diff --git a/docs/thousand-contributors.html b/docs/thousand-contributors.html index aa0f10a1d0fd..c261ed9e651d 100644 --- a/docs/thousand-contributors.html +++ b/docs/thousand-contributors.html @@ -18,8 +18,8 @@ - - + + @@ -35,7 +35,7 @@ the account shared with us.

    Submission reviews​

    The review process follows the present pipeline in the 1KC public GitHub project.

    Learn more about the program and its components on the official 1KC repository

    - + \ No newline at end of file diff --git a/docs/thousand-validators.html b/docs/thousand-validators.html index 649d5e9629a0..ddbf59cef631 100644 --- a/docs/thousand-validators.html +++ b/docs/thousand-validators.html @@ -18,8 +18,8 @@ - - + + @@ -88,7 +88,7 @@ things time to resolve; if they don't, leave a message in the dedicated matrix room or open an issue on GitHub.
  • The 1000 validators website is not up to date? See these resources for more up-to-date information.

    • Resources​

    To extract and display the 1KV Program scores there are various tools listed below.

    ResourceGithub sourceInfo
    Main 1KV sitegithubMain site and 1KV backend.
    SubVT telegram bot for polkadot and kusamagithubTelegram bot with overviews and alerts for various polkadot and kusama related events, including 1KV events.
    SubVT ios and android appgithubSubVT app version for mobile phones.
    Validator earnings overviewgithubOverview of validators' earnings.
    Math Crypto's Insightsgithub1KV-oriented scoring overview of Kusama and Polkadot.
    One-T for polkadot and kusamagithubA performance report bot for the Polkadot and Kusama network with special focus on the 1KV programme.
    One-T parachains overviewgithubOne-T's parachain overview.
    Metaspan's 1KV overviewgithubOverview of 1KV programme, including the newly introduced endpoints, see here for available endpoints.
    Decentradot's 1KV overviewgithubOverview of the 1KV programme, including the newly introduced endpoints.
    Hirish 1KV overviewgithub?Overview of the 1KV Programme.
    - + \ No newline at end of file diff --git a/docs/transaction-attacks.html b/docs/transaction-attacks.html index 44451abff403..0cf8078c8a59 100644 --- a/docs/transaction-attacks.html +++ b/docs/transaction-attacks.html @@ -18,8 +18,8 @@ - - + + @@ -66,7 +66,7 @@ transfer will fail).

    Defense against Attacks​

    danger

    If you can't verify the transaction or you suspect you are signing something different than what you intended, don't sign it!

    To avoid being victim of an attack:

    • Use only trusted extensions, sites and software in general.
    • Use cold storage options (Ledger, Signer) and verify on them. Trust what these devices tell you over what is shown in the app or the browser extension.
    • Update Signer metadata only from trusted sources (or do it yourself).
    • Accept metadata updates for the extension only from trusted apps.
    - + \ No newline at end of file diff --git a/docs/wallets-and-extensions.html b/docs/wallets-and-extensions.html index e8032c939859..92bf5d52a6ef 100644 --- a/docs/wallets-and-extensions.html +++ b/docs/wallets-and-extensions.html @@ -18,8 +18,8 @@ - - + + @@ -93,7 +93,7 @@ your accounts on over 150+ Substrate and EVM networks. NFT Management, ledger Support, fiat On-ramp, portfolio tracking. Talisman received funding from Polkadot Treasury [1].

    - + \ No newline at end of file diff --git a/docs/wallets-index.html b/docs/wallets-index.html index 6c4852a07a1f..86b09a2a1cac 100644 --- a/docs/wallets-index.html +++ b/docs/wallets-index.html @@ -18,14 +18,14 @@ - - + +

    Wallets

    Explore the different wallets and applications in the Polkadot and Kusama ecosystems.

    - + \ No newline at end of file diff --git a/docs/web3-and-polkadot.html b/docs/web3-and-polkadot.html index c026b68240b1..d3bcc0f691a9 100644 --- a/docs/web3-and-polkadot.html +++ b/docs/web3-and-polkadot.html @@ -18,8 +18,8 @@ - - + + @@ -153,7 +153,7 @@ all blockchains attached to it. For more information, see the Polkadot 1.0 page and the section about XCM and Accords in Polkadot Direction page.

    - + \ No newline at end of file diff --git a/index.html b/index.html index befa71e1d33e..2e66f06d2dcd 100644 --- a/index.html +++ b/index.html @@ -18,14 +18,14 @@ - - + +

    Explore

    Explore Wallets, Applications and Programmes within the Polkadot Ecosystem.

    Learn

    Learn about Polkadot and how it provides Shared Security and Secure Interoperability to its Parachains.

    Build

    Most up-to-date Information on the Status of the Development Tools in the Polkadot Ecosystem.

    Maintain

    Information and Guides on how to Deploy a Node and Run the Network.

    Learn about Polkadot’s canary network Kusama

    Kusama is Polkadot’s “canary network”, a scalable, multi-chain network for radical innovation and early stage Polkadot deployments. For developers, Kusama is a proving ground for all things Polkadot I.e runtime upgrades, on-chain governance, parachains, parathreads, etc.

    language

    Help improve this wiki

    This wiki was started by and is maintained by Web3 Foundation. It is an open-source-ish project and aims to be the most extensive resource of knowledge on Polkadot and the Polkadot ecosystem.

    - + \ No newline at end of file diff --git a/search.html b/search.html index 6be943ee239c..7e8f09172ff2 100644 --- a/search.html +++ b/search.html @@ -18,14 +18,14 @@ - - + +

    Search the documentation

    - + \ No newline at end of file