Fee-on-transfer tokens will not function with our router contracts. As a workaround, the token creators may create a token wrapper or a customized router. We will not be making a router that supports fee-on-transfer tokens in the future.
Rebasing tokens will succeed in pool creation and swapping, but liquidity providers will bear the loss of a negative rebase when their position becomes active, with no way to recover the loss.
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Ramses Technical Documentation","colors":{"primary":"#161718","light":"#FFFFFF","dark":"#FFFFFF"},"logo":{"light":"https://mintcdn.com/ramses/nvKKukknXVTxMy0x/images/logo.png?fit=max\u0026auto=format\u0026n=nvKKukknXVTxMy0x\u0026q=85\u0026s=8baedca01f01eb1da8b939c567f92483","dark":"https://mintcdn.com/ramses/nvKKukknXVTxMy0x/images/logo.png?fit=max\u0026auto=format\u0026n=nvKKukknXVTxMy0x\u0026q=85\u0026s=8baedca01f01eb1da8b939c567f92483"},"favicon":"https://mintcdn.com/ramses/nvKKukknXVTxMy0x/images/favicon.ico?fit=max\u0026auto=format\u0026n=nvKKukknXVTxMy0x\u0026q=85\u0026s=761eeae2d0e72c0f4a9f1f3f8257295e","api":{"playground":{}},"background":{"color":{"light":"#FFFFFF","dark":"#161718"}},"navbar":{"links":[{"href":"https://github.com/RamsesExchange","label":"GitHub"},{"href":"https://discord.com/ramses","label":"Discord"}],"primary":{"type":"github","href":"https://github.com/RamsesExchange/ramses-v3-contracts"}},"fonts":{"heading":{"family":"Inter","weight":600},"body":{"family":"Inter","weight":400}},"icons":{"library":"lucide"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"ramses","hasAudioNarration":false,"actualSubdomain":"ramses","customDomains":["tech.ramses.xyz"],"gitSource":{"type":"github","owner":"ramsesexchange","repo":"technical-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a923e876fb84ee479df28a7","collectionId":"e79b79bf-9b2e-4d8a-86ae-1e6a32dd9f56","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6a923e876fb84ee479df28a7"},"entitlements":{},"buildId":"6a923e876fb84ee479df28a7","clientVersion":"0.0.3964","searchFilterCounts":[{"language":"default","tag":"Contracts","count":104},{"language":"default","tag":"Reference","count":89},{"language":"default","tag":"SDKs","count":18},{"language":"default","tag":"Periphery Interfaces","count":17},{"language":"default","tag":"Concepts","count":14},{"language":"default","tag":"Guides","count":14},{"language":"default","tag":"Core Libraries","count":14},{"language":"default","tag":"Core Interfaces","count":13},{"language":"default","tag":"Periphery Libraries","count":12},{"language":"default","tag":"Periphery Base","count":9}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","content":":root{--font-size-base:0.9375rem;--line-height-base:1.65}h1{font-size:1.75rem!important;letter-spacing:-.02em}h1,h2,h3,h4{font-weight:600!important}h2{font-size:1.35rem!important;letter-spacing:-.01em}h3,h4{font-size:1.1rem!important}h4{font-size:.95rem!important}li,p,td,th{font-size:var(--font-size-base);line-height:var(--line-height-base)}code:not(pre code){font-size:.85em}pre code{font-size:.8125rem;line-height:1.6}"}],"page":{"pagePath":"concepts/protocol/integration-issues","slug":"/concepts/protocol/integration-issues","pageMetadata":{"title":"Token Integration Issues","description":null,"href":"/concepts/protocol/integration-issues"},"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={p:`p`,..._provideComponents(),...props.components},{Heading}=_components;if(!Heading)_missingMdxReference(`Heading`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Fee-on-transfer and rebasing tokens will not function correctly on v3.`}),`\n`,_jsx(Heading,{level:`2`,id:`fee-on-transfer-tokens`,children:`Fee-on-transfer Tokens`}),`\n`,_jsx(_components.p,{children:`Fee-on-transfer tokens will not function with our router contracts. As a workaround, the token creators may create a token wrapper or a customized router. We will not be making a router that supports fee-on-transfer tokens in the future.`}),`\n`,_jsx(Heading,{level:`2`,id:`rebasing-tokens`,children:`Rebasing Tokens`}),`\n`,_jsx(_components.p,{children:`Rebasing tokens will succeed in pool creation and swapping, but liquidity providers will bear the loss of a negative rebase when their position becomes active, with no way to recover the loss.`})]})}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":"Token Integration Issues","description":null,"href":"/concepts/protocol/integration-issues"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Fee-on-transfer Tokens","slug":"fee-on-transfer-tokens","depth":2,"children":[]},{"title":"Rebasing Tokens","slug":"rebasing-tokens","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"ramses","siteName":"Ramses Technical Documentation","title":"Token Integration Issues - Ramses Technical Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-16T19:46:43.926Z","originalFileLocation":"concepts/protocol/integration-issues.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=\"system\"}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=\"application-name\" content=\"Ramses Technical Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ramses/3PsiHICiYsncsEka/_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/ramses/3PsiHICiYsncsEka/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ramses/3PsiHICiYsncsEka/_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/ramses/3PsiHICiYsncsEka/_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/ramses/3PsiHICiYsncsEka/_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/ramses/3PsiHICiYsncsEka/_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/ramses/3PsiHICiYsncsEka/_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/ramses/3PsiHICiYsncsEka/_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/ramses/3PsiHICiYsncsEka/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Token Integration Issues - Ramses Technical Documentation\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Ramses Technical Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://tech.ramses.xyz/concepts/protocol/integration-issues\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://ramses.mintlify.app/_mintlify/api/og/v2?division=Protocol+Mechanics\u0026amp;title=Token+Integration+Issues\u0026amp;theme=7887b6fe79c9a8d82726952d\u0026amp;signature=bb9b22f6031254429aa74ed871b2731461d8906523644c286f144275560184fa\">\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=\"Token Integration Issues - Ramses Technical Documentation\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ramses.mintlify.app/_mintlify/api/og/v2?division=Protocol+Mechanics\u0026amp;title=Token+Integration+Issues\u0026amp;theme=7887b6fe79c9a8d82726952d\u0026amp;signature=bb9b22f6031254429aa74ed871b2731461d8906523644c286f144275560184fa\">\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/ramses/3PsiHICiYsncsEka/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Ramses Technical Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#161718\">\u003clink data-mint-head rel=\"canonical\" href=\"https://tech.ramses.xyz/concepts/protocol/integration-issues\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/concepts/protocol/integration-issues.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://tech.ramses.xyz/#organization\",\"name\":\"Ramses Technical Documentation\",\"url\":\"https://tech.ramses.xyz\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/ramses/nvKKukknXVTxMy0x/images/logo.png?fit=max\u0026auto=format\u0026n=nvKKukknXVTxMy0x\u0026q=85\u0026s=8baedca01f01eb1da8b939c567f92483\"}},{\"@type\":\"WebSite\",\"@id\":\"https://tech.ramses.xyz#website\",\"name\":\"Ramses Technical Documentation\",\"url\":\"https://tech.ramses.xyz\",\"publisher\":{\"@id\":\"https://tech.ramses.xyz/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://tech.ramses.xyz/concepts/protocol/integration-issues#webpage\",\"url\":\"https://tech.ramses.xyz/concepts/protocol/integration-issues\",\"name\":\"Token Integration Issues\",\"dateModified\":\"2026-08-16T19:46:43.926Z\",\"isPartOf\":{\"@id\":\"https://tech.ramses.xyz#website\"},\"breadcrumb\":{\"@id\":\"https://tech.ramses.xyz/concepts/protocol/integration-issues#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://tech.ramses.xyz/concepts/protocol/integration-issues#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Protocol Mechanics\",\"item\":\"https://tech.ramses.xyz/concepts/protocol/concentrated-liquidity\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Token Integration Issues\",\"item\":\"https://tech.ramses.xyz/concepts/protocol/integration-issues\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://tech.ramses.xyz/concepts/protocol/integration-issues#article\",\"headline\":\"Token Integration Issues\",\"name\":\"Token Integration Issues\",\"url\":\"https://tech.ramses.xyz/concepts/protocol/integration-issues\",\"mainEntityOfPage\":{\"@id\":\"https://tech.ramses.xyz/concepts/protocol/integration-issues#webpage\"},\"dateModified\":\"2026-08-16T19:46:43.926Z\",\"publisher\":{\"@id\":\"https://tech.ramses.xyz/#organization\"},\"isPartOf\":{\"@id\":\"https://tech.ramses.xyz#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Ramses Technical Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Ramses Technical Documentation","nav":{"global":null,"tabs":[{"tab":"Concepts","icon":"book-open","groups":[{"group":"Overview","icon":"map","pages":[{"title":"Concepts Overview","href":"/concepts/overview"},{"title":"Ramses Overview","href":"/concepts/what-is-ramses"},{"title":"The Ramses Protocol","href":"/concepts/ramses-protocol"},{"title":"Token Contracts \u0026 Tokenomics","href":"/concepts/tokenomics"}]},{"group":"Protocol Mechanics","icon":"cpu","pages":[{"title":"Concentrated Liquidity \u0026 Period-Based Accounting","href":"/concepts/protocol/concentrated-liquidity"},{"title":"DLMM \u0026 Liquidity Bins","href":"/concepts/protocol/dlmm"},{"title":"Swaps","href":"/concepts/protocol/swaps"},{"title":"Fees","href":"/concepts/protocol/fees"},{"title":"Oracle","href":"/concepts/protocol/oracle"},{"title":"Range Orders","description":null,"href":"/concepts/protocol/range-orders"},{"title":"Token Integration Issues","href":"/concepts/protocol/integration-issues"}]},{"group":"Resources","icon":"library-big","pages":[{"title":"Glossary","description":null,"href":"/concepts/glossary"},{"title":"Resources","href":"/concepts/resources"},{"title":"Research","href":"/concepts/research"}]}]},{"tab":"Contracts","icon":"puzzle","pages":[{"title":"Contracts","href":"/contracts/overview"}]},{"tab":"API Reference","icon":"server","pages":[{"title":"API Reference","href":"/users-api-reference/overview"}]},{"tab":"SDKs","icon":"code","pages":[{"title":"SDKs","href":"/sdk/overview"}]}]},"title":"Token Integration Issues - Ramses Technical Documentation","buildId":"dpl_HcHmUS6i3UwswnTHJUEdcTtwfdTQ","deploymentId":"dpl_HcHmUS6i3UwswnTHJUEdcTtwfdTQ","dynamics":[],"chunks":[]}
