Skip to content

feat: Stacks executor route#762

Draft
kev1n-peters wants to merge 11 commits intomainfrom
stacks-executor-route
Draft

feat: Stacks executor route#762
kev1n-peters wants to merge 11 commits intomainfrom
stacks-executor-route

Conversation

@kev1n-peters
Copy link
Contributor

@kev1n-peters kev1n-peters commented Dec 10, 2025

This PR adds support for the Stacks NTT executor route.

Stacks NTT transfers are only supported via the executor route. The automatic (legacy standard relayer) and manual routes are not available for Stacks. This constraint exists due to Stack's unique address handling requirements.

When transferring to Stacks, we use a custom StacksNttReceiveInstruction executor instruction. This instruction includes both the native manager and recipient addresses for Stacks. This is required, because the VAA payload contains keccak256 hashed addresses for Stacks. The executor needs the native (unhashed) address to potentially register them with the addr32 contract on Stacks before redeeming the VAA. If the executor relay fails, users need access to the native addresses to manually register them.

@kev1n-peters kev1n-peters force-pushed the stacks-executor-route branch 8 times, most recently from 6d9b79e to 5a7d7c9 Compare December 15, 2025 15:25
};
}

async *setPeer(
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Some of the functions in here were written by @fergarrui who will be adding CLI support in the future.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant