Enable user attributes on ingress messages by Dfinity-Bjoern · Pull Request #6202 · dfinity/portal

Dfinity-Bjoern · 2026-03-04T10:08:50Z

Enable ingress messages to carry auxiliary information about the caller in case the caller is authenticated through canister signatures, which in particular includes II. This feature is needed to pass data such as identity attributes to the canister, but can also be used more broadly to include information about the user as required.

This design is based on a discussion with Dom on March 3.

Copilot

Pull request overview

This PR adds support for user attributes on ingress messages to the IC interface specification. It introduces a new optional sender_info field on call and query requests that allows ingress messages to carry auxiliary information about the caller when authenticated via canister signatures (e.g., Internet Identity). This information is then exposed to canisters through four new System API functions.

Changes:

Added sender_info optional map field (with info and sig sub-fields) to the asynchronous call and query request definitions.
Added four new System API imports: ic0.msg_caller_info_data_size, ic0.msg_caller_info_data_copy, ic0.msg_caller_info_sender_size, ic0.msg_caller_info_sender_copy.
Added documentation for the new System API functions describing their semantics.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

… into bjoern/sender_info

andreacerulli

Small nitpick

Co-authored-by: Andrea Cerulli <19587477+andreacerulli@users.noreply.github.com>

This PR makes `SenderInfo` available to the relevant variants of `ApiType` (according to the system API availability specified in this [PR](dfinity/portal#6202)). To this end, the PR introduces a new field `sender_info` in `CallContext` to persist the sender info and make it available in callbacks, too. --------- Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>

Copilot

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated 6 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated 5 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

andreacerulli

LGTM

* Draft changes for attribute passing. * Added function returning the canister id. * Clarify explanation. * Make signature verification statement more precise. * Add sender_info to sync call * Add domain separator to signature. * Add fields to CDDL. * Update docs/references/ic-interface-spec.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Attempt to fix CDDL. * Update docs/references/ic-interface-spec.md Co-authored-by: Andrea Cerulli <19587477+andreacerulli@users.noreply.github.com> * fix * fix * formal model * typo * fix canister_signature_pk call sites * fix * fix composite_query_helper * Add signer to the sender_info struct * signer * typo * note on signer field * typo * formulation * changelog * fixes * signer --------- Co-authored-by: Bjoern Tackmann <bjoern@dfinity.org> Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Co-authored-by: mraszyk <31483726+mraszyk@users.noreply.github.com> Co-authored-by: Andrea Cerulli <19587477+andreacerulli@users.noreply.github.com> Co-authored-by: Martin Raszyk <martin.raszyk@dfinity.org>

* feat: allow HTTP requests with effective subnet ID * Point out that subnet ID cannot be used for every update call Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> * Point out that subnet ID cannot be used for every update call Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> * Point out that subnet ID cannot be used for every update call Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> * Point out that subnet ID cannot be used for every update call Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> * manual fixes * no api/v2/subnet/.../call * fix * fixes * query call to ic00.list_canisters * provisional_create_canister_with_cycles * Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> * fix: no @dfinity/research in CODEOWNERS (#6233) * feat: query call for subnet admins to list all canisters on a subnet (#6223) * Enable user attributes on ingress messages (#6202) * Draft changes for attribute passing. * Added function returning the canister id. * Clarify explanation. * Make signature verification statement more precise. * Add sender_info to sync call * Add domain separator to signature. * Add fields to CDDL. * Update docs/references/ic-interface-spec.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Attempt to fix CDDL. * Update docs/references/ic-interface-spec.md Co-authored-by: Andrea Cerulli <19587477+andreacerulli@users.noreply.github.com> * fix * fix * formal model * typo * fix canister_signature_pk call sites * fix * fix composite_query_helper * Add signer to the sender_info struct * signer * typo * note on signer field * typo * formulation * changelog * fixes * signer --------- Co-authored-by: Bjoern Tackmann <bjoern@dfinity.org> Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Co-authored-by: mraszyk <31483726+mraszyk@users.noreply.github.com> Co-authored-by: Andrea Cerulli <19587477+andreacerulli@users.noreply.github.com> Co-authored-by: Martin Raszyk <martin.raszyk@dfinity.org> * typos * typos * verify_envelope * typos * assert SubnetId matches effective_subnet_id * fixes * verify_subnet_response * fixes * final fixes * wording * typo * changelog --------- Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> Co-authored-by: Björn Tackmann <54846571+Dfinity-Bjoern@users.noreply.github.com> Co-authored-by: Bjoern Tackmann <bjoern@dfinity.org> Co-authored-by: Andrea Cerulli <19587477+andreacerulli@users.noreply.github.com>

Draft changes for attribute passing.

4acc8b3

github-actions Bot added the interface-spec Changes to the IC Interface Specification label Mar 4, 2026

Dfinity-Bjoern requested review from aterga, mraszyk and sea-snake March 4, 2026 10:09

Added function returning the canister id.

2b2f42c

schneiderstefan reviewed Mar 6, 2026

View reviewed changes

Comment thread docs/references/ic-interface-spec.md Outdated

Clarify explanation.

4457060

aterga reviewed Mar 6, 2026

View reviewed changes

Comment thread docs/references/ic-interface-spec.md Outdated

Make signature verification statement more precise.

6390b83

aterga reviewed Mar 6, 2026

View reviewed changes

Comment thread docs/references/ic-interface-spec.md Outdated

Dfinity-Bjoern marked this pull request as ready for review March 6, 2026 14:51

Dfinity-Bjoern requested review from a team as code owners March 6, 2026 14:51

Dfinity-Bjoern requested a review from alexandru-uta March 6, 2026 14:53

aterga requested a review from Copilot March 6, 2026 16:55

Copilot started reviewing on behalf of aterga March 6, 2026 16:55 View session

Copilot AI reviewed Mar 6, 2026

View reviewed changes

Bjoern Tackmann and others added 7 commits March 10, 2026 11:58

Add sender_info to sync call

c876e79

Add domain separator to signature.

c889fd4

Add fields to CDDL.

21984ac

Update docs/references/ic-interface-spec.md

9567ae8

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Attempt to fix CDDL.

a13ca2a

Merge remote-tracking branch 'refs/remotes/origin/bjoern/sender_info'…

d366c7f

… into bjoern/sender_info

Merge branch 'master' into bjoern/sender_info

7799832

aterga requested review from eduarddfinity and roelstorms March 11, 2026 15:33

andreacerulli reviewed Mar 13, 2026

View reviewed changes

Comment thread docs/references/ic-interface-spec.md Outdated

Update docs/references/ic-interface-spec.md

285c775

Co-authored-by: Andrea Cerulli <19587477+andreacerulli@users.noreply.github.com>

mraszyk mentioned this pull request Apr 7, 2026

chore: make SenderInfo available to ApiType dfinity/ic#9743

Merged

typo

858ec9d

lwshang mentioned this pull request Apr 16, 2026

feat: ic0 v1.1.0 and ic-cdk v0.20.1 with msg_caller_info_{data,signer} APIs dfinity/cdk-rs#708

Merged

1 task

mraszyk added 3 commits April 27, 2026 10:18

note on signer field

983f862

typo

b2dab57

Merge branch 'master' into bjoern/sender_info

94f2715

mraszyk requested a review from a team as a code owner April 27, 2026 08:21

mraszyk added 2 commits April 27, 2026 10:31

formulation

2ddab81

changelog

df3edc4

mraszyk requested review from Copilot and removed request for eduarddfinity and roelstorms April 27, 2026 08:37

Copilot started reviewing on behalf of mraszyk April 27, 2026 08:38 View session

Copilot AI reviewed Apr 27, 2026

View reviewed changes

mraszyk added 2 commits April 27, 2026 10:45

fixes

9a8a618

signer

43eccfb

mraszyk requested a review from Copilot April 27, 2026 08:59

Copilot started reviewing on behalf of mraszyk April 27, 2026 09:00 View session

Copilot AI reviewed Apr 27, 2026

View reviewed changes

Comment thread docs/references/ic-interface-spec.md

Comment thread docs/references/_attachments/interface-spec-changelog.md

Comment thread docs/references/ic-interface-spec.md

Comment thread docs/references/ic-interface-spec.md

Comment thread docs/references/ic-interface-spec.md

andreacerulli approved these changes Apr 28, 2026

View reviewed changes

Merge branch 'master' into bjoern/sender_info

7acf50a

viviveevee approved these changes Apr 28, 2026

View reviewed changes

mraszyk enabled auto-merge (squash) April 28, 2026 08:47

mraszyk merged commit d1da46d into master Apr 28, 2026
6 checks passed

mraszyk deleted the bjoern/sender_info branch April 28, 2026 08:49

Conversation

Dfinity-Bjoern commented Mar 4, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

andreacerulli left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

andreacerulli left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

9 participants