sagemathgh-39322: Implement the chi function in sage.crypto.sboxes
    
<!-- ^ Please provide a concise and informative title. -->
<!-- ^ Don't put issue numbers in the title, do this in the PR
description below. -->
<!-- ^ For example, instead of "Fixes sagemath#12345" use "Introduce new method
to calculate 1 + 2". -->
<!-- v Describe your changes below in detail. -->
<!-- v Why is this change required? What problem does it solve? -->
<!-- v If this PR resolves an open issue, please link to it here. For
example, "Fixes sagemath#12345". -->

Fix sagemath#39321

### 📝 Checklist

<!-- Put an `x` in all the boxes that apply. -->

- [x] The title is concise and informative.
- [x] The description explains in detail what this PR is about.
- [x] I have linked a relevant issue or discussion.
- [x] I have created tests covering the changes.
- [x] I have updated the documentation and checked the documentation
preview.

### ⌛ Dependencies

<!-- List all open PRs that this PR logically depends on. For example,
-->
<!-- - sagemath#12345: short description why this is a dependency -->
<!-- - sagemath#34567: ... -->
    
URL: sagemath#39322
Reported by: Rusydi H. Makarim
Reviewer(s): Kwankyu Lee, Rusydi H. Makarim

Author: Release Manager

src/sage/crypto/sboxes.py

@@ -399,6 +399,43 @@ def monomial_function(n, e):
     return SBox(X**e)
 
 
+def chi(n):
+    r"""
+    Return the `\chi` function defined over `\GF{2^n}` used in the nonlinear
+    layer of Keccak and Xoodyak.
+
+    INPUT:
+
+    - ``n`` -- size of the S-Box
+
+    EXAMPLES::
+
+        sage: from sage.crypto.sboxes import chi
+        sage: chi(3)
+        (0, 3, 6, 1, 5, 4, 2, 7)
+        sage: chi(3).is_permutation()
+        True
+        sage: chi(4).is_permutation()
+        False
+        sage: chi(5)
+        (0, 9, 18, 11, 5, 12, 22, 15, 10, 3, 24, 1, 13, 4, 30, 7, 20, 21, 6,
+        23, 17, 16, 2, 19, 26, 27, 8, 25, 29, 28, 14, 31)
+    """
+    from sage.rings.integer_ring import ZZ
+    from sage.rings.finite_rings.finite_field_constructor import GF
+    from sage.modules.free_module_element import vector
+
+    table = [0]*(1 << n)
+
+    for x in range(1 << n):
+        vx = vector(GF(2), ZZ(x).digits(base=2, padto=n))
+        vy = [vx[i] + (vx[(i+1) % n] + 1)*vx[(i+2) % n] for i in range(n)]
+        y = ZZ(vy, base=2)
+        table[x] = y
+
+    return SBox(table)
+
+
 # Bijective S-Boxes mapping 9 bits to 9
 # =====================================