https://solana.com/docs-assets/_next/static/chunks/4712-9ca06b064f…?dpl=dpl_H4bDF4iCtpav6g7Ljf9E9jvysUAm

1try{!function(){var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},t=(new e.Error).stack;t&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[t]="225b1e06-eef6-4793-a9da-852ce2c4b5f3",e._sentryDebugIdIdentifier="sentry-dbid-225b1e06-eef6-4793-a9da-852ce2c4b5f3")}()}catch(e){}"use strict";(self.webpackChunk_N_E=self.webpackChunk_N_E||[]).push([[4712],{2498:(e,t,r)=>{r.d(t,{T:()=>o});var n=r(66774);function o(e,t,r=function e(t,r){return Array.isArray(t)&&Array.isArray(r)?r.length!==t.length||t.some((t,n)=>e(t,r[n])):t!==r}){let[a,l]=(0,n.useState)(e);r(a,e)&&(t(e,a),l(e))}},6817:(e,t,r)=>{function n(e,t,r){let{includePage:n=!0,includeSeparator:o=!1,includeRoot:a}=r,l=[];return t.forEach((e,r)=>{if("separator"===e.type&&e.name&&o&&l.push({name:e.name}),"folder"===e.type){let n=t.at(r+1);if(n&&e.index===n)return;if(e.root){l=[];return}l.push({name:e.name,url:e.index?.url})}"page"===e.type&&n&&l.push({name:e.name,url:e.url})}),a&&l.unshift({name:e.name,url:"object"==typeof a?a.url:void 0}),l}r.d(t,{Pp:()=>n,oe:()=>function e(t,r){let n;for(let o of(r.endsWith("/")&&(r=r.slice(0,-1)),t)){if("separator"===o.type&&(n=o),"folder"===o.type){if(o.index?.url===r){let e=[];return n&&e.push(n),e.push(o,o.index),e}let t=e(o.children,r);if(t)return t.unshift(o),n&&t.unshift(n),t}if("page"===o.type&&o.url===r){let e=[];return n&&e.push(n),e.push(o),e}}return null}}),r(16560),r(66774)},10175:(e,t,r)=>{r.d(t,{Ke:()=>u,Nt:()=>s,R6:()=>i});var n=r(36822),o=r(22376),a=r(66774),l=r(13964);let s=o.bL,i=o.R6,u=(0,a.forwardRef)(({children:e,...t},r)=>(0,n.jsx)(o.Ke,{ref:r,...t,className:(0,l.QP)("overflow-hidden [--radix-collapsible-content-height:0px] data-[state=closed]:animate-fd-collapsible-up data-[state=open]:animate-fd-collapsible-down",t.className),children:e}));u.displayName=o.Ke.displayName},24195:(e,t,r)=>{r.d(t,{AM:()=>H,hl:()=>z,Wv:()=>Y});var n=r(36822),o=r(66774),a=r(87305),l=r(51652),s=r(8094),i=r(76551),u=r(187),d=r(91447),c=r(68157),f=r(30186),p=r(23535),h=r(48012),m=r(89033),v=r(8890),g=r(47001),y=r(11925),x=r(43048),b="Popover",[w,C]=(0,s.A)(b,[f.Bk]),P=(0,f.Bk)(),[S,j]=w(b),k=e=>{let{__scopePopover:t,children:r,open:a,defaultOpen:l,onOpenChange:s,modal:i=!1}=e,u=P(t),d=o.useRef(null),[p,h]=o.useState(!1),[m,v]=(0,g.i)({prop:a,defaultProp:null!=l&&l,onChange:s,caller:b});return(0,n.jsx)(f.bL,{...u,children:(0,n.jsx)(S,{scope:t,contentId:(0,c.B)(),triggerRef:d,open:m,onOpenChange:v,onOpenToggle:o.useCallback(()=>v(e=>!e),[v]),hasCustomAnchor:p,onCustomAnchorAdd:o.useCallback(()=>h(!0),[]),onCustomAnchorRemove:o.useCallback(()=>h(!1),[]),modal:i,children:r})})};k.displayName=b;var E="PopoverAnchor";o.forwardRef((e,t)=>{let{__scopePopover:r,...a}=e,l=j(E,r),s=P(r),{onCustomAnchorAdd:i,onCustomAnchorRemove:u}=l;return o.useEffect(()=>(i(),()=>u()),[i,u]),(0,n.jsx)(f.Mz,{...s,...a,ref:t})}).displayName=E;var T="PopoverTrigger",A=o.forwardRef((e,t)=>{let{__scopePopover:r,...o}=e,s=j(T,r),i=P(r),u=(0,l.s)(t,s.triggerRef),d=(0,n.jsx)(m.sG.button,{type:"button","aria-haspopup":"dialog","aria-expanded":s.open,"aria-controls":s.contentId,"data-state":W(s.open),...o,ref:u,onClick:(0,a.mK)(e.onClick,s.onOpenToggle)});return s.hasCustomAnchor?d:(0,n.jsx)(f.Mz,{asChild:!0,...i,children:d})});A.displayName=T;var L="PopoverPortal",[N,O]=w(L,{forceMount:void 0}),R=e=>{let{__scopePopover:t,forceMount:r,children:o,container:a}=e,l=j(L,t);return(0,n.jsx)(N,{scope:t,forceMount:r,children:(0,n.jsx)(h.C,{present:r||l.open,children:(0,n.jsx)(p.Z,{asChild:!0,container:a,children:o})})})};R.displayName=L;var M="PopoverContent",D=o.forwardRef((e,t)=>{let r=O(M,e.__scopePopover),{forceMount:o=r.forceMount,...a}=e,l=j(M,e.__scopePopover);return(0,n.jsx)(h.C,{present:o||l.open,children:l.modal?(0,n.jsx)(_,{...a,ref:t}):(0,n.jsx)(K,{...a,ref:t})})});D.displayName=M;var I=(0,v.TL)("PopoverContent.RemoveScroll"),_=o.forwardRef((e,t)=>{let r=j(M,e.__scopePopover),s=o.useRef(null),i=(0,l.s)(t,s),u=o.useRef(!1);return o.useEffect(()=>{let e=s.current;if(e)return(0,y.Eq)(e)},[]),(0,n.jsx)(x.A,{as:I,allowPinchZoom:!0,children:(0,n.jsx)(F,{...e,ref:i,trapFocus:r.open,disableOutsidePointerEvents:!0,onCloseAutoFocus:(0,a.mK)(e.onCloseAutoFocus,e=>{var t;e.preventDefault(),u.current||null==(t=r.triggerRef.current)||t.focu

1s()}),onPointerDownOutside:(0,a.mK)(e.onPointerDownOutside,e=>{let t=e.detail.originalEvent,r=0===t.button&&!0===t.ctrlKey;u.current=2===t.button||r},{checkForDefaultPrevented:!1}),onFocusOutside:(0,a.mK)(e.onFocusOutside,e=>e.preventDefault(),{checkForDefaultPrevented:!1})})})}),K=o.forwardRef((e,t)=>{let r=j(M,e.__scopePopover),a=o.useRef(!1),l=o.useRef(!1);return(0,n.jsx)(F,{...e,ref:t,trapFocus:!1,disableOutsidePointerEvents:!1,onCloseAutoFocus:t=>{var n,o;null==(n=e.onCloseAutoFocus)||n.call(e,t),t.defaultPrevented||(a.current||null==(o=r.triggerRef.current)||o.focus(),t.preventDefault()),a.current=!1,l.current=!1},onInteractOutside:t=>{var n,o;null==(n=e.onInteractOutside)||n.call(e,t),t.defaultPrevented||(a.current=!0,"pointerdown"===t.detail.originalEvent.type&&(l.current=!0));let s=t.target;(null==(o=r.triggerRef.current)?void 0:o.contains(s))&&t.preventDefault(),"focusin"===t.detail.originalEvent.type&&l.current&&t.preventDefault()}})}),F=o.forwardRef((e,t)=>{let{__scopePopover:r,trapFocus:o,onOpenAutoFocus:a,onCloseAutoFocus:l,disableOutsidePointerEvents:s,onEscapeKeyDown:c,onPointerDownOutside:p,onFocusOutside:h,onInteractOutside:m,...v}=e,g=j(M,r),y=P(r);return(0,u.Oh)(),(0,n.jsx)(d.n,{asChild:!0,loop:!0,trapped:o,onMountAutoFocus:a,onUnmountAutoFocus:l,children:(0,n.jsx)(i.qW,{asChild:!0,disableOutsidePointerEvents:s,onInteractOutside:m,onEscapeKeyDown:c,onPointerDownOutside:p,onFocusOutside:h,onDismiss:()=>g.onOpenChange(!1),children:(0,n.jsx)(f.UC,{"data-state":W(g.open),role:"dialog",id:g.contentId,...y,...v,ref:t,style:{...v.style,"--radix-popover-content-transform-origin":"var(--radix-popper-transform-origin)","--radix-popover-content-available-width":"var(--radix-popper-available-width)","--radix-popover-content-available-height":"var(--radix-popper-available-height)","--radix-popover-trigger-width":"var(--radix-popper-anchor-width)","--radix-popover-trigger-height":"var(--radix-popper-anchor-height)"}})})})}),G="PopoverClose";function W(e){return e?"open":"closed"}o.forwardRef((e,t)=>{let{__scopePopover:r,...o}=e,l=j(G,r);return(0,n.jsx)(m.sG.button,{type:"button",...o,ref:t,onClick:(0,a.mK)(e.onClick,()=>l.onOpenChange(!1))})}).displayName=G,o.forwardRef((e,t)=>{let{__scopePopover:r,...o}=e,a=P(r);return(0,n.jsx)(f.i3,{...a,...o,ref:t})}).displayName="PopoverArrow";var B=r(13964);let H=k,Y=A,z=o.forwardRef((e,t)=>{let{className:r,align:o="center",sideOffset:a=4,...l}=e;return(0,n.jsx)(R,{children:(0,n.jsx)(D,{ref:t,align:o,sideOffset:a,side:"bottom",className:(0,B.QP)("z-50 min-w-[220px] max-w-[98vw] rounded-lg border bg-fd-popover p-2 text-sm text-fd-popover-foreground shadow-md focus-visible:outline-none data-[state=closed]:animate-fd-popover-out data-[state=open]:animate-fd-popover-in",r),...l})})});z.displayName=D.displayName},24970:(e,t,r)=>{r.d(t,{G:()=>d,c:()=>u});var n=r(36822),o=r(66774),a=r(8703),l=r(28894),s=r(96044);let i=(0,o.createContext)(void 0);function u(){let e=(0,o.useContext)(i);if(!e)throw Error("Missing root provider");return e}function d({children:e}){let t=(0,o.useRef)(!0),[r,u]=(0,o.useState)(!1),[d,c]=(0,o.useState)(!1),f=(0,a.usePathname)();return(0,s.T)(f,()=>{t.current&&u(!1),t.current=!0}),(0,n.jsx)(i.Provider,{value:(0,o.useMemo)(()=>({open:r,setOpen:u,collapsed:d,setCollapsed:c,closeOnRedirect:t}),[r,d]),children:(0,n.jsx)(l.GB,{open:r,onOpenChange:u,children:e})})}},28894:(e,t,r)=>{r.d(t,{Pg:()=>d,GB:()=>i,x2:()=>u});var n=r(66774);r(16560);var o=r(43048),a=r(36822),l=(0,n.createContext)(null);function s(){let e=(0,n.useContext)(l);if(!e)throw Error("Missing sidebar provider");return e}function i(e){let[t,r]=void 0===e.open?(0,n.useState)(!1):[e.open,e.onOpenChange];return(0,a.jsx)(l.Provider,{value:(0,n.useMemo)(()=>({open:t,setOpen:null!=r?r:()=>void 0}),[t,r]),children:e.children})}function u(e){let{as:t,...r}=e,{open:n,setOpen:o}=s();return(0,a.jsx)(null!=t?t:"button",{"aria-label":"Toggle Sidebar","data-open":n,onClick:()=>{o(!n)},...r})}function d(e){var t;let{as:r,blockScrollingWidth:l,removeScrollOn:i=l?"(width < ".concat(l,"px)"):void 0,...u}=e,{open:d}

1=s(),c=null!=(t=function(e,t=!1){let[r,o]=(0,n.useState)(null);return(0,n.useEffect)(()=>{if(t)return;let r=window.matchMedia(e),n=()=>{o(r.matches)};return n(),r.addEventListener("change",n),()=>{r.removeEventListener("change",n)}},[t,e]),r}(null!=i?i:"",!i))&&t;return(0,a.jsx)(o.A,{as:null!=r?r:"aside","data-open":d,enabled:c&&d,...u,children:u.children})}},29e3:(e,t,r)=>{r.r(t),r.d(t,{I18nLabel:()=>u.I18nLabel,RootProvider:()=>p,SearchOnly:()=>i.r0,SearchProvider:()=>i.YL,SidebarProvider:()=>s.G,StylesProvider:()=>c.StylesProvider,TreeContextProvider:()=>d.TreeContextProvider,useI18n:()=>u.s9,usePageStyles:()=>c.v,useSearchContext:()=>i.$A,useSidebar:()=>s.c,useTreeContext:()=>d.t,useTreePath:()=>d.L});var n=r(36822),o=r(95150),a=r(30596),l=r(92473),s=r(24970),i=r(75746),u=r(65770),d=r(47558),c=r(44096);let f=(0,a.default)(()=>r.e(9996).then(r.bind(r,69996)),{loadableGenerated:{webpack:()=>[require.resolveWeak("./components/dialog/search-default")]},ssr:!1});function p(e){let{children:t,dir:r,theme:{enabled:a=!0,...u}={},search:d}=e,c=t;return(null==d?void 0:d.enabled)!==!1&&(c=(0,n.jsx)(i.YL,{SearchDialog:f,...d,children:c})),a&&(c=(0,n.jsx)(o.N,{attribute:"class",defaultTheme:"system",enableSystem:!0,disableTransitionOnChange:!0,...u,children:c})),(0,n.jsx)(l.FX,{dir:null!=r?r:"ltr",children:(0,n.jsx)(s.G,{children:c})})}},44096:(e,t,r)=>{r.d(t,{StylesProvider:()=>s,v:()=>l});var n=r(36822),o=r(66774);let a=(0,o.createContext)({tocNav:"xl:hidden",toc:"max-xl:hidden"});function l(){return(0,o.useContext)(a)}function s(e){let{children:t,...r}=e;return(0,n.jsx)(a.Provider,{value:r,children:t})}},47558:(e,t,r)=>{r.d(t,{L:()=>d,TreeContextProvider:()=>u,t:()=>c});var n=r(36822),o=r(8703),a=r(66774),l=r(6817);let s=(0,a.createContext)(null),i=(0,a.createContext)([]);function u(e){var t;let{children:r,tree:u}=e,d=(0,o.usePathname)(),c=(0,a.useMemo)(()=>{var e;return null!=(e=(0,l.oe)(u.children,d))?e:[]},[d,u]),f=null!=(t=c.findLast(e=>"folder"===e.type&&e.root))?t:u;return(0,n.jsx)(s.Provider,{value:(0,a.useMemo)(()=>({root:f}),[f]),children:(0,n.jsx)(i.Provider,{value:c,children:r})})}function d(){return(0,a.useContext)(i)}function c(){let e=(0,a.useContext)(s);if(!e)throw Error("You must wrap this component under <DocsLayout />");return e}},65770:(e,t,r)=>{r.d(t,{I18nLabel:()=>a,gJ:()=>o,s9:()=>l});var n=r(66774);let o=(0,n.createContext)({text:{search:"Search",searchNoResult:"No results found",toc:"On this page",tocNoHeadings:"No Headings",lastUpdate:"Last updated on",chooseLanguage:"Choose a language",nextPage:"Next",previousPage:"Previous",chooseTheme:"Theme",editOnGithub:"Edit on GitHub"}});function a(e){let{text:t}=l();return t[e.label]}function l(){return(0,n.useContext)(o)}},71974:(e,t,r)=>{r.d(t,{NavProvider:()=>u,Title:()=>c,h:()=>d});var n=r(36822),o=r(68036),a=r(66774),l=r(13964),s=r(65770);let i=(0,a.createContext)({isTransparent:!1});function u(e){let{transparentMode:t="none",children:r}=e,[o,l]=(0,a.useState)("none"!==t);return(0,a.useEffect)(()=>{if("top"!==t)return;let e=()=>{l(window.scrollY<10)};return e(),window.addEventListener("scroll",e),()=>{window.removeEventListener("scroll",e)}},[t]),(0,n.jsx)(i.Provider,{value:{isTransparent:o},children:r})}function d(){return(0,a.useContext)(i)}function c(e){let{title:t,url:r,...a}=e,{locale:i}=(0,s.s9)();return(0,n.jsx)(o.default,{href:null!=r?r:i?"/".concat(i):"/",...a,className:(0,l.QP)("inline-flex items-center gap-2.5 font-semibold",a.className),children:t})}},75746:(e,t,r)=>{r.d(t,{$A:()=>l,YL:()=>i,r0:()=>u});var n=r(36822),o=r(66774);let a=(0,o.createContext)({enabled:!1,hotKey:[],setOpenSearch:()=>void 0});function l(){return(0,o.useContext)(a)}function s(){let[e,t]=(0,o.useState)("⌘");return(0,o.useEffect)(()=>{window.navigator.userAgent.includes("Windows")&&t("Ctrl")},[]),e}function i(e){let{SearchDialog:t,children:r,preload:l=!0,options:i,hotKey:u=[{key:e=>e.metaKey||e.ctrlKey,display:(0,n.jsx)(s,{})},{key:"k",display:"K"}],links:d}=e,[c,f]=(0,o.useState)(!l&&void 0);return(0,o.useEffect)(()=>{let e=e=>{u.every(t=>"string"==typeof t.key?e.key===t.key:t.key(e))&&(f(!0),e.preventDefault())};return window.addEventListener("keydown",e),()=>{window.removeEventListener("keydown",e)}},[u]),(0,n.jsxs)(a.Provider,{value:(0,o.useMemo)(()=>({enabled:!0,hotKey:u,setOpenSearch:f}),[u]),children:[void 0!==c&&(0,n.jsx)(t,{open:c,onOpenChange:f,links:d,...i}),r]})}function u(e){let{children:t}=e;if(l().enabled)return t}},87876:(e,t,r)=>{r.d(t,{$:()=>n});function n(e,t,r=!0){return e.endsWith("/")&&(e=e.slice(0,-1)),t.endsWith("/")&&(t=t.

1slice(0,-1)),e===t||r&&t.startsWith(`${e}/`)}},95150:(e,t,r)=>{r.d(t,{D:()=>d,N:()=>c});var n=r(66774),o=(e,t,r,n,o,a,l,s)=>{let i=document.documentElement,u=["light","dark"];function d(t){var r;(Array.isArray(e)?e:[e]).forEach(e=>{let r="class"===e,n=r&&a?o.map(e=>a[e]||e):o;r?(i.classList.remove(...n),i.classList.add(a&&a[t]?a[t]:t)):i.setAttribute(e,t)}),r=t,s&&u.includes(r)&&(i.style.colorScheme=r)}if(n)d(n);else try{let e=localStorage.getItem(t)||r,n=l&&"system"===e?window.matchMedia("(prefers-color-scheme: dark)").matches?"dark":"light":e;d(n)}catch(e){}},a=["light","dark"],l="(prefers-color-scheme: dark)",s="undefined"==typeof window,i=n.createContext(void 0),u={setTheme:e=>{},themes:[]},d=()=>{var e;return null!=(e=n.useContext(i))?e:u},c=e=>n.useContext(i)?n.createElement(n.Fragment,null,e.children):n.createElement(p,{...e}),f=["light","dark"],p=e=>{let{forcedTheme:t,disableTransitionOnChange:r=!1,enableSystem:o=!0,enableColorScheme:s=!0,storageKey:u="theme",themes:d=f,defaultTheme:c=o?"system":"light",attribute:p="data-theme",value:y,children:x,nonce:b,scriptProps:w}=e,[C,P]=n.useState(()=>m(u,c)),[S,j]=n.useState(()=>"system"===C?g():C),k=y?Object.values(y):d,E=n.useCallback(e=>{let t=e;if(!t)return;"system"===e&&o&&(t=g());let n=y?y[t]:t,l=r?v(b):null,i=document.documentElement,u=e=>{"class"===e?(i.classList.remove(...k),n&&i.classList.add(n)):e.startsWith("data-")&&(n?i.setAttribute(e,n):i.removeAttribute(e))};if(Array.isArray(p)?p.forEach(u):u(p),s){let e=a.includes(c)?c:null,r=a.includes(t)?t:e;i.style.colorScheme=r}null==l||l()},[b]),T=n.useCallback(e=>{let t="function"==typeof e?e(C):e;P(t);try{localStorage.setItem(u,t)}catch(e){}},[C]),A=n.useCallback(e=>{j(g(e)),"system"===C&&o&&!t&&E("system")},[C,t]);n.useEffect(()=>{let e=window.matchMedia(l);return e.addListener(A),A(e),()=>e.removeListener(A)},[A]),n.useEffect(()=>{let e=e=>{e.key===u&&(e.newValue?P(e.newValue):T(c))};return window.addEventListener("storage",e),()=>window.removeEventListener("storage",e)},[T]),n.useEffect(()=>{E(null!=t?t:C)},[t,C]);let L=n.useMemo(()=>({theme:C,setTheme:T,forcedTheme:t,resolvedTheme:"system"===C?S:C,themes:o?[...d,"system"]:d,systemTheme:o?S:void 0}),[C,T,t,S,o,d]);return n.createElement(i.Provider,{value:L},n.createElement(h,{forcedTheme:t,storageKey:u,attribute:p,enableSystem:o,enableColorScheme:s,defaultTheme:c,value:y,themes:d,nonce:b,scriptProps:w}),x)},h=n.memo(e=>{let{forcedTheme:t,storageKey:r,attribute:a,enableSystem:l,enableColorScheme:s,defaultTheme:i,value:u,themes:d,nonce:c,scriptProps:f}=e,p=JSON.stringify([a,r,i,t,d,u,l,s]).slice(1,-1);return n.createElement("script",{...f,suppressHydrationWarning:!0,nonce:"undefined"==typeof window?c:"",dangerouslySetInnerHTML:{__html:"(".concat(o.toString(),")(").concat(p,")")}})}),m=(e,t)=>{let r;if(!s){try{r=localStorage.getItem(e)||void 0}catch(e){}return r||t}},v=e=>{let t=document.createElement("style");return e&&t.setAttribute("nonce",e),t.appendChild(document.createTextNode("*,*::before,*::after{-webkit-transition:none!important;-moz-transition:none!important;-o-transition:none!important;-ms-transition:none!important;transition:none!important}")),document.head.appendChild(t),()=>{window.getComputedStyle(document.body),setTimeout(()=>{document.head.removeChild(t)},1)}},g=e=>(e||(e=window.matchMedia(l)),e.matches?"dark":"light")},96044:(e,t,r)=>{r.d(t,{T:()=>n.T});var n=r(2498);r(16560)}}]);