Raffl is a permissionless web3 platform that allows users to create and participate in raffles and lotteries with complete transparency, security, and fairness.
Raffl is available on Base, Arbitrum, Polygon and Sepolia.
Whether you’re a user looking to participate in a raffle, a creator keen on launching a unique lottery, or a developer planning to integrate Raffl into your protocol, you’ll find the information you need right here. This comprehensive guide will walk you through the process of setting up and managing your raffles, navigating our platform, and even diving deep into the technical aspects if you so wish!Here’s what you can expect to find:
How-To Guides: Step-by-step instructions on how to create raffles, participate in raffles, claim prizes, and more.
Feature Overview: Detailed insights into our range of features and how they can enhance your raffle experience.
Frequently Asked Questions (FAQs): Answers to common questions about our platform.
Integration Guide: Detailed instructions on how to integrate Raffl into your own protocol.
Contact Information: Details on how to get in touch with us for support, partnership inquiries, or anything else you might need.
We’ve designed this documentation to be as clear and straightforward as possible, but if you can’t find what you’re looking for, don’t hesitate to reach out. We’re here to help!We’re excited to see what you create with Raffl. Happy raffling!
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"Raffl Docs","colors":{"primary":"#6d28d9","light":"#ae7aff","dark":"#6d28d9"},"favicon":"/favicon.svg","logo":{"light":"https://mintcdn.com/raffl/HE1veC8Qm6-Igieo/logo/logo.svg?fit=max\u0026auto=format\u0026n=HE1veC8Qm6-Igieo\u0026q=85\u0026s=44829af98cc8032a552aeaf82ce7f774","dark":"https://mintcdn.com/raffl/HE1veC8Qm6-Igieo/logo/logo.svg?fit=max\u0026auto=format\u0026n=HE1veC8Qm6-Igieo\u0026q=85\u0026s=44829af98cc8032a552aeaf82ce7f774"},"appearance":{"default":"dark","strict":null},"navbar":{"links":[{"label":"Contact Us","href":"mailto:ja@raffl.xyz"}],"primary":{"type":"button","label":"Dashboard","href":"https://raffl.xyz"}},"footer":{"socials":{"x":"https://x.com/rafflxyz","github":"https://github.com/raffleth"}},"navigation":{"global":{"anchors":[{"anchor":"Dashboard","href":"https://raffl.xyz","icon":"gauge"},{"anchor":"Github","href":"https://github.com/raffleth","icon":"github"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"raffl","hasAudioNarration":false,"actualSubdomain":"raffl","customDomains":["docs.raffl.xyz"],"gitSource":{"type":"github","owner":"raffleth","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a21e63303d4026a3ef76817","collectionId":"6992ce2d-1a0b-4447-9212-6b0beb77246f","schemaVersion":"v2"},"entitlements":{},"buildId":"6a21e63303d4026a3ef76817:success","clientVersion":"0.0.3964","searchFilterCounts":[{"language":"default","tag":"Documentation","count":16},{"language":"default","tag":"Protocol","count":15},{"language":"default","tag":"Technical","count":11},{"language":"default","tag":"FAQs","count":8},{"language":"default","tag":"Smart Contracts","count":4},{"language":"default","tag":"Interfaces","count":4},{"language":"default","tag":"Libraries","count":3},{"language":"default","tag":"Tutorials","count":3},{"language":"default","tag":"Contact Us","count":2},{"language":"default","tag":"Abstracts","count":2}]},"assistantConfig":{},"hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"introduction","slug":"/introduction","pageMetadata":{"title":"Welcome to Raffl","description":"Raffl is a permissionless web3 platform that allows users to create and participate in raffles and lotteries with complete transparency, security, and fairness.","href":"/introduction"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Raffl is a permissionless web3 platform that allows users to create and participate in raffles and lotteries with complete transparency, security, and fairness.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Frame,Note,OptimizedImage}=_components;if(!Frame)_missingMdxReference(`Frame`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);return _jsxs(_Fragment,{children:[_jsx(Note,{children:_jsx(_components.p,{children:`Raffl is available on Base, Arbitrum, Polygon and Sepolia.`})}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/raffl/HE1veC8Qm6-Igieo/images/raffl-cover.png?fit=max\u0026auto=format\u0026n=HE1veC8Qm6-Igieo\u0026q=85\u0026s=cef5d378802bdcd611048af034474466`,alt:`Logo`,\"data-og-width\":`1920`,width:`1920`,\"data-og-height\":`1280`,height:`1280`,\"data-path\":`images/raffl-cover.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/raffl/HE1veC8Qm6-Igieo/images/raffl-cover.png?w=280\u0026fit=max\u0026auto=format\u0026n=HE1veC8Qm6-Igieo\u0026q=85\u0026s=c9298fadbed6b8cd1f3d1f311e6e68b9 280w, https://mintcdn.com/raffl/HE1veC8Qm6-Igieo/images/raffl-cover.png?w=560\u0026fit=max\u0026auto=format\u0026n=HE1veC8Qm6-Igieo\u0026q=85\u0026s=e535679daeb20696c0b9f8edcd9a922f 560w, https://mintcdn.com/raffl/HE1veC8Qm6-Igieo/images/raffl-cover.png?w=840\u0026fit=max\u0026auto=format\u0026n=HE1veC8Qm6-Igieo\u0026q=85\u0026s=3789630f6bd984bc2cc4cb0b96cd3f8c 840w, https://mintcdn.com/raffl/HE1veC8Qm6-Igieo/images/raffl-cover.png?w=1100\u0026fit=max\u0026auto=format\u0026n=HE1veC8Qm6-Igieo\u0026q=85\u0026s=a8d0ce000ae6754fcbeefae4497bef11 1100w, https://mintcdn.com/raffl/HE1veC8Qm6-Igieo/images/raffl-cover.png?w=1650\u0026fit=max\u0026auto=format\u0026n=HE1veC8Qm6-Igieo\u0026q=85\u0026s=8af3a7c34f50563bbc4db9563c8ecd17 1650w, https://mintcdn.com/raffl/HE1veC8Qm6-Igieo/images/raffl-cover.png?w=2500\u0026fit=max\u0026auto=format\u0026n=HE1veC8Qm6-Igieo\u0026q=85\u0026s=df0092c0883cd805f982b368eaec2d7e 2500w`})}),`\n`,_jsx(_components.p,{children:`Whether you’re a user looking to participate in a raffle, a creator keen on launching a unique lottery, or a developer planning to integrate Raffl into your protocol, you’ll find the information you need right here. This comprehensive guide will walk you through the process of setting up and managing your raffles, navigating our platform, and even diving deep into the technical aspects if you so wish!`}),`\n`,_jsx(_components.p,{children:`Here’s what you can expect to find:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`How-To Guides:`}),` Step-by-step instructions on how to create raffles, participate in raffles, claim prizes, and more.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Feature Overview:`}),` Detailed insights into our range of features and how they can enhance your raffle experience.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Frequently Asked Questions (FAQs):`}),` Answers to common questions about our platform.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Integration Guide:`}),` Detailed instructions on how to integrate Raffl into your own protocol.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Contact Information:`}),` Details on how to get in touch with us for support, partnership inquiries, or anything else you might need.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`We’ve designed this documentation to be as clear and straightforward as possible, but if you can’t find what you’re looking for, don’t hesitate to reach out. We’re here to help!`}),`\n`,_jsx(_components.p,{children:`We’re excited to see what you create with Raffl. Happy raffling!`})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Welcome to Raffl","description":"Raffl is a permissionless web3 platform that allows users to create and participate in raffles and lotteries with complete transparency, security, and fairness.","href":"/introduction"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"subdomain":"raffl","siteName":"Raffl Docs","title":"Welcome to Raffl - Raffl Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-07T02:41:20.492Z","originalFileLocation":"introduction.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Raffl is a permissionless web3 platform that allows users to create and participate in raffles and lotteries with complete transparency, security, and fairness.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Raffl Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/raffl/VN0oObxT4FDvIpJi/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/raffl/VN0oObxT4FDvIpJi/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/raffl/VN0oObxT4FDvIpJi/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/raffl/VN0oObxT4FDvIpJi/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/raffl/VN0oObxT4FDvIpJi/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/raffl/VN0oObxT4FDvIpJi/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/raffl/VN0oObxT4FDvIpJi/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/raffl/VN0oObxT4FDvIpJi/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/raffl/VN0oObxT4FDvIpJi/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Welcome to Raffl - Raffl Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Raffl is a permissionless web3 platform that allows users to create and participate in raffles and lotteries with complete transparency, security, and fairness.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Raffl Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.raffl.xyz/introduction\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://raffl.mintlify.app/_mintlify/api/og/v2?division=Documentation\u0026amp;title=Welcome+to+Raffl\u0026amp;description=Raffl+is+a+permissionless+web3+platform+that+allows+users+to+create+and+participate+in+raffles+and+lotteries+with+complete+transparency%2C+security%2C+and+fairness.\u0026amp;theme=8d863d7b91cd17ca4be00e0b\u0026amp;signature=7eca3c3d1bd38009aec7281a640a094ef200f2c0201d4c0a428e343617e43921\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Welcome to Raffl - Raffl Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Raffl is a permissionless web3 platform that allows users to create and participate in raffles and lotteries with complete transparency, security, and fairness.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://raffl.mintlify.app/_mintlify/api/og/v2?division=Documentation\u0026amp;title=Welcome+to+Raffl\u0026amp;description=Raffl+is+a+permissionless+web3+platform+that+allows+users+to+create+and+participate+in+raffles+and+lotteries+with+complete+transparency%2C+security%2C+and+fairness.\u0026amp;theme=8d863d7b91cd17ca4be00e0b\u0026amp;signature=7eca3c3d1bd38009aec7281a640a094ef200f2c0201d4c0a428e343617e43921\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/raffl/VN0oObxT4FDvIpJi/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Raffl Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6d28d9\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.raffl.xyz/introduction\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/introduction.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.raffl.xyz/#organization\",\"name\":\"Raffl Docs\",\"url\":\"https://docs.raffl.xyz\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/raffl/HE1veC8Qm6-Igieo/logo/logo.svg?fit=max\u0026auto=format\u0026n=HE1veC8Qm6-Igieo\u0026q=85\u0026s=44829af98cc8032a552aeaf82ce7f774\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.raffl.xyz#website\",\"name\":\"Raffl Docs\",\"url\":\"https://docs.raffl.xyz\",\"publisher\":{\"@id\":\"https://docs.raffl.xyz/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.raffl.xyz/introduction#webpage\",\"url\":\"https://docs.raffl.xyz/introduction\",\"name\":\"Welcome to Raffl\",\"description\":\"Raffl is a permissionless web3 platform that allows users to create and participate in raffles and lotteries with complete transparency, security, and fairness.\",\"dateModified\":\"2026-01-07T02:41:20.492Z\",\"isPartOf\":{\"@id\":\"https://docs.raffl.xyz#website\"},\"breadcrumb\":{\"@id\":\"https://docs.raffl.xyz/introduction#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.raffl.xyz/introduction#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Raffl Docs\",\"item\":\"https://docs.raffl.xyz\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Welcome to Raffl\",\"item\":\"https://docs.raffl.xyz/introduction\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.raffl.xyz/introduction#article\",\"headline\":\"Welcome to Raffl\",\"name\":\"Welcome to Raffl\",\"description\":\"Raffl is a permissionless web3 platform that allows users to create and participate in raffles and lotteries with complete transparency, security, and fairness.\",\"url\":\"https://docs.raffl.xyz/introduction\",\"mainEntityOfPage\":{\"@id\":\"https://docs.raffl.xyz/introduction#webpage\"},\"dateModified\":\"2026-01-07T02:41:20.492Z\",\"publisher\":{\"@id\":\"https://docs.raffl.xyz/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.raffl.xyz#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Raffl Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Raffl Docs","nav":{"global":{"anchors":[{"anchor":"Dashboard","href":"https://raffl.xyz","icon":"gauge"},{"anchor":"Github","href":"https://github.com/raffleth","icon":"github"}]},"tabs":[{"tab":"Documentation","groups":[{"group":"","pages":[{"title":"Welcome to Raffl","href":"/introduction"},{"title":"Features","description":null,"href":"/features"},{"title":"Why use Raffl?","href":"/why-use-raffl"}]},{"group":"Tutorials","pages":[{"title":"How to Create a Raffle?","href":"/tutorials/how-to-create"},{"title":"How to Participate in a Raffle?","href":"/tutorials/how-to-participate"},{"title":"How to Token Gate Raffles?","href":"/tutorials/how-to-restrict-to-holders"}]},{"group":"FAQs","pages":[{"title":"What Happens if the Draw is Not Made?","href":"/faq/what-happens-if-draw-is-not-made"},{"title":"How to Claim My Rewards on Raffl?","href":"/faq/how-to-claim-rewards"},{"title":"How to Find Out Who is the Winner?","href":"/faq/how-to-know-who-is-the-winner"},{"title":"How to Find Out the Total Number of Entries on Raffl?","href":"/faq/is-there-a-way-to-know-total-entries"},{"title":"Can I Manually Cancel a Raffle?","href":"/faq/is-there-a-way-to-manually-cancel-a-raffle"},{"title":"How Can I Request a Refund on My Entry?","href":"/faq/is-there-a-way-to-request-a-refund"},{"title":"What happens to the pooled entries?","href":"/faq/what-happens-to-pooled-entries"},{"title":"How is Raffl different from traditional raffles and lotteries?","href":"/faq/how-is-raffl-different-from-a-traditional-raffle"}]},{"group":"Contact Us","pages":[{"title":null,"href":"/business-partnerships"},{"title":null,"href":"/contact-us"}]}]},{"tab":"Protocol","pages":[{"title":"Protocol","href":"/protocol/introduction"}]}]},"title":"Welcome to Raffl - Raffl Docs","buildId":"dpl_HcHmUS6i3UwswnTHJUEdcTtwfdTQ","deploymentId":"dpl_HcHmUS6i3UwswnTHJUEdcTtwfdTQ","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-D1UCVuPB.js","DynamicMarkdown-Crwq6WG_.js","zoom-image-lightbox-CFBqa0On.js","lightbox-handle-r17bVUz3.js"]}